如何获取 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) }}
当我的根文档位于 /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) }}