带锚点的文档之间的链接

Question

我有两个第一个文档，例如：

doc1.rst
doc2.rst

文档1.rst

Doc 1 content
*************

Foo bar
=======

baz !

文档2.rst

Doc 2 content
*************

You can see "foo bar" `here <doc1.html#foo-bar>`.

要在 doc2 中有一个到 doc1#foo-bar 的链接，我可以对其进行硬编码。但是如何在不进行硬编码的情况下实现呢？我可以用 sphinx 代码做到这一点吗？

Answer 1

为 doc1.rst 中要链接到的部分定义标签。然后使用该:ref:角色创建对该部分的交叉引用。

文档1.rst：

Doc 1 content
*************
 
.. _foobar:
 
Foo bar
=======
 
baz !

doc2.rst：

Doc 2 content
*************

You can see "foo bar" :ref:`here <foobar>`.