python-sphinx - 无法使用Sphinx doc在标签上使用:ref:

Question

我在使用Sphinx-doc的:ref:角色时遇到问题，我在段落上方放置了标签，然后尝试从同一文档中的另一个文档链接到该标签。

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

.. _hal_1k_1p:

我尝试使用 ref链接到该标签：

:ref:`Link title hal_1k_1p`

但是我仅在构建文档时收到此错误消息：


警告：未定义标签：链接标题hal_1k_1p（如果链接没有
标题标签必须在节标题之前）


我究竟做错了什么？

Answer 1

好吧，在:ref:中，您需要具备以下条件：

:ref:`Link title <ha1_1k_1p>` 

链接到该标签。

确保标签周围有尖括号，如下所示：