我通常在每个Sphinx
文档项目中使用某些扩展名,例如sphinxcontrib.bibtex
,这意味着我需要为每个项目添加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
中默认包含这些元素有什么简单的方法吗?在
您可以创建一个包含默认设置的模块,然后将它们导入到配置文件中。在
但是,除非您单独处理项目,否则最好始终在项目中包含完整的配置,以便其他处理该项目的人员知道他们正在使用相同的设置构建它。在
另一种方法可能是创建一个模板配置文件,其中包含可用于新项目的那些设置。在
相关问题 更多 >
编程相关推荐