Как создать ссылку на локальный index.html из документации Sphinx?

Question

Я пишу несколько документов для Sphinx/rst. Как я могу ссылаться на что-то на локальном диске, относящемся к просматриваемой вами странице?

Например:

==================== 
My App documentation 
==================== 

The official My App documentation can be found here: 
https://myapp.com/docs 

A local mirror is available: 
../../_static/docs_mirror/index.html 

На моей машине _static папка находится в:

file:///Users/fredrik/code/repos/myapp/docs/_static 

... но я не хочу, чтобы жестко прописать этот путь, так как этот путь может не быть тем же путем для другого пользователя, который загрузил клонированный репозиторий.

Answer 1

Вот один из способов сделать это:

`local mirror <_static/docs_mirror/index.html>`_ 

Другой вариант:

`local mirror`_ 

.. _local mirror: _static/docs_mirror/index.html 

Ссылка: http://docutils.sourceforge.net/docs/ref/rst/restructuredtext.html#hyperlink-references.