如何獲取 Sphinx 模板中根文件夾的路徑？

Question

當我的根文檔/some/path/index.html /some/path/_static 在我的模板中，我想引用_static文件夾中的文件。

目前我使用src="{{ pathto(master_doc)[:-10] }}_static/...它看起來很老套，只有在根文件具有正確長度的名稱時才能工作。

或者，我嘗試src="{{ pathto(master_doc)}}/../_static/ 。這打破了 index.html 本身。

有沒有辦法獲取master_doc所在文件夾的路徑？

Answer 1

要從模板引用 Sphinx 的 static 目錄中的文件，請使用pathto(file, 1) 。

這將返回文件的路徑，該文件是相對於生成的 output 的根的文件名。 使用它來參考 static 文件。

對於圖像，您可以在模板中使用它。

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