不正确的交叉引用语法会产生令人困惑的“未定义标签”警告

Question

修改标题，因为我发现问题与我想象的完全不同。我应该删除这个问题还是把它留在这里以防其他人犯同样的错误？

原标题是：某些 Sphinx 交叉引用无法识别部分标题？

原问题：

我看到了一些非常奇怪的行为 - 根据http://sphinx-doc.org/markup/inline.html#ref-role，我的 Sphinx 标记中有交叉引用

但是当我构建文档（HTML 或 LaTEXPDF）时，我在其中的一些文档中遇到了这些错误：

警告：未定义标签：_unhiding（如果链接没有标题，则标签必须位于节标题之前）

事情是，在我看来，工作和不工作的人看起来完全一样。

在职的：

.. _conditions:

Monitoring Conditions and Alerts
================================

破碎的：

.. _performance:  

Viewing System Performance
==========================

也坏了：

.. _unhiding:  

Unhiding Conditions and Canceling Auto-Dismiss
-----------------------------------------------

我什至复制了工作中的一个并替换了参考术语，但这没有帮助。

我应该能够通过明确定义标题来解决这个问题，但这令人困惑......

Answer 1

啊！没关系，标题警告是一个红鲱鱼。

问题出在参考文献中 - 我在参考文本中包含了 _，但它实际上不是密钥的一部分。我忘记了这一点，因为我几周前使用了参考资料，而且从文档中看并不明显。

不起作用：

:ref:`_unhiding`

是否有效：

:ref:`unhiding`