Sphinx 2.3

版本2.3.1（2019年12月22日发布）

错误已修复

  • #6936：狮身X-自动生成器：引发Attribe错误

版本2.3.0（2019年12月15日发布）

不兼容的更改

  • #6742： end-before 选择 literalinclude 指令与代码块的第一行不匹配。

  • #1331：将默认用户代理标头更改为 "Sphinx/X.Y.Z requests/X.Y.Z python/X.Y.Z" . 可以通过以下方式更改 user_agent .

  • #6867：文本：训诫内容从一行后开始

弃用

  • sphinx.builders.gettext.POHEADER

  • sphinx.io.SphinxStandaloneReader.app

  • sphinx.io.SphinxStandaloneReader.env

  • sphinx.util.texescape.tex_escape_map

  • sphinx.util.texescape.tex_hl_escape_map_new

  • sphinx.writers.latex.LaTeXTranslator.no_contractions

功能添加

  • #6707：C++，支持位字段。

  • #267：html：从可复制文本中删除docTest块的提示字符

  • #6548：html：使用OpenSearch的favicon（如果可用）

  • #6729：html主题：agogo主题现在支持 rightsidebar 选项

  • #6780：添加PEP-561支持

  • #6762：乳胶：允许通过装载额外的LaTeX包装 extrapackages 关键 latex_elements

  • #1331：添加新配置变量： user_agent

  • #6000：LaTeX：具有反斜线也是内联字面义字绕字中断字符

  • #4186：LaTeX：支持LaTeX作为新产品 latex_engine （实验性）

  • #6812：当扩展不是并行安全时改进警告消息

  • #6818：提高多个远程库存的Interphinx性能。

  • #2546：apidoc：.so文件支持

  • #6798：自动摘要：emit autodoc-skip-member 生成树桩文件时的事件

  • #6483：i18 n：使toctree中的显式标题可翻译

  • #6816：链接检查：添加 linkcheck_auth 执行时提供身份验证信息的选项 linkcheck 构建

  • #6872：linkcheck：Handles HTTP 308 Permanent Redirect

  • #6613：html：将节号包裹在跨度标签中

  • #6781：gettext：添加 gettext_last_translator 和 gettext_language_team 自定义POT文件的头

错误已修复

  • #6668：LaTeX：标题前的Longtable距离不正确（参考文献： latex3/latex2e#173 )

  • #6618：LaTeX：避免在页面末尾使用节名

  • #6738：LaTeX：请勿在支持的unicode上用LaTeX宏替换unicode字符LaTeX引擎：¶、§、€、Infinity、±、→、RST、-、superScript和subtitle数字“按原样”进行（因为默认OpenType字体支持它们）

  • #6704：linkcheck：保持防御并处理新定义的HTTP错误代码

  • #6806：linkcheck：解析内容失败

  • #6655：包含的图像URL data: 导致gettext生成器崩溃

  • #6584：i18 n：用印地语编译消息目录时出错

  • #6718：i18 n：如果节标题和表标题相同，则引发Key错误

  • #6743：i18 n： rst_prolog 打破了翻译

  • #6708：mathbase：一些过时的函数已被删除

  • #6709：autodoc：模拟对象不作为类装饰器工作

  • #5070：epub：错误的内部href片段链接

  • #6712：允许不安装phinx.testing作为运行时（主要用于ALT Linux）

  • #6741：html：搜索结果被空打断 html_file_suffix

  • #6001：LaTeX不会在反斜线字符处包装长代码行

  • #6804：LaTeX：如果危险类型的警告包含足够长的代码块，无法容纳在一个页面上，PDF构建就会崩溃

  • #6809：LaTeX：危险警告中的代码块很容易溢出页面底部

  • #6793：texinfo：“侧边栏”后面损坏的代码示例

  • #6813：Windows上包含的文档会发出孤立警告。 感谢@Drillan

  • #6850：修复smartypants模块使用错误选项调用re.Sub（）

  • #6824：HTML搜索：如果搜索词在标题中部分匹配，而在同一页面上的文本段落中完全匹配，则搜索不包括此匹配。

  • #6848：config.py不应该从覆盖弹出扩展

  • #6867：文本：将额外的空白插入到折叠线上的连字符单词中

  • #6886：LaTeX：xelatex将直双引号转换为右卷曲双引号（显示何时 smartquotes 是 False )

  • #6890：LaTeX：即使关闭smartquotes，PDF输出也会将直引号和连续连字符转换为曲引号和破折号

  • #6876：LaTeX：标题页上作者的多行显示边缘参差不齐

  • #6887：Sphinx与Docutils 0.16b0发生碰撞

  • #6920：sphinx-build：错误地突出显示控制台消息

  • #6900：狮身X构建： -D 选项不考虑 0 和 1 作为布尔值