Sphinx：自动标记标题？

Question

在Sphinx中，是否可以自动定义标题标签？我发现我的文档最终看起来很像这样：

.._doing stuff:

Doing Stuff
-----------

You might also want :ref:`other stuff`.

.._other stuff:

Other Stuff
-----------

No, you want :ref:`doing stuff`.

删除重复项会很好。

Answer 1

在同一文档中，您始终可以使用传统参考：

Doing Stuff
-----------
You may want to try `Doing Stuff`_ -section again.

但如上所述，此方法不适用于跨文档文件。

Answer 2

Sphinx 1.4 添加了 sphinx.ext.autosectionlabel< /a> 支持这一点。它包括一个选项，可以将文档名称作为标签的前缀，以避免跨文档冲突。