Closed jameshadfield closed 3 years ago
Before & after screenshots:
Would this apply to subprojects of docs.nextstrain.org if we merged it and it was being used by that project or would we need to update the theme for subprojects separately?
@eharkins For the RTD projects to use these changes, the following must happen:
If any of our RTD projects declared exact versions of this theme instead of minimum versions, then those would have to get bumped. But I don't think any of our projects currently do this.
Worth nothing that both 2 and 3 could be automated via GitHub Actions or Travis CI if we desired.
Thanks both! Going to merge this (and #2) for the upcoming merge of the docs.nextstrain.org migrate branch
This tweaks the CSS used by the main section of the docs pages (not the sidebar). Styling is largely subjective, but this improves the readability of the text (heavier weight, more spacing between lines, more contrast between text and background). It also improves the aesthetics of the inline- code sections and the buttons at the bottom of each page.
The styles here are inspired by the current nextstrain.org/docs and auspice's docs (which I really like).
How to run
docs.nextstrain.org
pip install -e .
to replace the published theme with this onepython3 -m pip install 'nextstrain-sphinx-theme>=2020.2'
(There may be a better way -- please let me know if so)
This represents my first forays into sphinx and the theming it uses. I hope to further modify the underlying HTML used for rendering.