docs: re-export Architecture C1 SVG with light theme only#4057
docs: re-export Architecture C1 SVG with light theme only#4057grandixximo wants to merge 1 commit into
Conversation
The diagram was previously exported by draw.io with a light/dark color-scheme hint and per-element light-dark() fills/strokes. On a system in dark mode the browser swaps the canvas and per-element colors, making the white-on-white box fills unreadable. The classic LinuxCNC HTML docs have no dark theme, so the SVG must always render in light. Re-exported with draw.io's light theme forced: color-scheme is now light only and there are no light-dark() wrappers.
|
This SVG file is of very very terrible quality when you look at the XML. The original is just ad bad. Text is defined as a foreign (html) object and not as text. And then the foreign object is aliased with an image if you can't render the foreign html object. Editing in Inkscape only gives you access to the (fixed DPI) image and not the underlying text. One think can be that you look at the export options and see if there is a better way to export to SVG. The alternative is to use my attached version here. It is "only" 26.5 kByte (the fixed source you suggest weighs in at about 500 kByte). Flattening the text with 5 decimal places makes the file ~300 kByte (and inserts the correct aria-label markers for the text). I guess it doesn't matter for the PDF version (text uses Noto Sans, which should get embedded). The web-version may require to be flat to prevent rendering mismatches on different systems. Image small with text as text: Image with flattened text (rendered as paths): |
2 participants
Summary
The
LCNC_Architecture_C1.drawio.svgdiagram (under docs/src/getting-started/images/) was previously exported by draw.io withcolor-scheme: light darkon the root<svg>andlight-dark(LIGHT, DARK)wrappers on every fill/stroke/text color. On a system in dark mode the browser then swaps the canvas to dark and switches all per-element colors to their dark variants, so the white-fill boxes turn into very dark boxes on a near-black canvas and the diagram is essentially unreadable.The classic LinuxCNC HTML docs have no dark theme, so the diagram should always render in light regardless of system preference.
This PR re-exports the SVG with draw.io's light theme forced:
background: #ffffffwithcolor-scheme: light(nodark),light-dark()wrappers anywhere in the file,.drawiois unchanged.No other files touched.
this is the original look
New look
Test plan
make docsand opendocs/html/getting-started/about-linuxcnc.htmlin a browser configured for dark mode; verify the architecture diagram renders white-background with readable boxes.