Сфинкс: автоматически помечать заголовки?

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, который поддерживает это.Он включает опцию, которая добавляет префикс имени документа к метке, чтобы избежать столкновения между документами.