如何在 reST 中包含另一个程序生成的 link 到 index.html 的内容

Question

我的 RST 目录如下所示：

.
|-- Makefile
|-- build
|   |-- doctrees
|   `-- html
|       |-- codecov          <-- Generated by coverage.py
|          |-- index.html
|       | ....               <-- Generated by Sphinx
|-- make.bat
`-- source
    |-- _static
    |-- changelog.rst
    |-- conf.py
    |-- contact.rst
    |-- getting_started.rst
    |-- index.rst
    `-- introduction.rst

在我的 index.rst 中，我想创建一个名为 Code Coverage 的亲戚 link 指向 codecov/index.html。我不确定该怎么做，因为它在我的源文件夹之外。当我在 python 中运行代码覆盖时自动生成 'codecov' 文件夹。如何实现？

.. toctree::
   :caption: Table of Contents
   :maxdepth: 2

   introduction
   getting_started
   changelog
   contact


Indices and tables
==================

* :ref:`genindex`
* :ref:`search`

Answer 1

您至少有两个选择。

使用 external link.

`Code Coverage <../_build/codecov/index.html>`_

将其放入 toctree directive。

.. toctree::

    Code Coverage <https://www.example.com/_build/codecov/index.html>

可能还有其他选择，但让我们看看是否满足您的需要。

如何在 reST 中包含另一个程序生成的 link 到 index.html 的内容

How to include a link to index.html of content generated by another program in reST

restructuredtext

code-coverage

python-sphinx

toctree