python-sphinx - 在Python sphinx中，如何链接到_static目录中的文件

Question

我将一些代码和数据样本复制到_static目录中，我想链接到文档中的那些文件，例如:

.. _pca-run.py: _static/example.data

但是问题在于，狮身人面像无法创建与此文件的正确相对链接，而只是照原样复制值。因此，对于 _static不在同一目录中的嵌套文件，链接不起作用。

Answer 1

您需要的是:download:文本角色。 (如Mitar在他的评论中提到的)。

https://www.sphinx-doc.org/en/stable/usage/restructuredtext/roles.html#role-download

使用此命令将告诉Sphinx将给定文件复制到“_downloads”目录并创建指向该文件的超链接。它最初旨在用于可下载文件，例如PDF(以html输出)或tarball等。但是，它对于任何其他非ReST文件也可以正常工作。

如果确实需要，可以编写扩展名来执行此操作，但是我从未见过需要这样做，因为:download:完全可以满足我的要求。