如何在conf.py中設置sphinx的自定義配置值？ （例如，用於sphinx.ext.ifconfig）

Question

[我拆了原來的問題分成兩個更多的測試和研究後]

我定義的conf.py我自己的配置值，並寫了一個最小的擴展，使其從可見第一個文件。

sys.path.insert(0, os.path.abspath('.')) 
extensions = ['sphinx.ext.ifconfig', 'myExt'] 
testlevel = 2 

在本地myExt.py：

在conf.py

def setup(app): 
    app.add_config_value('testlevel', '', True) 

這只是正常; test.rst包括：

.. ifconfig:: testlevel == 2 

    Hurray, it seems to work 

據sphinx.ext.ifconfig的文檔，似乎可以直接從conf.py致電* app.add_config_value *。誰能告訴我如何做到這一點？

Answer 1

兩件事情，這裏要注意：

1. 首先，conf.py文件僅僅是一個Python文件。唯一特別的是Sphinx特別尋找並導入它。你可以在這個文件中做任何事情，你可以在普通的python文件中做。
2. 二，conf.py檔案can itself be an extension。換句話說，它可以有一個setup函數，它應該和擴展中的函數一樣。因此，如果您將擴展名（myExt.py）的內容複製到conf.py文件中，則該文件應該正常工作（tm）。