Sphinx 6.0

发布 6.0.1(发布于 2023 年 1 月 5 日)

依赖项

  • 需要 Pygments 2.13 或更高版本。

修复的 Bug

  • #10944: imgmath: 修复嵌套文件夹中文件的图像路径解析问题。

发布 6.0.0(发布于 2022 年 12 月 29 日)

依赖项

  • #10468: 取消对 Python 3.6 的支持

  • #10470: 取消对 Python 3.7、Docutils 0.14、Docutils 0.15、Docutils 0.16 和 Docutils 0.17 的支持。由 Adam Turner 补丁。

不兼容的变更

  • #7405: 移除了 jQuery 和 underscore.js JavaScript 框架。

    从 Sphinx 6.0 开始,这些框架将不再自动注入到主题中。如果您开发的主题或扩展使用了 jQuery$$u 全局对象,您需要将您的 JavaScript 更新到现代标准,或者使用下面的缓解措施。

    第一个选项是使用 sphinxcontrib.jquery 扩展,它由 Sphinx 团队和贡献者开发。要使用它,请将 sphinxcontrib.jquery 添加到 conf.py 中的 extensions 列表,或者如果您开发 Sphinx 主题或扩展,则调用 app.setup_extension("sphinxcontrib.jquery")

    第二个选项是手动确保框架存在。要重新添加 jQuery 和 underscore.js,您需要从 Sphinx 仓库 复制 jquery.jsunderscore.js 到您的 static 目录,并在您的 layout.html 中添加以下内容:

    {%- block scripts %}
        <script src="{{ pathto('_static/jquery.js', resource=True) }}"></script>
        <script src="{{ pathto('_static/underscore.js', resource=True) }}"></script>
        {{ super() }}
    {%- endblock %}
    

    补丁由 Adam Turner 提供。

  • #10471, #10565: 移除了计划在 Sphinx 6.0 中删除的废弃 API。详见 废弃的 API。由 Adam Turner 补丁。

  • #10901: C 领域:移除对解析 pre-v3 样式类型指令和角色的支持。同时移除相关的配置变量 c_allow_pre_v3c_warn_on_allowed_pre_v3。由 Adam Turner 补丁。

新增功能

修复的 Bug