Как включить ссылку на index. html контента, созданного другой программой в reST - PullRequest
0 голосов
/ 18 марта 2020

Мой каталог 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, которая указывает на codecov/index.html. Я не уверен, как это сделать, потому что он находится за пределами моей исходной папки. Папка 'codecov' генерируется автоматически, когда я запускаю покрытие кода в python. Как выполнить sh это?

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

   introduction
   getting_started
   changelog
   contact


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

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

1 Ответ

2 голосов
/ 18 марта 2020

У вас есть как минимум два варианта.

  1. Используйте внешнюю ссылку .
`Code Coverage <../_build/codecov/index.html>`_
Поместите это в директиву toctree .
.. toctree::

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

Могут быть и другие варианты, но давайте посмотрим, удовлетворит ли любой из них вашу потребность.

...