<p>我不确定我是否真的理解你的问题。在</p>
<p>您可以将<a href="http://docutils.sourceforge.net/docs/ref/rst/restructuredtext.html#explicit-hyperlink-targets" rel="nofollow">explicit hyperlink targets</a>创建到文档中的任意位置,这些位置可用于独立于docutils创建的隐式超链接目标引用这些位置:</p>
<pre><code>.. _my_rstfile:
This is my rstfile
.. _a-section:
First Chapter
-
This a link to a-section_ which is located in my_rstfile_.
</code></pre>
<p>由于您似乎希望在多个rst文件之间创建链接,因此我建议使用<a href="http://sphinx-doc.org/" rel="nofollow">^{<cd1>}</a>,因为它可以处理不同文件之间对<a href="http://sphinx-doc.org/markup/inline.html#cross-referencing-arbitrary-locations" rel="nofollow">arbitrary locations</a>的引用,并且有一些其他的优点,比如<a href="http://sphinx-doc.org/markup/toctree.html" rel="nofollow">toctree</a>和{a5}。您不仅可以将sphinx用于源代码文档,还可以用于一般文本处理。与示例类似的是<a href="http://sphinx-doc.org/index.html" rel="nofollow">Sphinx documentation</a>本身(在<a href="https://readthedocs.org/" rel="nofollow">readthedocs</a>上还有数百个其他示例)。在</p>
<p>使用<a href="http://sphinx-doc.org/tutorial.html#setting-up-the-documentation-sources" rel="nofollow">^{<cd2>}</a>调用Sphinx应该很简单。您只需将现有的rst文件添加到<code>index.rst</code>中的目录树中,然后运行<code>make html</code>。如果您想记录python代码,可以使用<a href="http://sphinx-doc.org/invocation.html#invocation-of-sphinx-apidoc" rel="nofollow">^{<cd5>}</a>,它将自动生成API文档。在</p>