Broken link to 6.2.0rc1 in the docs

[maxrjones]

Description of the problem

The 'latest' option in the GMT documentation (https://docs.generic-mapping-tools.org/latest/index.html#) correctly links to 6.2.0rc1, but the 6.2rc1 dropdown does not work (https://docs.generic-mapping-tools.org/6.2rc1). I think it is an option to manually fix the links following these methods but with GMT tags (GenericMappingTools/pygmt#1149 (comment)). But, in my opinion it would also be fine to fix as part of the next release candidate.

[seisman]

The 6.2.0rc1 documentation doesn't show the switch:

I think it's because the regex doesn't match the URL of RC releases.

gmt/doc/rst/_static/version_switch.js

Line 9 in b5bad9b

var url_re = new RegExp(doc_url + "\\/(dev|latest|(\\d+\\.\\d+))\\/");

[maxrjones]

The 6.2.0rc1 documentation doesn't show the switch:

I think it's because the regex doesn't match the URL of RC releases.

gmt/doc/rst/_static/version_switch.js

Line 9 in b5bad9b

var url_re = new RegExp(doc_url + "\\/(dev|latest|(\\d+\\.\\d+))\\/");

Yes, I agree that this is likely the problem. A secondary problem is that I mistakenly switched the version and title in #5159. Do you think it is better to update the regex to allow for release candidate URLS or to not include a switch for pre-releases?

[seisman]

I think it's better to update the regex so that people can easily compare any two versions of a single page.

[maxrjones]

I think it's better to update the regex so that people can easily compare any two versions of a single page.

I agree. I can work on this, but I have not been able to get the local testing of the switch to work. Do you have any recommendations for testing locally?

[seisman]

Do you have any recommendations for testing locally?

There is a detailed instruction in the PyGMT PR: GenericMappingTools/pygmt#621