You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
The banner announcments previously used to link to the RHEL upgrade information are not a native part of sphinx, nor extension, instead provided by the theme.
The content is configured via the html_theme_options portion of conf.py, however, as this is pre-sphinx cross-references cannot be used, making linking to specific pages more awkward than it should be.
Custom javascript is used to add the link, in _static/js/custom.js, which finds and replaces the link content by looking up specific anchors in the navigation. This works OK for top level pages, but is far from ideal.
It is also a little painful to iteratively test/modify, due to sphinx's handling of _static files, and browser caching.
It's probably non-trivial to add RST cross ref support to the annoucnment directly, but it should atleast be possible to move the configuration to conf.py as a variable, and which is then used to generate the required javascript to avoid mutating multiple files.
The text was updated successfully, but these errors were encountered:
The banner announcments previously used to link to the RHEL upgrade information are not a native part of sphinx, nor extension, instead provided by the theme.
The content is configured via the
html_theme_options
portion ofconf.py
, however, as this is pre-sphinx cross-references cannot be used, making linking to specific pages more awkward than it should be.Custom javascript is used to add the link, in
_static/js/custom.js
, which finds and replaces the link content by looking up specific anchors in the navigation. This works OK for top level pages, but is far from ideal.It is also a little painful to iteratively test/modify, due to sphinx's handling of
_static
files, and browser caching.It's probably non-trivial to add RST cross ref support to the annoucnment directly, but it should atleast be possible to move the configuration to
conf.py
as a variable, and which is then used to generate the required javascript to avoid mutating multiple files.The text was updated successfully, but these errors were encountered: