变更日志

发布 8.1.0（开发中）

依赖项

• #12756: 为 sphinxcontrib-* 依赖项添加下限.补丁由 Adam Turner 提供.

不兼容的更改

• #12763: 移除未使用的内部类 sphinx.util.Tee .补丁由 Adam Turner 提供.

自 已弃用 版本弃用.

• #12762: 弃用 sphinx.util.import_object .请改用 importlib.import_module() .补丁由 Adam Turner 提供.

• #12766: 废弃 sphinx.util.FilenameUniqDict 和 sphinx.util.DownloadFiles .补丁由 Adam Turner 提供.

添加的功能

• #11328: 在生成静态输出文件的过程中提及模板内容的评估.

• #12704: LaTeX: 使 contents 、topic 和 sidebar 指令在PDF输出时可单独自定义.补丁由 Jean-François B. 和 Bénédikt Tran 提供.

• #12474: 通过CSS支持基于类型的搜索结果高亮显示.补丁由Tim Hoffmann提供.

• #12652: LaTeX: 为 LaTeX 构建器添加 math_numsep 支持.补丁由 Thomas Fanning 和 Jean-François B. 提供.

• #12743: 使用 --fail-on-warning 时,不再在第一个警告时退出.相反,如果在构建过程中生成了任何警告,则以非零状态退出.补丁由 Adam Turner 提供.

• #12743: 添加 sphinx-build --exception-on-warning ,在构建过程中发出警告时引发异常.补丁由 Adam Turner 和 Jeremy Maitin-Shepard 提供.

修复的错误

• #12514: intersphinx: 修复 intersphinx_cache_limit 的负值含义.修补由张盛宇提供.

• #12722: LaTeX: 避免TeX报告 Overfull \hbox ,因为问题实际上已通过:ref:latexsphinxsetupforcewraps 解决.补丁由Jean-François B.提供.

• #12730:UnreferencedFootnotesDetector 转换功能已改进,以更一致地检测未引用的脚注.请注意,该转换的优先级已从 200 更改为 622,因此它现在在 docutils 的 Footnotes 解析转换之后运行.补丁由 Chris Sewell 提供.

• #12778: LaTeX: 让 :ref:`’sphinxsetup’ <latexsphinxsetup>```div.topic_box-shadow``键在仅设置一个维度时,根据文档同时设置 x-offset 和 y-offset.

• #12587: 当因大小写不敏感的重复目标导致 Intersphinx 解析时检测到潜在歧义时,不再发出警告.补丁由 James Addison 提供.

• #12639: 修复单数和复数搜索结果文本.补丁由Hugo van Kemenade提供.

• #12645:正确支持自定义 gettext 输出模板.补丁由 Jeremy Bowman 提供.

• #12717: LaTeX: 让 -q (安静) 选项适用于 sphinx-build -M latexpdf 或 make latexpdf ( O=-q ) 并传递给 latexmk .让 -Q (静默) 也适用于 PDF 构建阶段. 补丁由 Jean-François B. 提供.

• #12744: LaTeX: 通过自定义解释文本角色注入的类现在会产生嵌套的 \DUrole ,而不是一个用逗号分隔的类.补丁由让-弗朗索瓦·B 提供.

• #11970, #12551: singlehtml构建器:使目标URI成为符合 RFC 3986, §4.4 的同文档引用,例如, index.html#foo 变为 #foo . (注意:这是在 Sphinx 7.3.0 中添加的部分修复的延续) 补丁由 James Addison 提供（参考 Eric Norige 之前的工作）

• #12782: intersphinx: 修复生成库存文件URL时出现双斜杠的问题（即使用户定义的intersphinx项目的基URL以双斜杠结尾,也不会被更改）.补丁由Bénédikt Tran提供.

测试

• #12141: 从已弃用的 karma JavaScript 测试框架迁移到积极维护的 jasmine 框架.测试覆盖率未受影响.补丁由 James Addison 提供.

先前版本

• Sphinx 8.0
  • 版本 8.0.2（发布于 2024 年 7 月 30 日）
  • 发行版 8.0.1（发布于 2024年7月30日）
  • 发布版本 8.0.0（于 2024 年 7 月 29 日发布）
• Sphinx 7.4
  • 发布版本 7.4.7（于2024年7月20日发布）
  • 发布 7.4.6 （发行日期:2024年7月18日）
  • Release 7.4.5（发布于 2024 年 7 月 16 日）
  • 发布版本 7.4.4（于 2024 年 7 月 15 日发布）
  • 版本 7.4.3（发布于 2024年7月15日）
  • 发布 7.4.2（发布于 2024 年 7 月 15 日）
  • 版本 7.4.1 （发布日期:2024年7月15日）
  • 发布版本 7.4.0（于2024年7月15日发布）
