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.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 领域:移除对解析 pre-v3 样式类型指令和角色的支持。同时移除相关的配置变量
c_allow_pre_v3和c_warn_on_allowed_pre_v3。由 Adam Turner 补丁。
新增功能¶
#10924: LaTeX: 为表格和代码块采用更好看的默认设置。详见
latex_table_style以及pre_border-radius和pre_background-TeXcolor额外的类似 CSS 的 'sphinxsetup' 键,了解之前的默认设置以及如果需要如何重新启用它们。
修复的 Bug¶
#10984: LaTeX: 文档
latex_additional_files对.tex扩展名文件的行为。