Python Sphinx从conf.py中访问html_context



我有一个sphinx项目,它的扩展名提供了一组值,这些值可以在模板文件中从html_context访问。

我想根据我的conf.py文件中提供的这些扩展变量之一做一个轻微的修改。sphinx文档只说明了如何为模板提供更多的html_context值,而没有说明如何从conf.py中读出扩展生成的html_context值。是否有一个好的方法来实现这一点,或者这些值是在读取和执行conf.py之后生成的?

html_context填充在主入口点中,并作为confoverrides的一部分传递给Sphinx对象:

https://github.com/sphinx-doc/sphinx/blob/3d8fbd992cedf1784b106cf43ecbc452953ebe17/sphinx/cmd/build.py L267-L277

,然后将其与conf.py的实际设置相结合以创建Config对象:

https://github.com/sphinx-doc/sphinx/blob/3d8fbd992cedf1784b106cf43ecbc452953ebe17/sphinx/application.py L216

因此,在我的理解中,conf.py从来没有见过这个html_context,你所要求的是做不到的。

最新更新