如何永久添加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

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

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

另一种替代方法可能是创建一个模板配置文件，其中包含可用于新项目的设置。