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
I switched from the RTD theme to Furo primarily for dark mode.
RTD allows setting toctree parameters through html_theme_options:
Furo, as I understand from #354, is opinionated and intentionally limits customization.
reacted with thumbs up emoji reacted with thumbs down emoji reacted with laugh emoji reacted with hooray emoji reacted with confused emoji reacted with heart emoji reacted with rocket emoji reacted with eyes emoji
-
I switched from the RTD theme to Furo primarily for dark mode.
RTD allows setting toctree parameters through
html_theme_options
:Furo, as I understand from #354, is opinionated and intentionally limits customization.
Still, I think adding parameters
titles_only
andmaxdepth
for the toctree call would be helpful for some docs and wouldn't harm others. First, let me illustrate. I monkey-patched Furo to get one level of headers in pages:https://github.com/project-gemmi/gemmi/blob/f11d1c4d84843e621770921bfdc88c39ce1ec2fb/docs/conf.py#L47-L69
This gives me sidebars like this:
Having one level of in-page sections shown on the left helps me:
Consider adding
titles_only
+maxdepth
to the supported configuration.Beta Was this translation helpful? Give feedback.
All reactions