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:class
和py: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:修复
MemoryError
在sphinx.ext.intersphinx
当使用None
或typing.*
作为内联类型引用。补丁作者:Bénédikt Tran(picnixz)
测试¶
#11345:始终删除
docutils.conf
运行时在测试目录中SphinxTestApp.cleanup()
.