Switch between different versions of documentations

[seisman]

Description of the desired feature

We have versioned documentation for each PyGMT release. All the versions are listed in the PyGMT main site.

GMT's PR GenericMappingTools/gmt#4110 enables switching between different versions. You can try the switcher in the GMT's documentation site.

To me, it would be great if the same feature can be implemented in the PyGMT site.

Are you willing to help implement and maintain this feature? Yes

[weiji14]

Probably easiest to follow the PR at GenericMappingTools/gmt#4110. I wonder though how other projects put it on the bottom bar. See e.g. xarray at http://xarray.pydata.org/en/stable/:

[seisman]

I wonder though how other projects put it on the bottom bar. See e.g. xarray at http://xarray.pydata.org/en/stable/:

ReadTheDocs automatically shows all versions if the project documentation is hosted on their server.

[weiji14]

Ah ok, but we don't use ReadTheDocs. Then just use the version_switch.js file then.