将下载链接添加到目录树

Question

我想在我的目录树中添加一个带项目符号的下载链接列表

理想情况下，它看起来像这样：

• Foo Example

  • 下载foo.py文件
  • 下载foo.ipynb文件

• Bar Example

  • 下载bar.py文件
  • 下载bar.ipynb文件

我试过：

.. toctree::

   foo
   * :download:`download foo.py file <files/foo.py>`
   * :download:`download foo.ipynb file <files/foo.ipynb>`
   bar
   * :download:`download bar.py file <files/bar.py>`
   * :download:`download bar.ipynb file <files/bar.ipynb>`

但这失败了，因为toctree只需要引用文档：

WARNING: toctree contains reference to nonexisting document '* :download:`download foo.py file <files/foo.py>`'

最接近我的是：

.. toctree::

   foo
   
* :download:`download foo.py file <files/foo.py>`
* :download:`download foo.ipynb file <files/foo.ipynb>`

.. toctree::

   bar

* :download:`download bar.py file <files/bar.py>`
* :download:`download bar.ipynb file <files/bar.ipynb>`

看起来是这样的：

• Foo Example

• 下载foo.py文件

• 下载foo.ipynb文件

• Bar Example

• 下载bar.py文件

• 下载bar.ipynb文件

这看起来不太好，我的实际toctree中还有很多文档。有没有办法做到这一点

Answer 1

下载不是重构的文本文档，不能是目录树中的条目

相反，您有两个变通方法

1. 使用完全限定的HTTP URL下载

   .. toctree::
   
       https://helloworld.com/src/helloworld.py
   

2. 创建一个包含下载链接的中介.rst文档，并将该文档放在目录树中