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

Question

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

目前，我使用src="{{ pathto(master_doc)[:-10] }}_static/...，它看起来很粗糙，只有在根文件的名称正确的情况下才能使用。

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

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

Answer 1

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

这将返回一个文件的路径，该文件是相对于生成输出的根的文件名。使用它可以引用静态文件。

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

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