如何获取 Sphinx 模板的根文件夹路径?

How to get path to root folder in for Sphinx template?

当我的根文档位于 /some/path/index.html 时,来自 sphinx 模板包的一些静态文件出现在 /some/path/_static 下。在我的模板中,我想引用 _static 文件夹中的文件。

目前我使用 src="{{ pathto(master_doc)[:-10] }}_static/...,它看起来很老套,并且只有在根文件的名称长度正确的情况下才能工作。

或者,我尝试了 src="{{ pathto(master_doc)}}/../_static/。这打破了 index.html 本身。

有没有办法获取 master_doc 所在文件夹的路径?

要从模板引用 Sphinx 静态目录中的文件,请使用 pathto(file, 1)

此 returns 文件的路径,该文件是相对于生成的输出的根目录的文件名。使用它来引用静态文件。

对于图像,您可以在模板中使用它。

src="{{ pathto('_static/my-file.jpg', 1) }}