下载角色无法使用 阅读文档

Question

我试图使用reStructuredText (reST)和Sphinx在Read the Docs中获得一个下载链接。在reST文档中的 下载角色 提供下载链接的例子是这样的

.. only:: builder_html

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

当在本地制作 html 源码时，链接会出现，但当在 Read the Docs 上使用 GitHub 链接的项目时，它们不会出现。

Answer 1

正如在 这个GitHub问题 Read the Docs使用了自己的构建器，叫做 readthedocs. 因此，要包含下载链接，你也必须包含这个构建器。例如

.. only:: builder_html or readthedocs

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