Sphinx4.5

版本4.5.0（2022年3月28日发布）

不兼容的更改

  • #10112：extlinks：默认禁用硬编码链接检测器

  • #9993，#10177：std domain：Disallow to refer an inline target via ref 作用

弃用

  • sphinx.ext.napoleon.docstring.GoogleDocstring._qualify_name()

功能添加

  • #10260：启用 FORCE_COLOR 和 NO_COLOR 用于末端着色

  • #10234：自动摘要：将“自动摘要”CSS类添加到摘要表

  • #10125：extlinks：改进具有标题的参考的建议消息

  • #10112：extlinks：添加 extlinks_detect_hardcoded_links 启用硬编码链接检测器功能

  • #9494，#9456：html搜索：添加配置变量 html_show_search_summary 启用/禁用搜索摘要

  • #9337：HTML主题，添加选项 enable_search_shortcuts 使 / 作为快速搜索快捷方式， Esc 删除搜索突出显示的快捷方式。

  • #10107：i18 n：允许通过添加来抑制翻译警告 #noqa 对每条翻译消息的尾部进行评论

  • #10252：C++，支持类、联合和列举上的属性。

  • #10253： pep 角色现在根据 peps.python.org

错误已修复

  • #9876：autodoc：无法记录从本地二进制模块构建的导入类

  • #10133：autodoc：当模拟模块用于类型注释时崩溃

  • #10146：autodoc： autodoc_default_options 不支持 no-value 选项

  • #9971：autodoc：当目标对象被不可哈希对象注释时，会引发TypHelp

  • #10205：extlinks：无法在检查硬编码链接时编译regBEP

  • #10277：html search：无法搜索短单词（例如：“使用”）

  • #9529：LaTeX：命名为自动编号脚注（例如 [#named] ）被多次引用的被标记为问号

  • #9924：LaTeX：多线 cpp:function 指令在Latexpdf中具有很大的垂直间距

  • #10158：LaTeX：自v4.4.0以来，未记录的变量/结构成员的空白过多

  • #10175：LaTeX：如果名称也在不同文档中使用，则命名脚注引用链接到错误的脚注

  • #10269：manpage：无法解析标题 ref 交叉引用

  • #10179：i18n：抑制“rST定位”警告

  • #10118：imgconverter：为远程uri调用不必要的可用性检查

  • #10181：naplogy：属性显示像谷歌风格的文档字符串类属性时， napoleon_use_ivar 启用

  • #10122：sphinx-Build：make. mat在显示帮助之前不会检查sphinx-Build命令的安装