Python Sphinx Substitutions 不会像 ref 一样抛出错误或警告答案

【问题标题】：Python Sphinx Substitutions not throwing errors or warnings like ref'sPython Sphinx Substitutions 不会像 ref 一样抛出错误或警告
【发布时间】：2016-11-17 19:47:20
【问题描述】：

为了使 .rst 文件更具可读性，我开始在通用对象的任何地方使用替换而不是引用。例如:ref:user-story 现在是|用户故事|。输出很好，但是当用户输入错误时，我们在执行 make livehtml 时不会看到任何错误，就像我们使用 :refs: 时一样。有没有办法像使用 ref 一样查看未定义的引用。

我试过了，没有成功。制作 livehtml -W 制作 livehtml -Wv

我确实看到了重复替换等错误，但没有看到未解决的替换。

狮身人面像 1.4.6

Windows 10

Python 2.7.11

【问题讨论】：

我无法重现此内容。对未定义替换的引用使 Sphinx 发出“错误：引用的未定义替换：“TEST””。
对不起，为了整洁，如果解决了问题，您应该接受解决方案。否则问题显示为未解决。

标签： python-sphinx substitution

【解决方案1】：

经过一些尝试和错误，使用 -n 进行挑剔模式在构建时显示未定义的替换错误。

make livehtml -n

【讨论】：