Sphinx文档无需JavaScript

Question

Sphinx文档无需JavaScript

python-sphinx

4

我希望使用Sphinx构建文档，但不使用任何JavaScript。有没有一种简单的方法来配置Sphinx不包含任何JavaScript？在conf.py中设置一个空的 html_js_files 并不能解决问题。

显然，某些功能将会丢失，比如搜索框。但是当手动删除脚本时，好像没有影响到我关心的核心功能。

- user3712853

1个回答

网页内容由stack overflow 提供, 点击上面的

可以查看英文原文，
原文链接

- Steve Piercy · Accepted Answer

2

修改您的主题模板，删除包含JavaScript的HTML标签。

- Steve Piercy

1

主题修改很容易，我说的是Sphinx包含的脚本（doctools、jquery、searchtools、underscore等）。 - user3712853

你不应该有引用缺失文件的HTML，因此需要修改主题。在文件系统中有未在HTML中引用的文件是可以的。如果你真的很烦恼，你可以从主题源目录中删除有问题的JavaScript文件，它们就不会被复制到构建目录中了（可能？）。 - Steve Piercy

1

再次强调，我不是在谈论主题附带的额外js文件。我指的是sphinx默认提供并包含在每个页面中的js，无论您使用什么主题。 - user3712853

1

请问您能否编辑一下问题并解释一下您所说的“js that sphinx comes with by default and is included in every page”是什么意思？它是指<script>标签吗？就像这样的东西？https://stackoverflow.com/a/32786687/407651 - mzjn

现在我明白为什么会发生这种情况了，我查看的主题在标记中没有脚本标签，而是：{%- for scriptfile in script_files %} {{ js_tag(scriptfile) }} {%- endfor %}。 - user3712853

显示剩余2条评论