Adding a cross-reference to a subheading or anchor in another page

Question

How to insert a cross-reference in a reST/Sphinx page to either a sub-header or anchor in another page in the same documentation set?

Answer 1

In Sphinx 3.0.3 the only solution that worked for me is :any: (see https://www.sphinx-doc.org/en/1.5/markup/inline.html#cross-referencing-anything). Suppose, one document has such a section:

... _my-section:

My Section
----------

Lorem ipsum blablabla

Then another document can have the following fragment to create a link:

See :any:`my-section` for the details