狮身人面像：自动标注标题？

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支持此功能。它包含一个选项，它将文档名称添加到标签前面，以避免跨文档冲突。