Add visual guide

[hippalectryon-0]

See QubesOS/qubes-issues#10765

Note: GenAI was used to replicate the template of https://www.qubes-os.org/doc/visual-style-guide/

[ben-grande]

Looks fine. Check why the logos didn't load: https://qubes-doc--1656.org.readthedocs.build/en/1656/developer/general/visual-style-guide.html#logo-assets

[parulin]

I think this is a regression:

• take a look at the data of the page on QubesOS/qubesos.github.io ... How are we supposed to edit this huge HTML content with the current solution?
• the epub build is incorrect. Is the PDF version working?
• why include CSS fonts?
• are all those !important really necessary?

I would prefer a restructuredtext version, using container or class directives, and converting the font samples to images. The only important thing is to keep all the colors next to the others.

[hippalectryon-0]

I removed the inserted html, let me know what you think.

why include CSS fonts?

Because I didn't find a cdn that provides ostrich-* fonts

[parulin]

That's better!

Including any CSS font, even with a CDN is overkill. Using an image instead would be more appropriate.

[hippalectryon-0]

I switched to static images. It's not perfect (should ideally be .svg instead of .png) but I'd argue it's good enough and we can always improve it later on.

[parulin]

In other pending PR, I used the following:

html_static_path = ['_static']
html_css_files = ['css/custom.css']

[hippalectryon-0]

Not sure I understand what changes you want here

[parulin]

I would like you to move the CSS in the _static directory and update conf.py according to that, like what I did here:

https://github.com/QubesOS/qubes-doc/pull/1547/changes

[parulin]

I switched to static images. It's not perfect (should ideally be .svg instead of .png) but I'd argue it's good enough and we can always improve it later on.

I think PNGs are better than SVG here. The images could have a transparent background but it is good enough 👍

[ben-grande]

Look at the space between the color image, the name and the code:

• https://www.qubes-os.org/doc/visual-style-guide/#colors

• https://qubes-doc--1656.org.readthedocs.build/en/1656/developer/general/visual-style-guide.html#grayscale

It seems there is too much space between the color code and the color name. This PR made the color image and color name closer, looks better.

[hippalectryon-0]

Fixups should have fixed most comments - I will squash once deemed ready to merge.

[parulin]

Not using an empty :alt: produces a bad result with Sphinx. You need to be explicit, just like the font images above.