Python sphinx Can';t使用:ref:带有使用Sphinx文档的标签

Python sphinx Can';t使用:ref:带有使用Sphinx文档的标签,python-sphinx,restructuredtext,cross-reference,Python Sphinx,Restructuredtext,Cross Reference,我在使用Sphinx文档的:ref:角色时遇到问题,我在段落上方放置了一个标签,然后尝试从同一项目中的另一个文档链接到该标签 我在一个文档中使用的标签: .. _hal_1k_1p: 我尝试使用ref链接到该标签: :ref:`Link title hal_1k_1p` 但我仅在生成文档时收到此错误消息: 警告:未定义标签:链接标题hal_1k_1p(如果链接没有 标题标签必须位于节标题之前) 我做错了什么?好吧,看看你需要的是: :ref:`Link title <ha1_1k_1p

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

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

.. _hal_1k_1p:
我尝试使用
ref
链接到该标签:

:ref:`Link title hal_1k_1p`
但我仅在生成文档时收到此错误消息:

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

我做错了什么?

好吧,看看你需要的是:

:ref:`Link title <ha1_1k_1p>` 
:ref:`链接标题`
链接到该标签


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

当我阅读官方文件时,他们给出了关于我的问题的答案“未放在章节标题前的标签仍然可以被引用,但必须使用以下语法为链接指定明确的标题::ref:
链接标题
”但是问题是,他们没有给出如何实现它的示例,所以我有点奇怪,我还注意到标签定义在开始时确实包括
\uu
,而标签用法不包括
\u
字符