nextstrain / sphinx-theme

A Sphinx theme for Nextstrain's documentation, based on Read The Docs' default theme.
https://docs.nextstrain.org/projects/sphinx-theme/
MIT License
0 stars 5 forks source link

Footer badly formatted on all new builds #35

Closed victorlin closed 1 year ago

victorlin commented 1 year ago

Current Behavior

The footer on new builds is improperly formatted (e.g. Augur 21.0.0 docs):

image

Expected behavior

The footer should look like this screenshot from the Augur 20.0.0 docs:

image

Explanation

This is due to the recent release of sphinx-rtd-theme 1.2.0 (specifically https://github.com/readthedocs/sphinx_rtd_theme/commit/a039e52ec587e875f20021b14b20f35b2340c328), which applies a grid layout to div.citation.

Possible solution

Rename/remove the citation class name. A quick inspection of the Augur 20.0.0 docs homepage doesn't reveal any styles applied using that class name. While I can't find explicit documentation anywhere, it seems that the citation class name is used by docutils and other projects to refer to footnote-style references as described in this issue.