python - 狮身人面像警告 : targets for x source files that are out of date

Question

我有一个使用 Sphinx bootstrap 主题的基于 Sphinx 的网站。每当我在其中添加 RST 文件并通过键入 make html 运行时，它总是会发出此警告:

building [html]: targets for 6 source files that are out of date

构建成功，但我想防止这个警告一直出现。它计算我添加的 RST 文件的数量。顺便说一下，我在 RST 文件的顶部使用 :orphan: 来自定义我网站的导航栏，并且不将它们包含在 index.rst 中。我首先认为可能是由于此原因，但当我也删除孤儿并将我的 RST 文件添加到 TOC 树时，它仍然会发出此警告。有什么办法可以消除这个警告？

Answer 1

这并不是真正的警告；它更像是一条日志消息。您可以通过使用 -q(或 -Q)选项运行 sphinx-build 来抑制它和其他类似消息。

参见 http://www.sphinx-doc.org/en/stable/invocation.html#cmdoption-sphinx-build-q .