Sphinx7.1

版本7.1.2(2023年8月2日发布)

错误已修复

  • #11542:linkcheck:适当尊重 linkcheck_anchors 并且不要虚假地报告验证锚的失败。詹姆斯·艾迪生的补丁。

版本7.1.1(2023年7月27日发布)

错误已修复

  • #11514:修复 SOURCE_DATE_EPOCH 在多行版权页脚中。由Bénédikt Tran修补。

版本7.1.0(2023年7月24日发布)

不兼容的更改

弃用

  • #11412:发出有关使用已废弃的Python特定索引条目类型的警告(即, module , keyword , operator , object , exception , statement ,而且 builtin )在 index 指令,并将删除版本设置为Sphinx 9。Adam Turner的补丁。

功能添加

  • #11415:使用CRC 32算法将检验和添加到生成的HTML中包含的JavaScript和CSS资产UI中。

  • require_sphinx() 现在允许将版本要求指定为 (major, minor) .

  • #11011:允许通过以下方式配置对象签名的行长度限制 maximum_signature_line_length 以及特定于领域的变体。如果签名的长度(以字符为单位)大于配置的限制,则签名中的每个参数将被拆分为自己的逻辑行。此行为还可以通过对象描述指令上的选项来控制,例如 py:function:single-line-parameter-list .补丁由Thomas Louf、Adam Turner和Jean-François B.

  • #10983:支持页脚块中的多行版权声明。斯蒂芬妮·莫林的补丁

  • sphinx.util.display.status_iterator 现在使用ANSI控制代码清除当前行,而不是使用空白字符重印。

  • #11431:linkcheck:将SSL故障视为断开的链接。詹姆斯·艾迪生的补丁。

  • #11577;保持 translated 已翻译的节点上的属性。

  • #11451:改进使用时显示的回溯 sphinx-build -T 并行构建。Bénédikt Tran的补丁

  • #11324:linkcheck:使用基于会话的HTTP请求。

  • #11438:添加对 py:classpy:function PEP 695(通用类和函数声明)和PEP 696(默认类型参数)的指令。 为类型参数列表启用多行支持(#11011),并且可以在对象描述指令上进行本地控制,例如 py:function:single-line-type-parameter-list .由Bénédikt Tran修补。

  • #11484:linkcheck:允许通过以下方式根据每个URL忽略HTML锚点 linkcheck_anchors_ignore_for_url 同时仍然检查页面本身的有效性。Bénédikt Tran的补丁

  • #1246:通过新的替代添加翻译进度统计数据和检查支持 (|translation progress| )和新的配置变量 (translation_progress_classes ).这些可以确定文档中已翻译元素的百分比,以及剩余已翻译和未翻译元素。

错误已修复

  • 恢复了 footnote-reference Docutils的最新(未发布)版本中已删除的类。

  • #11486:使用 RFC 8081 EPub生成器中的字体文件SME类型。使用正确的MBE类型将防止发出警告 epubcheck 并将生成有效的EPUB。

  • #11435:使用微秒分辨率时间戳来检测中的过时文件 BuildEnvironment.get_outdated_files .

  • #11437:以reStructured文本角色开始的顶级标题现在可以正确呈现 rst_prolog 已设置。以前,由于序言文本插入到文档中的位置,以下面开头的文件会被不正确地呈现。

    :mod:`lobster` -- The lobster module
    ====================================
    
    ...
    

    由Bénédikt Tran修补。

  • #11337:修复 MemoryErrorsphinx.ext.intersphinx 当使用 Nonetyping.* 作为内联类型引用。补丁作者:Bénédikt Tran(picnixz)

测试

  • #11345:始终删除 docutils.conf 运行时在测试目录中 SphinxTestApp.cleanup() .