Closed rkdarst closed 2 years ago
This should have worked, but less than 30 minutes before this, sphinx version 5.2.0.post2 was released, which appears to cause an error in sphinx_rtd_theme. That version ID appears to be allowed (https://peps.python.org/pep-0440/#public-version-identifiers), but sphinx_rtd_theme assumes only two .
characters for splitting it. Random incompatibilities have happened before, I will go to sleep and see if it gets fixed, but it's not too hard to work around this.
:std:doc:
. What this means that if you link to:std:doc:`glossary`
, it might accidentally link toglossary
in one of the external projects. The new idea is that you wouldn't usually want to link directly to an external page (this is not symbolic and could be rearranged at any time). Instead, link to the symbolic description, e.g.:rst:dir:`glossary`
. The exactly function/directive/etc. is a stable link which is good to link to. (you could say this is the same reason we don't want to use raw HTML links)