用Python-Sphinx交叉引用另一页

Question

嗨，不管谁会看这个！

我正在用狮身人面像编写一个文档网页，虽然我能够按照本指南上找到的内容在同一个页面中创建一个很好的交叉引用，但现在我想在页面A中添加对B页中一个小节的引用。

我知道我可以通过一个明确的外部链接来做到这一点，比如：

`Link name <https://my.documentation.domain/path/to/page-B#subsection>`_

但我是否也可以通过交叉参照来做到这一点呢？在我看来会更整洁。我试过：

:doc:`page_B:subsection`

和

:doc:`page_B#subsection`

但这一点没有得到承认。对不起，如果这是一个愚蠢的问题，但我没有在互联网上找到答案。谢谢您:)

Answer 1

谢谢@bad_coder和@Steve！因此，这个问题的答案是我正在寻找的，但不是以一种我可以找到的方式。对于那些最终会来这里的人来说，对我来说最有效的是：

在page-B中通过在章节标题之前添加目标来定义目标：

.. _target name:

在page-A中引用此目标，只需：

:ref:`two phase simulations`

请注意，不需要添加page-A名称，将自动找到引用。

它也可以使用一个相对的html链接，但它的鲁棒性要差得多(例如，如果节名发生变化，它就会中断)：

`Link name <page_B.html#subsection>`_