• Sphinx 7.3
  • 发布 7.3.7（于 2024 年 4 月 19 日发布）
  • 发布 7.3.6 (发布于 2024 年 4 月 17 日)
  • 发布 7.3.5（发布于2024年4月17日）
  • 发行版 7.3.4 （发布于 2024 年 4 月 17 日）
  • 发布 7.3.3（发布于 2024年4月17日）
  • 版本 7.3.2（发布于 2024 年 4 月 17 日）
  • 第 7.3.1 版（于 2024 年 4 月 17 日发布）
  • Release 7.3.0（发布于2024年4月16日）
• Sphinx 7.2
  • 版本 7.2.6（发布于 2023 年 9 月 13 日）
  • 发布 7.2.5（于 2023 年 8 月 30 日发布）
  • Release 7.2.4（发布于2023年8月28日）
  • Release 7.2.3（发布于2023年8月23日）
  • 发布 7.2.2（发布于 2023 年 8 月 17 日）
  • Release 7.2.1 （发布于2023年8月17日）
  • Release 7.2.0（发布于2023年8月17日）
• Sphinx 7.1
  • 版本 7.1.2 （发布于 2023年8月2日）
  • 发布 7.1.1（2023年7月27日发布）
  • 发布 7.1.0（发布于 2023 年 7 月 24 日）
• Sphinx 7.0
  • 发布 7.0.1（发布于 2023 年 5 月 12 日）
  • 发布 7.0.0（发布于 2023 年 4 月 29 日）
• Sphinx 6.2
  • 版本 6.2.1（发布于 2023 年 4 月 25 日）
  • 版本 6.2.0 （发布于 2023 年 4 月 23 日）
• Sphinx 6.1
  • 发布 6.1.3（发布日期:2023年1月10日）
  • 发布 6.1.2（于2023年1月07日发布）
  • 版本 6.1.1（发布于 2023 年 1 月 5 日）
  • 发布 6.1.0（发布于 2023 年 1 月 5 日）
• Sphinx 6.0
  • 发布版本 6.0.1（2023年1月5日发布）
  • Release 6.0.0（发布于 2022 年 12 月 29 日）
• Sphinx 5.3
  • Release 5.3.0 （于2022年10月16日发布）
• Sphinx 5.2
  • 发布 5.2.3（发布于 2022 年 9 月 30 日）
  • 发布版本 5.2.2（发布日期:2022年9月27日）
  • 发布 5.2.1（发布于 2022 年 9 月 25 日）
  • 发布 5.2.0.post0（于 2022 年 9 月 24 日发布）
  • 发布 5.2.0（发布于 2022年9月24日）
• Sphinx 5.1
  • 发布 5.1.1（发布于 2022 年 7 月 26 日）
  • 发布 5.1.0（发布于 2022 年 7 月 24 日）
• Sphinx 5.0
  • 版本 5.0.2（发布于 2022年6月17日）
  • 版本 5.0.1（发布于 2022年6月3日）
  • 版本 5.0.0（发布于 2022 年 5 月 30 日）
• Sphinx 4.5
  • Release 4.5.0（发布于2022年3月28日）
• Sphinx 4.4
  • 发布 4.4.0（发布日期:2022年1月17日）
• Sphinx 4.3
  • 版本 4.3.2（发布于 2021 年 12 月 19 日）
  • 发布 4.3.1（发布于 2021年11月28日）
  • 发布 4.3.0（发布于2021年11月11日）
• Sphinx 4.2
  • 发布 4.2.0（发布于 2021年9月12日）
• Sphinx 4.1
  • 发布版本 4.1.2（发布于 2021 年 7 月 27 日）
  • 版本 4.1.1 （发布于 2021 年 7 月 15 日）
  • Release 4.1.0 （发布于 2021年7月12日）
• Sphinx 4.0
  • 版本 4.0.3（发布于 2021年7月5日）
  • 版本 4.0.2（发布于 2021 年 5 月 20 日）
  • 版本 4.0.1 （发布于 2021 年 5 月 11 日）
  • 发布 4.0.0（发布于 2021年5月9日）
• Sphinx 3.5
  • 发布 3.5.4（发布于 2021 年 4 月 11 日）
  • 版本 3.5.3（发布于 2021 年 3 月 20 日）
  • Release 3.5.2（发布于 2021年3月6日）
  • 版本 3.5.1（发布于 2021年2月16日）
  • Release 3.5.0（发布于2021年2月14日）
