fesco / fesco-docs

#113 Updates_Policy.adoc: "Update flow" diagram has too-small text, is 90% invisible in light theme
Closed by zbyszek. Opened by ferdnyc.

Closed
Reopen Issue

The "Graphical version of the updates policy" diagram added in https://pagure.io/fesco/fesco-docs/c/926dbe56c4d527f37fdb02179c2899c29f0da0d1?branch=main is far too detailed for its displayed size, with most of the text requiring an inordinate amount of squinting to make out.

The image is also 90% invisible when the light theme is selected, because https://pagure.io/fesco/fesco-docs/c/705fdb0daef2e9fda4c27c7531a52eeade2c8fd3?branch=main made it dark-mode compatible by adding media queries which respond to the prefers-color-scheme CSS media property, but don't integrate with the site's theme selector.

With the latest-greatest Antora (since the merge of https://gitlab.com/antora/antora/-/merge_requests/1088 a month ago), there's the possibility of using the [opts=inline] argument to the image:: macro, to solve the second issue. This will embed the SVG directly into the generated HTML, meaning that it can inherit document styles. It requires a bit of tweaking of the SVG (removing the namespaces from the <svg> element, and probably revising the internal CSS), but should make it maximally responsive.

But any version of Antora older than 1 month will crash on attempting to generate the site with a "Jail is not an absolute path: modules/ROOT/pages" error, if opts=inline is used.

The other option is to use a <picture> element in the HTML, containing multiple <source> elements with media= attributes that link to different light/dark versions of the diagram SVG. But I don't know if asciidoctor is able to generate HTML like that, or if Antora supports it.
Edited by ferdnyc

Issue migrated to https://forge.fedoraproject.org/fesco/docs/issues/113.

Metadata Update from @zbyszek:
- Issue status updated to: Closed (was: Open)
Metadata
None
None
None
None
None
Static archive. pagure.io was sunset in 2026; this is a read-only snapshot.
Red Hat Logo

Fedora is sponsored by Red Hat. Learn more about the relationship between Red Hat and Fedora »

© Red Hat, Inc. and others.