RTD編譯我的所有文檔，包括來自git子模塊的外來文檔

Question

我正在試驗Sphinx和ReadTheDocs（RTD），以便在每次GitHub推送時編譯我的文檔。不幸的是，RTD發現包含conf.py文件的多個文件夾doc/docs。我的repository使用git子模塊嵌入第三方庫。其中一些也使用Sphinx記錄。我認爲最大的（持久文檔構建）贏得並覆蓋最終RTD視圖中的所有靜態HTML頁面。

我怎樣才能排除或告訴RTD忽略這些子模塊的文件夾：

lib/cocotb 
lib/osvvm 
lib/vunit 
docs/source/_themes/sphinx_rtd_theme 

我的文檔位於：

docs/source/conf.py 
docs/source/index.rst 

據我發現，RTD不支持*.yml文件，但沒有條目來定義文檔根文件夾。

任何想法來解決我的問題？

Answer 1

可以在每個項目設置的高級設置選項卡中配置主文檔文件夾及其conf.py。

示例值：documentation/conf.py

Answer 2

內conf.py，有看起來像這樣

# List of patterns, relative to source directory, that match files and 
# directories to ignore when looking for source files. 
exclude_patterns = [] 

你可以把你想裏面忽略像

exclude_patterns = ["lib/cocotb", "lib/osvvm", "lib/vunit", "docs/_themes/sphinx_rtd_theme"] 

文件請注意，這裏的模式是相對於列表源目錄，您可以在上面的每個文件模式的開頭放置/以使其更清晰。