• Sphinx 3.4
  • 发行版 3.4.3（发布于 2021年1月8日）
  • Release 3.4.2（发布于2021年1月4日）
  • 发布 3.4.1（发布于2020年12月25日）
  • 发布版本 3.4.0（发布于 2020 年 12 月 20 日）
• Sphinx 3.3
  • 发布版本 3.3.1（发布于 2020 年 11 月 12 日）
  • 发布版本 3.3.0（于 2020 年 11 月 02 日发布）
• Sphinx 3.2
  • 发布 3.2.1（于2020年8月14日发布）
  • 发布 3.2.0（发布于 2020 年 8 月 8 日）
• Sphinx 3.1
  • 发布 3.1.2 （发布于 2020年7月5日）
  • 发布 3.1.1（发布于 2020年6月14日）
  • Release 3.1.0（发布于2020年6月8日）
• Sphinx 3.0
  • 发布 3.0.4（发布于 2020 年 5 月 27 日）
  • 发布 3.0.3（于 2020 年 4 月 26 日发布）
  • 发布 3.0.2（发布于 2020 年 4 月 19 日）
  • Release 3.0.1（发布于2020年4月11日）
  • 版本 3.0.0（发布于 2020 年 4 月 6 日）
• Sphinx 2.4
  • Release 2.4.5 （发布于2021年11月18日）
  • 发布版本 2.4.4（发布于 2020 年 3 月 5 日）
  • 版本 2.4.3（发布于 2020 年 2 月 22 日）
  • 发布 2.4.2（发布于 2020 年 2 月 19 日）
  • Release 2.4.1（发布于2020年2月11日）
  • Release 2.4.0 (发布于 2020年2月9日)
• Sphinx 2.3
  • Release 2.3.1（发布于2019年12月22日）
  • 版本 2.3.0（发布于 2019 年 12 月 15 日）
• Sphinx 2.2
  • 发布 2.2.2（发布日期:2019年12月03日）
  • 发布版本 2.2.1（发布于 2019 年 10 月 26 日）
  • 发布 2.2.0（于2019年8月19日发布）
• Sphinx 2.1
  • 发布版本 2.1.2（发布于 2019 年 6 月 19 日）
  • 发布 2.1.1（发布日期:2019年6月10日）
  • 发布 2.1.0（发布于 2019年6月2日）
• Sphinx 2.0
  • 版本 2.0.1（发行于 2019 年 4 月 08 日）
  • 发布 2.0.0（于2019年3月29日发布）
• Sphinx 1.8
  • 发布 1.8.6（发布于 2021 年 11 月 18 日）
  • 发布 1.8.5（发布于 2019 年 3 月 10 日）
  • 发布版本 1.8.4（发布于 2019 年 2 月 3 日）
  • 发行版 1.8.3（发布于 2018年12月26日）
  • 版本 1.8.2（于2018年11月11日发布）
  • Release 1.8.1 (发布于 2018年9月22日)
  • 版本 1.8.0（发布于 2018 年 9 月 13 日）
• Sphinx 1.7
  • 发布 1.7.9（发布于 2018 年 9 月 5 日）
  • 发布 1.7.8（发布于 2018年8月29日）
  • 版本 1.7.7（发布于 2018 年 8 月 19 日）
  • 发布版本 1.7.6（发布于 2018 年 7 月 17 日）
  • 发布版本 1.7.5（发布于 2018 年 5 月 29 日）
  • 版本 1.7.4（发布于 2018 年 4 月 25 日）
  • 发布 1.7.3 （发布于 2018年4月23日）
  • Release 1.7.2 (发布于 2018年3月21日)
  • 发行版本 1.7.1 （发布于 2018年2月23日）
  • 发布 1.7.0（于 2018 年 2 月 12 日发布）
• Sphinx 1.6
  • 发布 1.6.7（发布日期:2018年2月4日）
  • 发布 1.6.6 （发布于 2018 年 1 月 08 日）
  • 版本 1.6.5（发布于 2017 年 10 月 23 日）
  • 发布版本 1.6.4（发布于2017年9月26日）
  • Release 1.6.3（发布于 2017 年 7 月 2 日）
  • 版本 1.6.2（发布于 2017年5月28日）
  • 版本 1.6.1 （发布于 2017 年 5 月 16 日）
  • 发布 1.6（尚未发布）
