Возможно ли исправление Sphinx, чтобы избежать перезаписи заголовков при создании permlink? - PullRequest
0 голосов
/ 07 октября 2018

Можно ли пропатчить Sphinx (или темы Sphinx), чтобы избежать перезаписи заголовков при генерации permlink в выводе HTML?

Контекст: я использую Sphinx для документации Logtalk и имею в заголовках справочное руководствотакие как foo/2 и foo//2, которые обозначают различные конструкции, но Sphinx генерирует одну и ту же permlink (#foo-2) для обеих, выполняя, по-видимому, некоторую нормализацию заголовка.Это также нарушает интеграцию с инструментом диаграмм Logtalk, который ожидает #foo/2 и #foo//2 в ссылочных URL.

Обновление

Найден обходной путь с помощью rawдирективы.Например,

.. raw:: html

   <div id="foo/2">&nbsp;</div>

Мои файлы reStructuredText генерируются автоматически, и, таким образом, этот обходной путь легко.Я все еще предпочитаю избегать этого, если это возможно.

...