如何創建從Sphinx文檔鏈接到本地​​index.html？

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。