Sphinx2.2¶

版本2.2.2（2019年12月3日发布）¶

不兼容的更改¶

#6803：出于Python安全原因，macOS和Python3.8+上禁用并行模式

错误已修复¶

#6776：LaTeX：2019-10-01 LaTeX发布中断 sphinxcyrillic.sty
#6815：i18 n：法语、印地语、中文、日语和韩语翻译消息已中断
#6803：并行构建导致macOS和Python3.8上的Veritas错误

版本2.2.1（2019年10月26日发布）¶

错误已修复¶

#6641：LaTeX：未定义的控制序列 \sphinxmaketitle
#6710：LaTeX没有很好地配置希腊语作为主要语言
#6759：如果路径位于不同的目录中，html静态路径和额外路径的验证将不再引发错误

版本2.2.0（2019年8月19日发布）¶

不兼容的更改¶

apidoc：模板文件重命名为 .rst_t
html：字段列表将按照网格布局设置样式

弃用¶

sphinx.domains.math.MathDomain.add_equation()
sphinx.domains.math.MathDomain.get_next_equation_number()
的 info 和 warn 论点 sphinx.ext.autosummary.generate.generate_autosummary_docs()
sphinx.ext.autosummary.generate._simple_info()
sphinx.ext.autosummary.generate._simple_warn()
sphinx.ext.todo.merge_info()
sphinx.ext.todo.process_todo_nodes()
sphinx.ext.todo.process_todos()
sphinx.ext.todo.purge_todos()

功能添加¶

#5124：graphviz： :graphviz_dot: 选项已重命名为 :layout:
#1464：html：如果出现，则发出警告 html_static_path 和 html_extra_path 目录位于输出目录内
#6514：html：将标签添加到搜索输入以实现辅助功能
#5602：apidoc：添加 --templatedir 选项
#6475：添加 override 论点 app.add_autodocumenter()
#6310：imgmath：let imgmath_use_preview 也可以使用SVG格式进行图像渲染内联数学
#6533：LaTeX：重构visit_enouncement_list（）以使用 \sphinxsetlistlabels
#6628：快速入门：使用 https://docs.python.org/3/ 默认设置 intersphinx_mapping
#6419：sphinx-build：give reasons why rebuilt

错误已修复¶

py域：重复警告没有指出源代码的位置
#6499：html：Sphinx从不更新 html_logo 即使原始文件已更改
#1125：html主题：在经典主题和macOS上很难看到滚动条
#5502：linkcheck：将HTTP 503响应视为非错误
#6439：使生成的下载链接可重复
#6486：如果安装了损坏的扩展，则引发UnboundLocal错误
#6567：autodoc： autodoc_inherit_docstrings 不影响 __init__() 和 __new__()
#6574：autodoc： autodoc_member_order 不提及进口顺序时 'bysource' 秩序
#6574：autodoc：缺少变元和关键字参数的类型注释
#6589：autodoc：使用autodoc_typehits ='无'的解决问题
#6605：autodoc：当目标代码包含自定义方法类对象时崩溃
#6498：autosummary：崩溃，autosummary_generate设置错误
#6507：autosummary：在没有autosummary_generate设置的情况下崩溃
#6511：LaTeX：自Sphinx 1.8.0以来，无法在LaTeX中自定义自动编号列表（参考文献：#6533）
#6531：添加扩展时未能加载最后一个环境对象
第736章：一个人的世界
#6527： last_updated 错误地将时区假设为UTC
#5592：std域： option 指令为每个逗号分隔的选项注册索引项
#6549：spinx-Build：错误消息中逃脱的字符
#6545：自Sphinx 1.8.0以来，docTest评论未被修剪
#6561：术语表：为非字母数字术语生成错误的超链接
#6620：i18n：定义列表的分类器未使用Docutils 0.15翻译
#6474： DocFieldTransformer 当给定指令不是对象描述的子集时，引发TARete错误