Sphinx 4.2

发布 4.2.0（发布于 2021年9月12日）

已添加的功能

  • #9445: autodoc: 支持类属性

  • #9479: autodoc: 如果目标是一个被模拟的对象,则发出警告

  • #9560: autodoc: 允许在 Python 3.10 或更高版本中引用 NewType 实例时使用模块名称

  • #9447: html主题:以元组形式暴露Sphinx的版本作为模板变量 sphinx_version_tuple

  • #9594: 手册页:如果描述为空,则抑制手册页标题

  • #9445: py域: py:property 指令支持 :classmethod: 选项以描述类属性

  • #9524: 测试: SphinxTestApp 可以将 builddir 作为参数

  • #9535: C 和 C++,支持更多基本类型,包括 GNU 扩展.

修复的错误

  • #9608: apidoc: apidoc不为隐式命名空间包生成模块定义

  • #9504: autodoc: 如果目标类继承了具有 _name 属性的类,将生成对父类的不正确引用

  • #9537, #9589: autodoc:typing 模块下的某些对象在 3.10 的 HEAD 中显示不佳

  • #9487: autodoc: 缓存属性的类型提示未显示

  • #9509: autodoc: 属性错误在解析类型提示失败时引发

  • #9518: autodoc: autodoc_docstring_signature 对 __init__() 和 __new__() 没有影响

  • #9522: autodoc: PEP 585 风格的类型提示带有参数（例如 list[int] ）显示不佳

  • #9481: autosummary: 一些警告包含不存在的文件名

  • #9568: autosummary: 正确总结带线的分节标题

  • #9600: autosummary: 在 autosummary 表中包含逗号的类型注释未被完全移除

  • #9481: c域: 一些警告包含不存在的文件名

  • #9481: cpp 域:一些警告包含不存在的文件名

  • #9456: HTML搜索:如果无法获取页面内容,则在搜索结果中插入缩写标记

  • #9617: html 搜索:如果浏览器缓慢,则会显示 JS 需求警告

  • #9267: html 主题:主题添加的 CSS 和 JS 文件被加载了两次

  • #9585:py 域::type: 选项用于 py:property 指令未能创建超链接

  • #9576: py 域:字面量类型提示被转换为交叉引用

  • #9535 评论:C++,修复默认函数参数（函数指针）的解析问题.

  • #9564: 智能引号:对于带有语言高亮的 :code: 角色的文本,不调整排版.

  • #9512: sphinx-build: 在Python 3.10的HEAD上崩溃