【问题标题】:Sphinx docs without JavaScript没有 JavaScript 的 Sphinx 文档
【发布时间】:2018-11-09 14:24:57
【问题描述】:

我想使用 Sphinx 构建文档,但不使用任何 JavaScript。有没有直接的方法来配置 Sphinx 不包含任何 JavaScript?在 conf.py 中设置一个空的 html_js_files 并不能解决问题。

显然会缺少一些功能,例如搜索框。但是,手动删除脚本时,我关心的核心功能似乎没有受到影响。

【问题讨论】:

    标签: python-sphinx


    【解决方案1】:

    修改包含 JavaScript 的主题模板,删除该 HTML 标记。

    【讨论】:

    • 主题修改很简单,我说的是Sphinx包含的脚本(doctools, jquery, searchtools, underscore, ...)
    • 您不应该有引用丢失文件的 HTML,因此需要修改主题。文件系统上的文件没有在 HTML 中引用是可以的。您可以(可能?)从主题的源目录中删除有问题的 JavaScript 文件,如果它们真的打扰您,它们将不会被复制到构建目录。
    • 再次,我不是在谈论带有主题的其他 js 文件。我说的是sphinx默认自带的js,每个页面都包含,不管你用什么主题。
    • 可能有办法删除这些(因为通常你不想这样做),但是可能有一些我错过的配置或隐藏在某处的一些技巧我没有找到的文档。
    • 您能否编辑问题并解释“sphinx 默认附带并包含在每个页面中的 js”是什么意思?是<script> 标签吗?像这样的东西? stackoverflow.com/a/32786687/407651
    猜你喜欢
    • 1970-01-01
    • 1970-01-01
    • 1970-01-01
    • 2016-03-02
    • 1970-01-01
    • 1970-01-01
    • 1970-01-01
    • 2011-07-16
    • 1970-01-01
    相关资源
    最近更新 更多