markdown - 摆脱 Sphinx 中的 "duplicate label"警告

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。
根据 recommonmark.readthedocs.io/en/latest/，我们仍在使用 Sphinx-1.3 及更早版本的选项
改变

from recommonmark.parser import CommonMarkParser

source_parsers = {
    '.md': CommonMarkParser,
}

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

到

extensions = ['recommonmark']

解决了这个问题。
非常感谢@StevePiercy 让我知道我们已弃用的配置。