結合幾個項目的獅身人面像文件

Question

在我們的團隊中，我們有幾個項目，每個項目都分別記錄了獅身人面像。 我們希望有一箇中央文檔頁面，其中包括我們所有的項目。

當然，我們可以建立一個鏈接到不同文檔的html頁面。

有沒有辦法將文檔與Sphinx本身結合？ 也許有一個單獨的文檔項目，其中包含其他項目的文檔？

Answer 1

您可以嘗試intersphinx在現有文檔之間創建鏈接。這就像Wikipedia鏈接到維基媒體世界中的其他Wiki一樣。

另一種方法是將所有文檔目錄簽出到新的存儲庫中。您可能需要創建新的toctree，因爲它不適合整體結構或嵌套深入。因此，您可以通過將索引文件名更改爲例如master.rst。

個別文檔是通過使用原始index.rst構建的，但如果在主文檔中使用該文檔，則僅將master.rst文件視爲toctree s。