• Sphinx 1.5
  • 版本 1.5.6（发布于 2017 年 5 月 15 日）
  • 发布版本 1.5.5 (发布于 2017年4月3日)
  • 发布 1.5.4（发行于 2017 年 4 月 2 日）
  • 发布 1.5.3（发布日期:2017年2月26日）
  • 版本 1.5.2（发布于 2017 年 1 月 22 日）
  • 发布 1.5.1 （于 2016 年 12 月 13 日发布）
  • 发布 1.5（发布于 2016 年 12 月 5 日）
• Sphinx 1.4
  • 发布 1.4.9（于2016年11月23日发布）
  • 释放 1.4.8（发布于 2016 年 10 月 1 日）
  • 发布 1.4.7（于2016年10月1日发布）
  • 发布 1.4.6（发布时间:2016年8月20日）
  • Release 1.4.5 (发布于 2016年7月13日)
  • Release 1.4.4 （发布于2016年6月12日）
  • 发布 1.4.3 (发布于 2016 年 6 月 5 日)
  • 发布 1.4.2（发布于 2016年5月29日）
  • 发布版本 1.4.1（发布于 2016 年 4 月 12 日）
  • 版本 1.4（发布于 2016 年 3 月 28 日）
• Sphinx 1.3
  • 发布版本 1.3.6（发布于 2016年2月29日）
  • 版本 1.3.5（发布于 2016 年 1 月 24 日）
  • Release 1.3.4（发布于 2016 年 1 月 12 日）
  • 发布版本 1.3.3（发布于 2015 年 12 月 2 日）
  • Release 1.3.2（发布于2015年11月29日）
  • Release 1.3.1 (发布于 2015年3月17日)
  • 发布 1.3（发布于 2015年3月10日）
  • 发布版本 1.3b3（发布于 2015年2月24日）
  • 发布版本 1.3b2（发布于 2014年12月5日）
  • 发布 1.3b1（发布于 2014年10月10日）
• Sphinx 1.2
  • 版本 1.2.3（发布于 2014 年 9 月 1 日）
  • 发布 1.2.2（发布于 2014年3月2日）
  • 版本 1.2.1（发布于 2014 年 1 月 19 日）
  • 发布 1.2 (发布于 2013年12月10日)
  • 版本 1.2 beta3（发布于 2013 年 10 月 3 日）
  • 发布 1.2 beta2（发布于2013年9月17日）
  • 版本 1.2 beta1（发布于 2013 年 3 月 31 日）
• Sphinx 1.1
  • 版本 1.1.3 (2012年3月10日)
  • 版本 1.1.2（2011年11月1日）– 1.1.1反正是个傻乎乎的版本号!
  • 版本 1.1.1 （2011年11月1日）
  • 版本 1.1（2011年10月9日）
• Sphinx 1.0
  • 版本 1.0.8 (2011年9月23日)
  • Release 1.0.7（2011年1月15日）
  • Release 1.0.6（2011年1月4日）
  • 发布 1.0.5 (2010年11月12日)
  • 发布 1.0.4（2010年9月17日）
  • 发布 1.0.3（2010年8月23日）
  • 版本 1.0.2 (2010年8月14日)
  • 发布 1.0.1 （2010年7月27日）
  • Release 1.0 (2010年7月23日)
• Sphinx 0.6
  • Release 0.6.7 (2010年6月5日)
  • Release 0.6.6（2010年5月25日）
  • Release 0.6.5 (2010年3月1日)
  • 版本 0.6.4（2010年1月12日）
  • 版本 0.6.3（2009年9月3日）
  • 发行版本 0.6.2 (2009年6月16日)
  • Release 0.6.1（2009年3月26日）
  • Release 0.6 (2009年3月24日)
• Sphinx 0.5
  • 发布版本 0.5.2（2009年3月24日）
  • 发布 0.5.1（2008年12月15日）
  • 发布 0.5（2008年11月23日）– 生日版!
• Sphinx 0.4
  • 发布 0.4.3 (2008年10月8日)
  • 发布 0.4.2 (2008年7月29日)
  • 发布版本 0.4.1（2008年7月5日）
  • 发布 0.4 (2008年6月23日)
• Sphinx 0.3
  • 发布 0.3 (2008年5月6日)
• Sphinx 0.2
  • Release 0.2（2008年4月27日）
• Sphinx 0.1
  • 发布 0.1.61950 (2008年3月26日)
  • 发布版 0.1.61945 （2008年3月26日）
  • 版本 0.1.61843（2008年3月24日）
  • 版本 0.1.61798 (2008年3月23日)
  • 发行版本 0.1.61611 (2008年3月21日)

Previous

术语表

Next

Sphinx 8.0