与 :ref:

Question

以下 ReStructuredText 包含

:ref:

角色，它是 Sphinx 扩展：

Read more in :ref:`section-target`.

.. _section-target:

Section Title
=============
Text body.

哪里

:ref:`section-target`

被解析为以下文档树：

<reference internal="True" refid="section-target"><inline classes="std std-ref">Section Title</inline></reference>

您可以通过将上述 reStructuredText 存储到

sphinx_input/index.rst

并运行

sphinx-build -b xml -C sphinx_input sphinx_ouptut

来重现此内容。

有没有一个等价的东西可以用来生成这个完全相同的文档树，只使用docutils restructedtext？（因此没有 Sphinx 特定的角色或指令）。我不关心可读性，因为这只会被机器解析。

到目前为止，我得到的最接近的是：

`Section Title <section-target>`_

结果是：

<reference name="Section Title" refuri="section-target">Section Title</reference>

很接近，但它定义了

refuri

，而不是

refid

。

遗憾的是，reference

文档树

的文档丢失了。

Answer 1

您可以在示例中添加两个下划线以获取嵌入的超链接并将其设置为匿名以防止名称重复：（参见嵌入式 URI 和别名）。

.. _section-target:

Section Title
=============
Text body.

a: `Section Title <section-target_>`__

b: `Section Title`_