Роли загрузки не работают в Read the Docs

Question

Я пытаюсь получить ссылку для загрузки для работы в Read the Docs, используя reStructuredText (reST) и Sphinx. В документации reST для роли загрузки пример предоставления ссылки для загрузки представлен как

.. only:: builder_html

   See :download:`this example script <../example.py>`.

При создании источника html локально ссылки появляются, но при использовании GitHub связанный проект на Прочтите документы, они этого не делают.

Answer 1

Как объяснено в , этот выпуск GitHub Read the Docs использует собственный конструктор под названием readthedocs. Таким образом, чтобы включить ссылки для загрузки, вы также должны включить этот конструктор. Например

.. only:: builder_html or readthedocs

   See :download:`this example script <../example.py>`.