在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我在changelogs中没有看到任何似乎相关的东西。

Answer 1

问题是我们仍然使用不推荐使用的conf.py选项来重新标记。根据recommonmark.readthedocs.io/en/latest/的变化，我们仍在使用Sphinx-1.3和更早版本的选项

from recommonmark.parser import CommonMarkParser

source_parsers = {
    '.md': CommonMarkParser,
}

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

至

extensions = ['recommonmark']

已修复此问题。

非常感谢@StevePiercy让我意识到我们不推荐使用的配置。

Answer 2

它看起来像是sphinx解析器解析文件夹中的每个.rst文件来创建一个超文本标记语言。当其中一些.rst文件包含在main.rst中时，看起来我们得到的是这个重复的标签消息。为了帮助解析器不解析这些内容，您可以尝试将扩展名从.rst更改为.rest等其他扩展名，然后这些消息就会消失。确保include现在包含具有新文件扩展名的文件，如前面调用的.rest