我有一个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
,你所要求的是做不到的。