摆脱 Sphinx 中的“重复标签”警告

Question

在 Sphinx 中，我收到大量警告，例如：

/PATH/FILENAME:LINE: WARNING: duplicate label LABELNAME, other instance in /PATH/FILENAME

似乎将所有节标题视为“标签”，并且有一堆节标题在多个文件中使用。例如，我们每个版本的每个发行说明都有一页，并且每个版本中都有“改进”和“修复”。

如何摆脱所有这些警告？是否应该将它们静音，或者是否有您应该使用的不同切片方法？

一个例子是desktop.rst和vr-controls.rst中的标签“gamepad”

作为参考，我们仍然使用 Sphinx 2.4.4 我没有在变更日志中看到任何看起来相关的内容。

Answer 1

问题是我们仍然使用已弃用的 conf.py 选项来进行 recommonmark。我们仍在使用 Sphinx-1.3 及更早版本的选项，按照recommonmark.readthedocs.io/en/latest/ 更改

from recommonmark.parser import CommonMarkParser

source_parsers = {
    '.md': CommonMarkParser,
}

source_suffix = ['.rst', '.md']

到

extensions = ['recommonmark']

解决了这个问题。

非常感谢@StevePiercy 让我意识到我们已弃用的配置。