如何修改Sphinx文档中的链接,以便更新相关链接? 我正在使用Sphinx记录python项目。我正在使用画布来可视化文档中的一些结果。我的文档需要支持Firefox和IE。我需要在文档中包括excanvas.js库,但前提是浏览器是IE。如何有条件地包含此库,以便相对路径正确? 示例。... 文档文件夹 /sphinx /source working_test_page.rst test_block.html /nested non_working_test_page.rst test_block_copy.html /_templates layout.html /_static excanvas.js ... 根据Sphinx' documentation pages处的注释,修改了layout.html文件。此修改是在模板头中插入HTML的条件块,如果在IE上查看该页面,则会在上面添加excanvas.js。 {% extends "!layout.html" %} {% block extrahead %} <!--[if IE]> <script type="text/javascript" src="_static/excanvas.js"></script> <![endif]--> {% endblock %} 文件working_test_page.rst和non_working_test_page.rst具有相同的内容。内容如下。唯一的区别是文件的位置。 Script Test ========== .. raw:: html :file: test_block_1.html 文件test_block.html和test_block_copy.html具有相同的内容。这两个文件包含一些HTML,用于设置画布并使用它。 sphinx将第一个文件编译到HTML构建目录中时,将得到以下文件结构结果: /sphinx /build working_test_page.html /nested non_working_test_page.html /_static excanvas.js ... 文件working_test_page.html具有excanvas.js的正确路径并正确加载。文件non_working_test_page.html的excanvas.js路径错误,并且无法正确加载。 如何有条件地加载excanvas.js,以使sphinx文档中的相对路径正确,而与rst文件的位置无关? 我正在使用Sphinx记录python项目。我正在使用画布来可视化文档中的一些结果。我的文档需要支持Firefox和IE。我需要包含excanvas.js ...

问题描述 投票:6回答:1

我正在使用Sphinx记录python项目。我正在使用画布来可视化文档中的一些结果。我的文档需要支持Firefox和IE。我需要在文档中包括excanvas.js库,但前提是浏览器是IE。如何有条件地包含此库,以便相对路径正确?

python python-sphinx
1个回答
5
投票

如果使用辅助函数pathto(...)修改条件HTML片段,则条件链接的格式将正确。请参阅pathto(file,1)上的文档。

© www.soinside.com 2019 - 2024. All rights reserved.