PyGMT website: Drop-down menu for selection version disappears for selection "dev"

[yvonnefroehlich]

I just found that the drop-down menu for selecting the version on the PyGMT website disappears when having "dev" selected. I think this is somehow new and is still not the case for the GMT website (https://docs.generic-mapping-tools.org/dev/index.html).

<= v0.13.0	latest	dev

[seisman]

It's likely because breaking changes in sphinx_rtd_theme v3.x (https://github.com/readthedocs/sphinx_rtd_theme/tags).

[yvonnefroehlich]

Maybe this iusse is related by the newly introduced version_selector:

• https://sphinx-rtd-theme.readthedocs.io/en/stable/configuring.html#confval-version_selector

At the moment I am trying to understand how this has to be set up, considering these aspects:

• https://docs.readthedocs.io/en/stable/addons.html
  • https://github.com/readthedocs/sphinx_rtd_theme/issues/1598

[seisman]

We probably should pin sphinx_rtd_theme to 2.x temporarily and wait to see if there are any upstream changes (xref: https://github.com/readthedocs/sphinx_rtd_theme/issues/1624).

[yvonnefroehlich]

We probably should pin sphinx_rtd_theme to 2.x temporarily and wait to see if there are any upstream changes (xref: readthedocs/sphinx_rtd_theme#1624).

I did not see this issue yet. Thanks for pointing it out! This looks like that there are some issues with this newly added version_selector. So trying to pin sphinx_rtd_theme makes sense to me. We can still make changes to the config file.

[seisman]

reopen so that we can better track possible upstream changes.