Sphinx 6.1

发布 6.1.3（发布日期:2023年1月10日）

修复的错误

  • #11116: 恢复到之前的 Sphinx 5 节点复制方法

  • #11117: 撤销Sphinx 6.1.0中对并行图像处理的更改

  • #11119: 在 linkcheck 构建器中抑制 ValueError

发布 6.1.2（于2023年1月07日发布）

修复的错误

  • #11101: LaTeX: sphinxsetup 的 div.topic_padding 键在 5.1.0 中记录,已实现名称为 topic_padding

  • #11099: LaTeX: sphinxsetup 的 shadowrule 键自 Sphinx 5.1.0 以来导致 PDF 构建崩溃

  • #11096: LaTeX:shadowsize 键的 sphinxsetup 自 Sphinx 5.1.0 起导致 PDF 构建崩溃

  • #11095:LaTeX:自 Sphinx 5.1.0 起,:dudir:topic 和 contents 框的阴影不在页面边距内

  • #11100:修复在并行模式下复制图像的问题.

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

修复的错误

  • #11091: 修复 util.nodes.apply_source_workaround 对于没有源信息的 literal_block 节点及其父节点的处理.

发布 6.1.0（发布于 2023 年 1 月 5 日）

依赖关系

  • 采用了 Ruff 代码检查工具.

不兼容的更改

  • #10979: gettext: 移除了 get_translation 中对复数形式的支持.这是未使用的并且使得对 sphinx.locale 的其他更改变得复杂.

过时

  • sphinx.util functions:

    • 将 sphinx.util.typing.stringify() 重命名为 sphinx.util.typing.stringify_annotation()

    • 将 sphinx.util.xmlname_checker() 移动到 sphinx.builders.epub3._XML_NAME_PATTERN

    移至 sphinx.util.display :

    • sphinx.util.status_iterator

    • sphinx.util.display_chunk

    • sphinx.util.SkipProgressMessage

    • sphinx.util.progress_message

    已移至 sphinx.util.http_date :

    • sphinx.util.epoch_to_rfc1123

    • sphinx.util.rfc1123_to_epoch

    移至 sphinx.util.exceptions :

    • sphinx.util.save_traceback

    • sphinx.util.format_exception_cut_frames

添加的功能

  • 在写入阶段缓存构建环境中的文档树.

  • 使所有写作阶段任务支持并行执行.

  • #11072: 在Python领域和自动文档中使用PEP 604 ( X | Y ) 显示约定来表示 typing.Optional 和 typing.Optional 类型.

  • #10700: autodoc: 将 typing.NewType() 类型作为类而不是 ‘data’ 进行文档化.

  • 在读取和写入阶段之间缓存文档树.

修复的错误

  • #10962: HTML: 修复多词键名查找表.

  • 修复了对 Python 3.12 alpha 3 的支持（ enum 模块中的更改）.

  • #11069: HTML主题:删除过时的”shortcut”链接关系关键字.

  • #10952: 在程序中断时正确终止并行进程.

  • #10988: 通过更高效的拷贝加速 TocTree.resolve() .

  • #6744: LaTeX: 对seealso指令的支持应通过环境来实现,以允许样式设置.

  • #11074: LaTeX: 从5.1.0开始,无法将sphinxnote更改为使用sphinxheavybox