不能使用Sphinx doc使用Ref和Label

时间:2015-09-02 05:19:25

标签: python-sphinx restructuredtext

我在使用Sphinx-doc的Ref函数时遇到问题,我在一个段落上面放了一个标签然后我尝试从另一个文档链接到该标签,但在同一个项目中。

我在一份文件中使用的标签:

.. _hal_1k_1p:

我尝试使用Ref链接到该标签:

:ref:`Link title hal_1k_1p`

但是我在构建doc时只收到此错误消息:

  

警告:未定义标签:链接标题hal_1k_1p(如果链接没有   标题标题必须位于节标题之前

我做错了什么?

1 个答案:

答案 0 :(得分:18)

好的,看:ref:你需要这个:

:ref:`Link title <ha1_1k_1p>` 

链接到该标签。

确保标签周围有尖括号,如下所示:&lt; label&gt;