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

Question

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

原标题是：某些Sphinx交叉引用不识别章节标题？

原始问题：

我看到一些非常奇怪的行为 - 我根据http://sphinx-doc.org/markup/inline.html#ref-role

在我的Sphinx标记中有交叉引用

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

  

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

事情是，工作和非工作对我看起来完全一样。

工作：

public function getPrices()
{
    return $this->hasMany(Prices::className(), ['device_id' => 'id'])->
      orderBy(['device_price' => SORT_DESC]);
}

破碎：

.. _conditions:

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

也破了：

.. _performance:  

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

我甚至复制了工作版并取代了参考条款，但这没有用。

我应该能够通过明确定义字幕来解决这个问题，但这很神秘......

Answer 1

AUGH！没关系，标题警告是红鲱鱼。

问题出在参考文献中 - 我在参考文本中包含了_，但它秘密地不是密钥的一部分。我忘记了这一点，因为几周前我使用过引用，而且从文档中看不出来。

不起作用：

:ref:`_unhiding`

工作：

:ref:`unhiding`