How to host multiple version of a Sphinx based documentation on GitHub?

user_701829 0
Viewed 127

When using Github pages to host Sphinx documentation, it might be desirable to host multiple versions of the same documentation for different branches or tag of the code. However, both sphinxcontrib-multiversion and sphinxcontrib-versioning are not actively maintained and they do not work with the latest version of Sphinx.

If one does not want to use ReadTheDocs, and want to stick to the Alabaster theme, what would be the right solution ?

python-sphinx python
1 Answers

For a DIY implementation, you can refer to how I implemented this for the rinohtype documentation. I first implemented this for the Sphinx RTD theme and later switched to Sphinx-Immaterial. Note that both of these themes provide version selectors, which I don't think Alabaster does.

These are the relevant commits:

user_4382490
Related