Sphinx restructuredText для преобразования гиперссылки в HTML

У меня есть коллекция файлов reStructuredText, которые связаны друг с другом следующим образом:

further reading at `document name <otherdoc.rst>`.

Я заметил, что это очень хорошо работает на BitBucket и Github, поскольку файлы .rst отображаются довольно хорошо, а ссылки между файлами работают.

Однако теперь я хотел сгенерировать HTML-документы с помощью Sphinx и заметил, что Sphinx не конвертирует ссылки, подобные приведенному выше, в HTML-ссылки, поэтому у меня есть куча HTML-файлов с неработающими ссылками. Как я могу это исправить, не нарушая ссылок на GitHub и BitBucket?


hyperlink python-sphinx restructuredtext
person dmeu    schedule 07.06.2013    source источник

Ответы (1)


arrow_upward
1
arrow_downward

Из документации Sphinx по гиперссылкам кажется, что синтаксис встроенных внешних гиперссылок

`Link text <http://example.com/>`_

Обратите внимание на завершающий _ сразу после последнего обратного тика. Попробуйте добавить это подчеркивание и посмотрите, исправит ли это ваши ссылки в выходных данных Sphinx.

person Chris    schedule 08.06.2013