修改标题,因为我发现问题与我想象的完全不同。我应该删除这个问题还是把它留在这里以防其他人犯同样的错误?
原标题是:某些 Sphinx 交叉引用无法识别部分标题?
原问题:
我看到了一些非常奇怪的行为 - 根据http://sphinx-doc.org/markup/inline.html#ref-role,我的 Sphinx 标记中有交叉引用
但是当我构建文档(HTML 或 LaTEXPDF)时,我在其中的一些文档中遇到了这些错误:
警告:未定义标签:_unhiding(如果链接没有标题,则标签必须位于节标题之前)
事情是,在我看来,工作和不工作的人看起来完全一样。
在职的:
.. _conditions:
Monitoring Conditions and Alerts
================================
Run Code Online (Sandbox Code Playgroud)
破碎的:
.. _performance:
Viewing System Performance
==========================
Run Code Online (Sandbox Code Playgroud)
也坏了:
.. _unhiding:
Unhiding Conditions and Canceling Auto-Dismiss
-----------------------------------------------
Run Code Online (Sandbox Code Playgroud)
我什至复制了工作中的一个并替换了参考术语,但这没有帮助。
我应该能够通过明确定义标题来解决这个问题,但这令人困惑......