不能使用Sphinx doc使用Ref和Label

Question

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

我在一个文档中使用的标签:

.. _hal_1k_1p:

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

:ref:`Link title hal_1k_1p`

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

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

我究竟做错了什么？

Answer 1

好的,看看:参考:你需要这个:

:ref:`Link title <ha1_1k_1p>` 

链接到该标签.

确保标签周围有尖括号,如下所示:<label>