Sphinx3.3

版本3.3.1（2020年11月12日发布）

错误已修复

  • #8372：autodoc：autoclass指令变得比Sphinx 3.2慢

  • #7727：autosummary：在记录Python包时引发Pycode错误 __init__. py

  • #8350：autosummary：autosummary_mock_imports导致构建速度减慢

  • #8364：C，正确初始化空符号中的属性。

  • #8399：i18 n：将系统区域设置路径放在配置指定的路径之后

版本3.3.0（2020年11月2日发布）

弃用

  • sphinx.builders.latex.LaTeXBuilder.usepackages

  • sphinx.builders.latex.LaTeXBuilder.usepackages_afger_hyperref

  • sphinx.ext.autodoc.SingledispatchFunctionDocumenter

  • sphinx.ext.autodoc.SingledispatchMethodDocumenter

功能添加

  • #8100：html：显示更好的错误消息，以显示复制html_stat_files失败

  • #8141：C：添加了一个 maxdepth 选项 c:alias 插入嵌套声明。

  • #8081：LaTeX：允许通过添加LaTeX包 app.add_latex_package() 直到写入.tex文件之前

  • #7996：手册：添加 man_make_section_directory 在生成手册页上创建节目录

  • #8289：epub：允许使用使用隐藏epub构建器发出的“发现重复的ToC条目”警告 suppress_warnings .

  • #8298：Sphinx快速启动：添加 sphinx-quickstart --no-sep 选项

  • #8304：sphinx.testing：在sphinx.testing.fixtures中注册公共标记

  • #8051：naparts：对所有“另请参阅”项目使用obj角色

  • #8050：应用 napoleon_preprocess_types 到每个领域

  • 当检测到重复项时，C和C++会显示先前声明的行号。

  • #8183：仅在LaTeX构建版本上从doctree中删除substitution_reference节点

错误已修复

  • #8085：i18 n：添加对单一文本域的支持

  • #6640：i18 n：无法覆盖系统消息翻译

  • #8143：autodoc： AttributeError 时引发 False 值传递给 autodoc_default_options

  • #8103：autodoc：functools.cached_property不被视为属性

  • #8190：autodoc：如果某个扩展用不以白线结尾的字符串替换docstr串，则会引发解析错误

  • #8142：autodoc：从类型派生的类的构造函数签名错误。Generic

  • #8157：autodoc：注释无效时引发TypeError __args__

  • #7964：autodoc：默认值中的元组错误呈现

  • #8200：autodoc：类型别名打破自动属性的类型格式

  • #7786：autodoc：无法检测到其他文件中定义的超载方法

  • #8294：autodoc：单字符串 __slots__ 处理不正确

  • #7785：autodoc：autodoc_typehits =' any '不会影响重载的函数

  • #8192：napspel：当描述包含内联字面量时，描述将消失

  • #8142：Napoleon：谷歌风格文档中regex拒绝服务的可能性

  • #8169：LaTeX：即使latex_engine不是Platex，pxjahpper也已加载

  • #8215：LaTeX：“oneside”类选项导致生成警告

  • #8175：interphinx：库存损坏可能导致regex拒绝服务

  • #8277：sphinx-build：构建时控制台输出缺少和冗余的间距（等）

  • #7973：imgconverter：多次检查imagemagick的可用性

  • #8255：py域：默认参数值中的数字从十六进制更改为十进制

  • #8316：html：当按钮元素聚焦时，防止箭头键更改页面

  • #8343：html搜索：修复解析文档时不必要的图像负载

  • #8254：html主题：行号与代码行不对齐

  • #8093：突出显示警告在某些构建器中位置错误（LaTeX、singlehtml等）

  • #8215：消除单边文档的Fancyhdr构建警告

  • #8239：如果生成列表中的令牌是缩进的，则无法引用它

  • #8268：linkcheck：当出现时报告HTTP错误 linkcheck_anchors 是 True

  • #8245：linkcheck：将源目录考虑到本地文件

  • #8321：链接检查： tel: 架构超链接被检测为错误

  • #8323：linkcheck：当找到具有不支持架构的链接时，退出状态不正确

  • #8188：C，将缺失的项添加到内部对象类型字典中，例如，阻止狮身鱼间解决它们。

  • C，修复interphinx中的另一个对象。

  • #8270，C++，如果同名的非函数声明已经存在，则会正确地拒绝函数作为重复声明。

  • C，修复对函数参数的引用。链接到函数而不是不存在的锚点。

  • #6914：人物号意外分配给未加标题的项目

  • #8320：使“内联”行号不可选择

测试

  • #8257：支持在phinx中并行构建。testing