Sphinx 6.0

发布版本 6.0.1（2023年1月5日发布）

依赖关系

  • 要求 Pygments 2.13 或更高版本.

修复的错误

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

Release 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 更新到现代标准,或者使用下面的缓解措施.

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

    第二个选项是手动确保框架的存在.要重新添加 jQuery 和 underscore.js,您需要从 Sphinx 仓库 中复制 jquery.js 和 underscore.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域: 移除对解析v3之前样式类型指令和角色的支持.同时移除相关的配置变量 c_allow_pre_v3 和 c_warn_on_allowed_pre_v3 .补丁由Adam Turner提供.

添加的功能

修复的错误