python - 有条件地包括扩展名吗？

有一个ifconfig sphinx扩展名-它允许有条件地包含内容。我正在寻找一种有条件地包括扩展的方法。我最好的尝试是为-D提供一个带有sphinx-build选项的扩展名列表:

sphinx-build -b singlehtml -d _build/doctrees -D html_theme=empty -D "extensions=['sphinx.ext.autodoc', 'sphinx.ext.viewcode', 'sphinx.ext.numfig', 'sphinx.ext.ifconfig', 'cloud_sptheme.ext.table_styling', 'sphinx.ext.htmlmath']" . _build/wkA

但这是行不通的。

问题是有条件地包括sphinx.ext.htmlmath或sphinxcontrib.mathml。

最佳答案

使用-t <tag> http://sphinx-doc.org/invocation.html#cmdoption-sphinx-build-t

例如像这样调用狮身人面像(请参阅-t use_htmlmath):

sphinx-build -b singlehtml -d _build/doctrees \
   -D html_theme=empty -t use_htmlmath . _build/wkA

在conf.py中有此代码

if tags.has('use_htmlmath'):
    # use supplied =t use_htmlmath
    extensions.append('sphinx.ext.htmlmath')
else:
    #fall back
    extensions.append('sphinxcontrib-mathml')

关于python - 有条件地包括扩展名吗？，我们在Stack Overflow上找到一个类似的问题：https://stackoverflow.com/questions/16863444/

Sphinx

python - 有条件地包括扩展名吗？