Sphinx：自动标记标题？

Question

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

.._做事： 做事 ------------ 你可能还想要:ref:`other stuff`。 .._其他的东西： 其他的东西 ------------ 不，你想要:ref:`doing stuff`。

如果删除重复项会很好。

Answer 1

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

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

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

Answer 2

Sphinx 1.4 添加了支持此功能的sphinx.ext.autosectionlabel。它包括一个选项，该选项会将文档名称作为标签的前缀以避免跨文档冲突。