尝试在此处为每个文档添加一个简单的true/false值:
http://sphinx-doc.org/ext/ifconfig.html
在我的conf.py文件中:

extensions = ['sphinx.ext.todo', 'sphinx.ext.ifconfig']

# Custom variables
def setup(app):
    app.add_config_value('responsiveenabled', True, True)

在我的grids.rst文件(描述如何设置引导网格的页面)中,我有:
.. ifconfig:: responsiveenabled

Blah blah blah.

我得到的错误是:
NameError: name 'responsiveenabled' is not defined

responsiveenabled之后我需要什么东西吗,比如“in(…)”?我想保持它不可知的哪个版本的文件,我正在写。

最佳答案

您的conf.py文件应该是:

extensions = ['sphinx.ext.todo', 'sphinx.ext.ifconfig']

# Custom variables
def setup(app):
    app.add_config_value('responsiveenabled', True, True)

responsiveenabled = True

我知道这应该是个默认值,但我不能让它工作
没有初始化。
那你就可以用
.. ifconfig:: responsiveenabled

   text included if the config variable is set

text always included

10-02 08:15