python - 如何将扩展永久添加到 Sphinx conf.py 模板？

Question

我通常使用某些扩展名，例如sphinxcontrib.bibtex每个Sphinx文档项目，这意味着我需要将扩展​​名添加到conf.py每个项目的文件中。

# Add any Sphinx extension module names here, as strings. They can be extensions
# coming with Sphinx (named 'sphinx.ext.*') or your custom ones.
extensions = ['sphinx.ext.autodoc', 'sphinx.ext.doctest',
'sphinx.ext.intersphinx', 'sphinx.ext.todo', 'sphinx.ext.coverage',
'sphinx.ext.pngmath', 'sphinx.ext.ifconfig', 'sphinx.ext.viewcode',
'sphinxcontrib.bibtex']

是否有一个简单的默认情况下将这些包含在内的内容conf.py？

Answer 1

您可以创建一个包含默认设置的模块，然后将它们导入到您的配置文件中。

但是，除非您单独处理项目，否则最好始终在项目中包含完整配置，以便其他工作人员知道他们正在使用相同的设置构建它。

另一种选择可能是使用可用于新项目的那些设置创建模板配置文件。