更新日志¶

Material for MkDocs¶

9.7.0 2025年11月11日¶

此版本包含之前仅限于内部版本的所有功能。这些功能现在对所有人开放。

关于已弃用插件的说明：此版本包含 projects 和 typeset 插件，但必须视为已弃用。这两个插件的维护被证明是不可持续的，并且代表了架构的死胡同。它们按原样提供，不再提供持续支持。

更改：

• 添加对项目插件的支持（兼容性，现在已弃用）
• 添加对排版插件的支持（兼容性，现在已弃用）
• 添加对固定博客文章和作者简介的支持
• 添加对自定义博客索引页面分页的支持
• 添加对自定义博客类别排序顺序的支持
• 添加对切换语言时保持在页面上的支持
• 添加对在目录中禁用标签的支持
• 添加对嵌套标签和阴影标签的支持
• 添加对脚注工具提示的支持
• 添加对即时预览的支持
• 添加对即时预取的支持
• 添加对自定义社交卡布局的支持
• 添加对自定义社交卡背景图像的支持
• 添加对代码块中可选择范围的支持
• 添加对代码注释的自定义选择器的支持
• 添加对隐私插件中可配置日志级别的支持
• 添加对隐私插件中外部链接处理的支持
• 添加通过优化插件进行自动图像优化的支持
• 添加对导航路径（面包屑）的支持
• 修复 #8519：使用 KaTeX 时矢量重音未渲染

9.6.23 2025年11月1日¶

• 更新缅甸语翻译

9.6.22 2025年10月15日¶

• 更新格鲁吉亚语翻译

9.6.21 2025年9月30日¶

• 更新塞尔维亚语翻译
• 修复 #8458：点击依赖的临时固定

9.6.20 2025年9月15日¶

• 修复 #8446：Emoji 扩展中的 Python 3.14 弃用警告
• 修复 #8440：搜索高亮中未转义的 & 字符
• 修复 #8439：社交卡中未设置 FontAwesome 图标颜色（回归）

9.6.19 2025年9月7日¶

• 添加对 Python 3.14 的支持
• 更新马来西亚语翻译

9.6.18 2025年8月22日¶

• 更新阿塞拜疆语翻译
• 修复与 minijinja 的最后兼容性问题，现在 100% 兼容

9.6.17 2025年8月15日¶

• 修复 #8396：内容标签内的视频不自动播放
• 修复 #8394：Mermaid.js 图表中的笔画宽度无效
• 修复隐藏页面标题时消失的版本选择器

9.6.16 2025年7月26日¶

• 修复 #8349：信息插件在某些情况下无法正确检测虚拟环境
• 修复 #8334：页面内查找在隐藏的搜索结果列表中检测到匹配项

9.6.15 2025年7月1日¶

• 更新蒙古语翻译
• 改进“编辑此页面”按钮的语义标记
• 改进信息插件的虚拟环境解析
• 修复 #8291：大字体设置在 JavaScript 中抛出断点

9.6.14 2025年5月13日¶

• 修复 #8215：当 CairoSVG 更新到 2.8 时社交插件崩溃

9.6.13 2025年5月10日¶

• 修复 #8204：打印视图中注释显示列表标记
• 修复 #8153：改进 Mermaid.js ER 图中的基数符号样式

9.6.12 2025年4月17日¶

• 修复 #8158：为从右到左语言翻转脚注反向引用图标

9.6.11 2025年4月1日¶

• 更新 Docker 镜像到最新的 Alpine Linux
• 将所需的 Jinja 版本提升到 3.1
• 修复 #8133：Jinja 过滤器 items 不可用（9.6.10 回归）
• 修复 #8128：通过启用设置未完全禁用搜索插件

9.6.10 2025年3月30日¶

此版本是一个纯重构版本，不包含新功能或错误修复。它旨在改善我们模板与当前正在探索的替代 Jinja 类模板引擎的兼容性，包括 minijinja。

此外，它用模板过滤器的惯用用法替换了多个 Python 函数调用。在模板内部变更变量的所有实例都已被替换。大多数更改发生在部分中，仅在块中发生少数更改，所有更改都是完全向后兼容的，因此不需要对覆盖进行更改。

请注意，此版本不将 Jinja 模板引擎替换为 minijinja。然而，我们的模板现在与 minijinja 99% 兼容，这意味着我们可以探索替代的 Jinja 兼容实现。此外，不可变性和几乎所有 Python 函数调用的移除意味着更符合惯用的模板化。

9.6.9 2025年3月17日¶

• 更新塞尔维亚-克罗地亚语翻译
• 修复 #8086：包含哈希的自定义 SVG 图标破坏渲染
• 修复 #8067：在某些操作系统上，Firefox 中的抽屉右侧有间隙

9.6.8 2025年3月13日¶

• 添加威尔士语翻译
• 修复 #8076：如果 HTTP 下载失败，隐私插件崩溃

9.6.7 2025年3月3日¶

• 修复 #8056：反向引用实现中的错误（9.6.6 回归）
• 修复 #8054：目录中的 ARIA 标签未转义的引号

9.6.6 2025年3月1日¶

• 修复 #8040：隐私插件未替换外部资产（9.6.5 回归）
• 修复 #8031：在搜索插件中替换未维护的 regex 包

9.6.5 2025年2月20日¶

• 修复 #8016：当文件名包含空格时，标签列表不显示
• 修复 #8012：如果 HTTP 下载失败，隐私插件崩溃

9.6.4 2025年2月12日¶

• 修复 #7985：博客内容有时未延伸到全宽
• 修复 #7978：Safari 18.3 中的导航渲染错误

9.6.3 2025年2月7日¶

• 修复 Mermaid.js 类图中箭头头部的渲染
• 修复 #7960：标签插件在数字元数据标题上崩溃

9.6.2 2025年2月3日¶

• 修复 #7955：过长的单词在窄屏幕上不换行
• 修复 #7947：范围设置干扰过时版本横幅

9.6.1 2025年1月31日¶

• 修复 #7943：由于合并错误导致标签插件崩溃

9.6.0 2025年1月31日¶

• 添加元插件
• 重写标签插件
• 添加对标签插件中允许列表的支持
• 添加对标签插件中自定义排序的支持
• 添加对博客插件中相关链接的支持
• 添加对博客插件中自定义索引页面的支持
• 添加对导航副标题的支持
• 修复 #7924：使用即时导航时，锚点可能需要两次点击

9.5.50 2025年1月18日¶

• 修复 #7913：社交插件在页面标题中渲染属性列表

9.5.49 2024年12月16日¶

• 调整所有支持的 Mermaid.js 图表的深色模式标题颜色
• 修复 #7803：隐私插件在生成的文件上崩溃
• 修复 #7781：深色模式下 Mermaid.js 流程图标题不可见

9.5.48 2024年12月8日¶

• 修复 #7774：禁用社交卡无效

9.5.47 2024年12月1日¶

• 修复 #7750：数字标签破坏搜索
• 修复 #7748：使用未来草稿时，博客插件崩溃（9.5.45 回归）

9.5.46 2024年11月25日¶

• 添加对隐私插件中移除 preload 提示的支持
• 修复 #7734：h5 标题中的代码块为大写
• 修复 #7725：缺少时区时博客插件崩溃（9.5.45 回归）

9.5.45 2024年11月20日¶

• 通过多阶段构建减少 Docker 镜像的大小
• 修复 #7708：使用带有时区的 YAML 日期时博客插件崩溃

9.5.44 2024年11月5日¶

• 修复 #7672：使用隐私插件时字体 CSS 404（9.5.43 回归）

9.5.43 2024年10月31日¶

• 添加对隐私插件中 SVG 中外部图像的支持
• 修复 #7651：隐私插件未处理 CSS 中的带引号 URL

9.5.42 2024年10月20日¶

• 修复 #7625：隐私插件中布尔属性的无效编码
• 修复 #7624：禁用隐私插件时崩溃（9.5.41 回归）

9.5.41 2024年10月15日¶

• 修复 #7619：改进的徽标工具提示在即时导航后消失
• 修复 #7616：内置隐私插件在内联资产时的竞争条件
• 修复 #7615：打印时可见的评论和“此页面有帮助吗？”

9.5.40 2024年10月10日¶

• 更新拉脱维亚语翻译
• 修复 #7597：社交卡在主页上未使用站点名称

9.5.39 2024年9月29日¶

• 修复 #7226：使用 mike 的规范版本时未保持在页面上

9.5.38 2024年9月26日¶

• 添加阿尔巴尼亚语翻译

9.5.37 2024年9月25日¶

• 添加第 4 和第 5 级有序列表样式
• 修复 #7548：搜索中标签没有间距

9.5.36 2024年9月21日¶

• 修复 #7544：社交卡错误渲染 HTML 实体
• 修复 #7542：改进自定义列表样式设置的支持

9.5.35 2024年9月18日¶

• 修复 #7498：越南语搜索未显示

9.5.34 2024年8月31日¶

• 更新 Mermaid.js 到版本 11（最新）

9.5.33 2024年8月23日¶

• 修复 #7453：排序表时工具提示位置不正确

9.5.32 2024年8月19日¶

• 修复通过搜索结果中的深层链接修复 RXSS 漏洞
• 添加从 GitLab 获取最新版本的支持

9.5.31 2024年8月2日¶

• 修复 #7405：由于 Alpine/APK 的更改，DockerHub 缺少大于 9.5.27 的图像

9.5.30 2024年7月23日¶

• 修复 #7380：在 Safari 中悬停时导航图标消失
• 修复 #7367：博客阅读时间计算包括 SVG 文本内容

9.5.29 2024年7月14日¶

• 更新加利西亚语翻译
• 修复 #7362：图形标题中的注释渲染不正确

9.5.28 2024年7月2日¶

• 修复 #7313：当功能被禁用时，侧边栏中改进的工具提示

9.5.27 2024年6月16日¶

• 更新爱沙尼亚语翻译

9.5.26 2024年6月6日¶

• 修复 #7232：链接标签时切换时标签切换
• 修复 #7230：当引用本地文件时，博客作者头像损坏

9.5.25 2024年5月27日¶

• 修复 #7209：数字标签崩溃的标签插件

9.5.24 2024年5月20日¶

• 修复 #7187：版本选择器标题渲染问题

9.5.23 2024年5月15日¶

• 修复 #7183：使用即时导航时锚点导航的边缘情况
• 修复 #6436：版本选择器未显示版本别名

9.5.22 2024年5月12日¶

• 修复 #7170：复制按钮为行跨度添加空行（9.5.18 回归）
• 修复 #7160：版本切换时未保持在页面上（9.5.5 回归）
• 修复 #5619：Mermaid.js 图表中的链接不可辨别

9.5.21 2024年5月3日¶

• 修复 #7133：确保使用最新版本的 Mermaid.js
• 修复 #7125：为信息插件添加 dotfiles 的警告

9.5.20 2024年4月29日¶

• 修复隐私插件中的弃用警告（9.5.19 回归）
• 修复 #7119：标签插件发出弃用警告（9.5.19 回归）
• 修复 #7118：如果禁用字体，社交插件崩溃（9.5.19 回归）
• 修复 #7085：在下载字体时社交插件在 Windows 上崩溃

9.5.19 2024年4月25日¶

• 更新 MkDocs 到 1.6 并限制版本为 < 2
• 更新 Docker 镜像到最新的 Alpine Linux
• 移除 setup.py，现在 GitHub 完全理解 pyproject.toml
• 改进社交插件与第三方 MkDocs 主题的互操作性
• 修复 #7099：博客阅读时间未正确渲染日语
• 修复 #7097：在没有标签的情况下提高标签插件的弹性
• 修复 #7090：嵌套内容标签中的活动标签指示器渲染错误

9.5.18 2024年4月16日¶

• 重构工具提示实现以修复定位问题
• 修复 #7044：在 Chrome 中悬停贡献者头像时的渲染故障
• 修复 #7043：移动设备上代码块中的高亮行被截断
• 修复 #6910：侧边栏中页面状态的工具提示位置不正确
• 修复 #6760：表格中工具提示位置不正确且过长
• 修复 #6488：内容标签中工具提示位置不正确且被截断

9.5.17 2024年4月2日¶

• 更新塞尔维亚语翻译
• 修复 #7003：调色板切换的键盘交互令人困惑
• 修复 #7001：博客文章现在默认显示时间（9.5.16 回归）
• 修复社交插件字体加载逻辑的边缘情况

9.5.16 2024年3月31日¶

• 更新俄语翻译
• 改进社交插件中的错误处理和报告
• 改进隐私插件中的错误处理和报告
• 修复博客插件不允许在格式字符串中使用时间
• 修复 #6983：社交插件因 Google Fonts API 更改而崩溃

9.5.15 2024年3月23日¶

• 恢复透明 iframe 的修复（9.5.14）
• 修复 #6929：社交插件与自动深色模式的干扰
• 修复 #6938：Giscus 在亮色模式下显示深色背景（9.5.14 回归）

9.5.14 2024年3月18日¶

• 添加在使用 mike 时隐藏版本的支持
• 添加初始化系统以改善 Docker 镜像中的信号处理
• 修复信息插件排除逻辑中的边缘情况
• 修复搜索插件中无法重置管道的问题
• 修复芬兰语翻译中的语法错误
• 修复 #6917：Windows 上的博客插件中的 UTF-8 编码问题
• 修复 #6889：透明 iframe 获取背景颜色

9.5.13 2024年3月6日¶

• 更新斯洛伐克语翻译
• 改进信息插件与项目插件的互操作性
• 改进信息插件的包含/排除逻辑
• 修复信息插件未递归收集文件
• 修复 #6750：确保信息插件打包所有必要文件

9.5.12 2024年2月29日¶

• 修复 #6846：在即时导航时某些元标签被移除（9.4.2 回归）
• 修复 #6823：在即时导航时 KaTex 未渲染（9.5.5 回归）
• 修复 #6821：隐私插件未处理带编码字符的 URL

9.5.11 2024年2月24日¶

• 更新芬兰语翻译

9.5.10 2024年2月19日¶

• 更新马来西亚语翻译
• 修复 #6783：对于没有分隔符的博客文章隐藏继续阅读链接
• 修复 #6779：集成目录的定位不正确

9.5.9 2024年2月10日¶

• 修复启用标签和部分时的导航修剪

9.5.8 2024年2月7日¶

• 添加泰米尔语翻译
• 更新世界语翻译
• 修复即时导航时未解析相对图像的问题

9.5.7 2024年2月3日¶

• 修复 #6731：图形中的小图像未居中
• 修复 #6719：即时导航破坏目录（9.5.5 回归）

9.5.6 2024年1月28日¶

• 修复 #6700：缺少 Markdown 中 Mermaid.js 标签的样式

9.5.5 2024年1月24日¶

• 更新塔加洛语翻译
• 更新 Pillow 到 10.2 以减轻安全漏洞
• 改进即时导航的弹性
• 修复 #6687：更新 Mermaid.js 到版本 10.7.0（最新）
• 修复 #6652：捕获自定义元素中的键盘事件
• 修复 #6582：即时导航未正确处理备用 URL
• 修复 #6565：即时导航不允许 onclick 处理程序
• 修复 #6345：即时导航有时破坏浏览器后退按钮
• 修复 #6334：即时导航未正确定位锚点（Safari）
• 修复 #6275：即时导航在 404 后未正确解析
• 修复 #6102：即时导航在相同链接导航时重新加载页面

9.5.4 2024年1月15日¶

• 修复 #6645：具有无效值的本地存储可能会破坏网站
• 修复 #6635：如果设置了默认值，则在默认值之前的标签图标被忽略

9.5.3 2023年12月23日¶

• 限制 MkDocs 的版本范围为 < 1.6
• 更新马其顿语翻译
• 修复 #6520：使用 mike 时组插件崩溃
• 修复 #6494：如果在 git-authors 插件中禁用，则隐藏作者的电子邮件地址

9.5.2 2023年12月11日¶

• 修复博客插件配置中的 slugify 设置类型
• 修复 #6469：MathJax 容器上的水平滚动条

9.5.1 2023年12月8日¶

• 更新希腊语翻译
• 修复 #6464：隐私插件无法启用
• 修复 #6461：排序博客文章时忽略日期中的时间组件

9.5.0 2023年12月7日¶

合并“Goat's Horn”资助目标的内部版本功能

• 添加隐私插件：自动下载外部资产
• 添加对卡片网格和网格布局的支持
• 添加对改进工具提示的支持
• 添加对内容标签锚链接（深层链接）的支持
• 添加对自动深色/亮色模式的支持
• 添加对文档贡献者的支持

9.4.14 2023年11月26日¶

• 添加对博客文章中链接作者的支持

9.4.13 2023年11月26日¶

• 修复 #6365：博客插件分页链接到前一页损坏
• 修复 #5758：更新 Mermaid.js 到版本 10.6.1（最新）

9.4.12 2023年11月24日¶

• 改进博客插件以默认生成 Unicode 感知的 slug
• 修复博客插件中类别的非确定性顺序

9.4.11 2023年11月23日¶

• 修复 #6364：在服务时启用主题时搜索插件崩溃
• 修复禁用分页时博客插件崩溃

9.4.10 2023年11月19日¶

• 修复 #6356：版本选择器无法通过 mike 的配置禁用
• 修复 #6281：由于 Safari 错误，导航未渲染（9.4.2 回归）
• 修复 #6261：导航扩展在首次加载时动画（9.4.2 回归）

9.4.9 2023年11月17日¶

• 修复 #6344：目录中的长条目被截断
• 修复 #6336：自定义模板的 glob 存档在分页时无法工作
• 修复 #6328：博客插件在带有破折号的区域（例如 pt-BR）崩溃
• 修复 #6327：复制到剪贴板按钮未修剪尾随换行符
• 修复 #6302：使用 mike 时版本字符串未匹配，仅别名
• 修复 Chrome 中 gzipped 内容的即时导航进度指示器
• 修复 Firefox 中详细信息标记旋转的渲染错误

9.4.8 2023年11月5日¶

• 修复无效的本地地址替换，当使用即时加载时
• 修复 #6275：使用即时加载后导航导致 404 时崩溃

9.4.7 2023年10月27日¶

• 添加阿塞拜疆语翻译

9.4.6 2023年10月14日¶

• 更新丹麦语和挪威语（新挪威语）翻译
• 修复 #6169：博客文章元数据布局在小屏幕上溢出

9.4.5 2023年10月10日¶

• 修复侧边栏自动定位（9.4.2 回归）
• 修复 #6166：改善组插件与 Python < 3.10 的兼容性
• 修复 #6157：隐藏标签无效（9.4.3 回归）

9.4.4 2023年10月5日¶

• 添加支持覆盖要复制的文本以供代码块使用
• 修复某些浏览器在断点时布局破损
• 修复 #6132：标题中的代码块搜索高亮不完整

9.4.3 2023年10月2日¶

• 添加对即时导航进度指示器的支持
• 改善标签的间距和对齐
• 将返回顶部按钮移入单独的部分
• 修复 #6104：在搜索中丢失某些代码块的缩进
• 修复 #6094：博客文章元数据在小屏幕上与页脚重叠
• 修复 #6069：博客插件在具有非 ASCII 名称的类别中崩溃

更新的模板 (diff)

• base.html

9.4.2 2023年9月25日¶

• 更新斯洛文尼亚语翻译
• 为侧边栏导航扩展和折叠添加动画
• 添加对即时导航的文档头自动替换的支持
• 改善新 emoji 扩展与 Python < 3.10 的兼容性
• 切换正则表达式依赖以使用最小版本
• 重构侧边栏导航的对齐和间距
• 修复扩展按钮在侧边栏导航中无法通过键盘聚焦
• 修复使用即时导航时首次加载时视口偏移恢复
• 修复在博客插件侧边栏中意外高亮不可点击元素
• 修复 #6041：当 nav 被定义且博客未包含时，博客插件崩溃
• 修复 #5972：博客插件在分页视图中忽略部分索引页面
• 修复 #5954：在使用即时导航时，重复点击锚点被忽略
• 修复 #5742：使用即时导航时键盘导航中断

更新的模板 (diff)

• partials/nav-item.html
• blog-post.html

9.4.1 2023年9月22日¶

• 改进深色模式中的颜色和对比度
• 改进警告边框以匹配字体粗细
• 将内容标签切换为中性色

9.4.0 2023年9月21日¶

• 添加白俄罗斯语翻译
• 将版本信息添加到包的入口点
• 添加 emoji 扩展以替代 materialx
• 改进石板配色方案（深色模式） - 现在更深
• 重组项目以改善开发体验
• 更新 MkDocs 到 1.5.3
• 修复 #3890：在 Linux 上开发模式崩溃

9.3.2 2023年9月19日¶

• 更新斯洛文尼亚语翻译
• 更新要求中的 Python 依赖项以使用最低版本
• 修复 #6017：社区版和内部版中的代码高亮不一致
• 修复 #6001：贡献者头像在 Firefox 中显示不正确
• 修复 #6000：博客文章草稿包含在导航中

9.3.1 2023年9月11日¶

• 修复组插件与钩子一起使用时崩溃

9.3.0 2023年9月11日¶

• 改进社区版和内部版之间的配置共享
• 添加实验性内置组插件以有条件启用插件
• 在标签插件中添加启用/禁用的新设置
• 放弃对 Python 3.7 的支持（EOL）

9.2.8 2023年9月4日¶

• 更新意大利语和俄语翻译
• 修复 #5952：组合博客和标签插件导致错误链接
• 修复 #5951：博客插件在元数据中忽略文章标题
• 修复 #5949：博客插件在导航中忽略链接的文章

9.2.7 2023年9月2日¶

• 切换依赖项以兼容发布条款
• 移除博客插件的 readtime 和 lxml 依赖项
• 减少 Docker 镜像的大小以提高 CI 构建性能
• 修复 #5945：博客的兄弟页面的页脚导航不正确
• 修复 #5939：更改调色板时页面跳转（Firefox 117）
• 修复 #5901：使用即时加载时公告栏重新出现
• 修复 #5824：允许自定义序列图的样式

9.2.6 2023年8月31日¶

• 添加巴斯克语翻译
• 添加简单重定向的模板
• 通过将视图生成移动到 on_files 改进博客插件的互操作性
• 修复 #5924：社交插件在禁用时仍检查依赖项
• 修复 #5916：博客插件在 Python 3.8 上崩溃（9.2.0 回归）

9.2.5 2023年8月27日¶

• 修复博客插件使用脏模式时的错误
• 修复博客插件分页中页面标题不一致
• 修复 #5899：禁用目录 URL 时博客插件分页损坏

9.2.4 2023年8月26日¶

• 在信息插件中将版本添加到错误报告名称
• 更新南非荷兰语翻译

9.2.3 2023年8月22日¶

• 修复博客插件在 markdown.extensions.toc 中错误渲染
• 修复博客插件入口点生成

9.2.2 2023年8月22日¶

• 修复 #5880：构建独立博客时博客插件失败
• 修复 #5881：博客插件与 Python < 3.10 不兼容

9.2.1 2023年8月21日¶

• 修复 #5879：构建独立博客时博客插件失败
• 修复使用未来日期进行草稿标记时博客插件中的错误
• 修复当 toc 扩展未启用时博客插件中的错误

9.2.0 2023年8月21日¶

新增和改进

• 通过内置博客插件添加博客支持
• 添加对搜索插件中中文语言分割的支持
• 添加对博客文章中自定义日期的支持
• 添加对归档和类别页面分页的支持
• 添加对注释（代码块外）的支持
• 添加对导航图标的支持
• 添加对导航修剪的支持
• 添加对导航状态的支持
• 添加对自定义站点图标的支持
• 添加对自定义（代码）注释图标的支持
• 为警告和详细信息添加焦点轮廓
• 为信息插件添加错误报告名称提示
• 添加卢森堡语翻译
• 改进（代码）注释标记的渲染
• 改进（代码）注释的打印样式
• 改进导航标签的可定制性
• 改进插件与 mike 等外部工具的互操作性
• 改进博客插件与 awesome pages 插件的互操作性
• 通过将按钮移入单独的部分改进头部部分
• 改进社交插件中的 site_url 警告的清晰度
• 改进博客插件以自动设置目录结构
• 将信息插件切换到 importlib 以减轻弃用
• 在必要时自动下载 ResizeObserver 填充
• 在离线插件中必要时自动添加 iframe-worker 填充
• 在触摸设备上自动聚焦并调出键盘
• 更新塞尔维亚-克罗地亚语翻译
• 更新 MkDocs 到 1.5.2

移除

• 移除 Universal Analytics 集成
• 移除古老的填充以减少捆绑 JavaScript 的大小 20%
• 移除对 Array.flat 和 Array.flatMap 填充的必要性
• 当 JavaScript 不可用时移除公告栏按钮

修复

• 修复在公告栏存在时标签的渲染
• 修复标签插件渲染被其他插件排除的页面
• 修复 #5132：博客插件需要在 mkdocs.yml 中定义 nav 条目
• 修复 #5599：默认链接颜色对比度不足
• 修复 #5715：博客插件在分页中缺少集成目录
• 修复 #5806：某些 Android 设备上版本选择器无法悬停
• 修复 #5826：带标签的博客文章草稿出现在标签索引中

9.1.21 2023年7月27日¶

• 修复社交插件中的 MkDocs 1.4 兼容性问题（9.1.20 回归）

9.1.20 2023年7月27日¶

• 更新梵语翻译
• 修复社交插件的弃用警告

9.1.19 2023年7月18日¶

• 添加对 MkDocs 1.5+ 的支持
• 修复 #5699：改进社交插件中的错误报告

9.1.18 2023年7月3日¶

• 更新丹麦语翻译
• 添加在 Docker 镜像中安装用户要求的支持
• 修复 #5655：搜索分隔符与后视镜破坏高亮

9.1.17 2023年6月23日¶

• 修复 #5633：嵌套列表的代码注释未正确挂载
• 修复 #5628：新社交插件配置方案中的回归

9.1.16 2023年6月15日¶

• 更新印尼语翻译
• 确保滚动条遵循操作系统的配色方案

9.1.15 2023年5月29日¶

• 修复 #5566：向操作系统指示配色方案
• 修复 #5565：更新 Dockerfile 到最新版本的基础镜像
• 修复 #5554：向 Docker 镜像添加额外的版本标签（9，9.1）
• 修复 #5536：在目录中删除 ARIA 标签的标签

9.1.14 2023年5月20日¶

• 更新亚美尼亚语和希腊语翻译

9.1.13 2023年5月16日¶

• 修复 #5517：社交插件对某些字体（例如 Open Sans）崩溃

9.1.12 2023年5月12日¶

• 更新孟加拉语（孟加拉）翻译
• 修复 #5503：Docker 镜像发布错误，使用大写字符
• 修复 #5407：在隐藏内容标签时自动暂停媒体

9.1.11 2023年5月8日¶

• 修复 #5487：社交插件在没有选项时崩溃（9.1.10 回归）

9.1.10 2023年5月8日¶

• 添加社交卡的 cards_layout_options 设置
• 弃用社交卡的 cards_color 和 cards_font 设置

9.1.9 2023年5月2日¶

• 添加泰卢固语、卡纳达语和梵语翻译
• 修复 #5428：修复轻/暗模式图像的边距
• 修复 #5420：社交插件对某些特定 Google Fonts 崩溃
• 修复 #5160：即时加载使代码注释跳跃（9.1.1 回归）
• 修复 #4920：社交插件未从自定义图标集中加载徽标
• 修复社交插件在仅指定代码字体时崩溃

9.1.8 2023年4月24日¶

• 修复 #5417：主题在未定义 palette 时中断（9.1.7 回归）

9.1.7 2023年4月22日¶

• 更新波斯语（法尔西）和土耳其语翻译
• 修复 #5401：添加缺失的标志以禁用内置标签插件
• 修复 #5206：确保为主色和强调色设置默认值
• 修复未使用时不必要地包含调色板 CSS

9.1.6 2023年4月7日¶

• 更新波斯语（法尔西）翻译
• 修复 #5300：Mermaid 序列图中的框未遵循颜色

9.1.5 2023年3月31日¶

• 更新立陶宛语和日语翻译
• 更新 Mermaid.js 到版本 9.4.3
• 修复 #5290：页脚上前/后标签在短页面标题上被截断

9.1.4 2023年3月24日¶

• 修复 #5239：即时加载破坏详细信息中的锚点（9.1.1 回归）
• 修复 #5211：锚点跟随不适用于中文（9.1.2 回归）

9.1.3 2023年3月14日¶

• 添加库尔德语（索拉尼）翻译
• 更新挪威语（博克mål）、葡萄牙语和罗马尼亚语翻译
• 改进与 mkdocs-jupyter 插件的兼容性
• 修复 #5198：内置搜索插件未过滤 script 和 style 标签
• 修复 #5176：返回顶部 + 即时加载无法正常工作（9.1.1 回归）

9.1.2 2023年3月9日¶

• 更新冰岛语、韩语和瑞典语翻译
• 修复 #5168：Mermaid 文本框溢出（9.0.13 回归）
• 修复 #5155：目录未突出显示百分比编码的 URL

9.1.1 2023年3月5日¶

• 更新捷克语和泰语翻译
• 改进即时加载（滚动恢复，慢连接）
• 修复 #5023：即时加载不允许返回到初始页面
• 修复 #3797：即时加载在 Safari 中不适用于部分锚点

9.1.0 2023年3月2日¶

• 现在可用于 amd64、arm64 和 arm/v7 的 Docker 镜像
• 更新中文（台湾）翻译
• 通用标签标识符实现
• 修复加载时标题阴影闪烁
• 修复公告栏偶尔闪烁

9.0.15 2023年2月26日¶

• 更新中文（繁体）翻译
• 更新希伯来语翻译

9.0.14 2023年2月23日¶

• 修复 #5072：导航扩展按钮在 Firefox 中的渲染错误

9.0.13 2023年2月18日¶

• 更新乌兹别克语翻译
• 切换回 9.0.0 之前的标题检测在 content 部分
• 修复 #5062：使用石板方案时版本警告不可读
• 修复 #5061：改进表格行悬停颜色的可辨别性
• 修复 #5034：Mermaid 图中的序列参与者不遵循颜色
• 修复 #4919：允许在多个版本中隐藏版本警告

9.0.12 2023年2月9日¶

• 更新加泰罗尼亚语翻译
• 修复 #4975：Mermaid 实体关系渲染图表错误
• 修复 #4924：使用即时加载时标题未重置

9.0.11 2023年2月3日¶

• 添加 Mastodon 验证社交链接（rel=me）
• 更新意大利语翻译

9.0.10 2023年2月2日¶

• 更新阿拉伯语翻译
• 更新韩语翻译
• 更新匈牙利语翻译
• 更新俄语翻译
• 修复 #4977：提高内容标签的可访问性
• 修复 #4960：有时锚点跟随未将最后一个项目带入视图

9.0.9 2023年1月30日¶

• 更新保加利亚语翻译
• 更新中文（简体）翻译
• 更新荷兰语翻译
• 更新印地语翻译
• 更新日语翻译
• 更新波兰语翻译

9.0.8 2023年1月29日¶

• 更新克罗地亚语翻译
• 更新法语翻译
• 更新匈牙利语翻译
• 更新葡萄牙语（巴西）翻译
• 更新西班牙语翻译
• 更新乌克兰语翻译
• 更新乌尔都语翻译
• 更新越南语翻译

9.0.7 2023年1月28日¶

• 改进侧边栏导航的可访问性
• 将所有翻译移入社区版
• 更新波兰语和葡萄牙语（巴西）翻译
• 修复信息插件在后续重新加载时终止
• 修复 #4910：侧边栏导航标签具有无效的 ARIA 角色
• 修复 #4884：搜索查询术语无法通过冒号分隔

9.0.6 2023年1月19日¶

• 修复 #4883：在服务时自动禁用信息插件
• 修复 #4885：搜索插件在某些特殊情况下崩溃（9.0.3 回归）

9.0.5 2023年1月14日¶

• 修复 #4842：改善搜索结果列表的可访问性

9.0.4 2023年1月12日¶

• 修复 #4823：改善页脚中的对比度比例以符合 WCAG 指南
• 修复 #4832：将导航项目颜色恢复为黑色（9.0.3 回归）
• 修复 #4843：由于 maxcdn.com 关闭，表情符号破损
• 升级 Python Markdown 扩展到 9.9.1

9.0.3 2023年1月8日¶

• 改进导航中节索引页面的可辨别性
• 改进搜索插件中相邻空白的折叠
• 更新印尼语翻译
• 修复此页面的查看源按钮，当编辑 URL 指向 blob 时
• 修复 #4829：搜索覆盖未关闭活动锚结果
• 修复 #4824：搜索插件在其他元素中包含 h[1-6] 时崩溃
• 修复 #4804：嵌套导航项目无法通过键盘展开
• 修复 #4689：锚点跟踪不适用于表格中的锚点
• 升级到 Mermaid 9.3.0

9.0.2 2023年1月4日¶

• 修复 #4823：改善页脚中的对比度比例以符合 WCAG 指南
• 修复 #4819：社交插件在禁用卡片生成时崩溃
• 修复 #4817：搜索插件在 nav 中的数字页面标题崩溃

9.0.1 2023年1月3日¶

• 移除内置信息插件的 pipdeptree 依赖
• 修复链接标签在悬停时的外观（9.0.0 回归）
• 修复 #4810：缩写在触摸设备上超出屏幕
• 修复 #4813：查看源和编辑按钮链接相同

9.0.0 2023年1月2日¶

新增和改进

• 添加对丰富搜索预览的支持
• 添加对分词器前瞻的支持
• 添加对更好的搜索高亮的支持
• 添加对从搜索中排除内容的支持
• 添加对可配置搜索管道的支持
• 添加对通过离线插件进行离线搜索的支持
• 添加对内置标签插件的多个实例的支持
• 添加对删除复制到剪贴板按钮的支持
• 添加对删除页脚导航的支持
• 添加查看页面源的按钮支持
• 改善搜索共享的查询字符串可读性
• 改善搜索插件在使用 --dirtyreload 时的稳定性
• 改善搜索结果组按钮，现在是粘性和稳定的
• 更新挪威语翻译
• 更新 MkDocs 到 1.4.2

移除

• 移除弃用的替代警告修饰符
• 移除输出中的 :is() 选择器以便于覆盖
• 移除翻译的 .title 后缀
• 移除在反馈 URL 中提供页面标题的遗留方法
• 移除仅索引标题的搜索支持
• 移除自定义搜索转换的支持
• 移除自定义搜索工作者的支持
• 移除临时雪花特性（复活节彩蛋）

修复

• 修复在公告栏存在时标签的渲染
• 修复标签插件渲染被其他插件排除的页面
• 修复 #5132：博客插件需要在 mkdocs.yml 中定义 nav 条目
• 修复 #5599：默认链接颜色对比度不足
• 修复 #5715：博客插件在分页中缺少集成目录
• 修复 #5806：某些 Android 设备上版本选择器无法悬停
• 修复 #5826：带标签的博客文章草稿出现在标签索引中

8.5.11 2022年11月30日¶

• 让它下雪，见 https://x.com/squidfunk/status/1597939243090788352

8.5.10 2022年11月11日¶

• 调整 CSS 以更好地允许自定义主色和强调色
• 修复 #4620：主色未应用（8.5.9 回归）

8.5.9 2022年11月8日¶

• 修复 #4600：黑色和白色主色的链接颜色不可读
• 修复 #4594：需要设置架构以更改链接颜色

8.5.8 2022年11月3日¶

• 添加始终显示设置的支持以获得 cookie 同意
• 修复 #4571：如果主色为 white 或 black，按钮不可见
• 修复 #4517：使用 slate 方案时序列图中的注释不可读

8.5.7 2022年10月22日¶

• 弃用额外的警告修饰符以减少 CSS 的大小
• 修复 #4511：搜索提升不适用于部分

8.5.6 2022年10月2日¶

• 现代化警告的外观（带回退，请参阅文档）
• 改善警告标题中内联代码块的外观

8.5.5 2022年10月1日¶

• 更新 MkDocs 到 1.4
• 修复与 MkDocs 1.4 的兼容性问题
• 修复 #4430：启用同意时构建错误

8.5.4 2022年9月30日¶

• 修复侧边栏溢出时的展开图标偏移（使用 scrollbar-gutter）
• 修复 #4429：序列图中的文本溢出

8.5.3 2022年9月20日¶

• 修复启用 cookie 同意时构建错误
• 修复 #4381：代码块为某些字体呈现连字

8.5.2 2022年9月18日¶

• 更新 Mermaid.js 到版本 9.1.7
• 修复过大标题在搜索结果中的渲染（8.5.0 回归）
• 修复 #4358：导航部分出现可点击（8.5.0 回归）

8.5.1 2022年9月15日¶

• 修复 #4366：移除具有本地扩展的依赖

8.5.0 2022年9月13日¶

• 添加社交卡的支持
• 添加代码注释锚链接（深层链接）的支持
• 添加代码注释评论剥离（语法修饰符）的支持
• 添加侧边栏自动滚动到活动项目的支持
• 添加目录中的锚点跟随支持（= 自动滚动）
• 添加标签图标的支持

8.4.4 2022年9月12日¶

• 将评论集成移至单独的部分（comments.html）

8.4.3 2022年9月7日¶

• 添加简单图标到捆绑图标（+2,300 个图标）
• 添加更改编辑图标的支持
• 将页面操作移至单独的部分（actions.html）
• 修复 #4291：版本切换时未保持在页面上
• 修复 #4327：数据表中的链接未接收链接样式

8.4.2 2022年8月27日¶

• 更新斯洛文尼亚语翻译
• 修复 #4277：使用即时加载时反馈小部件在导航后隐藏
• 修复前端元数据中的数字标签破坏搜索功能

8.4.1 2022年8月21日¶

• 更新克罗地亚语和希伯来语翻译

8.4.0 2022年8月13日¶

• 添加 cookie 同意的支持
• 添加反馈小部件的支持（此页面有帮助吗？）
• 添加可关闭的公告栏的支持
• 添加亚美尼亚语、立陶宛语、塔加洛语和乌尔都语翻译

8.3.9 2022年7月4日¶

• 更新台湾翻译以进行搜索
• 允许内容标签的 ID 包含特殊字符（用于 mkdocstrings）
• 修复 #4083：使用版本控制时主页不可点击

8.3.8 2022年6月24日¶

• 修复 #4053：限制视频宽度到内容区域
• 修复搜索中空标签破坏搜索

8.3.7 2022年6月22日¶

• 修复搜索在使用标签时卡住初始化的问题（8.3.4 回归）

8.3.6 2022年6月16日¶

• 修复 #4028：链接在使用版本控制时不可点击（8.3.5 回归）

8.3.5 2022年6月14日¶

• 修复 #4012：保持页面不变的功能未能正常工作

8.3.4 2022年6月11日¶

• 修复 #4004：标签中包含多个单词的搜索不可用

8.3.3 2022年6月7日¶

• 修复 #4000：Mermaid 图在深色模式下过暗（8.3.0 回归）

8.3.2 2022年6月5日¶

• 修复 #3987：自定义警告图标在定义颜色调色板时无法正常工作

8.3.1 2022年6月4日¶

• 将所需的 Jinja 版本提升到 3.0.2
• 移除模板中的不必要条件
• 修复内容标签可见时的滚动偏移
• 修复 #3977：内容标签在 Firefox 中奇怪地卡住
• 修复 #3983：页脚部分中的缺失条件（8.3.0 回归）

8.3.0 2022年6月2日¶

• 添加对自定义警告图标的支持
• 添加对内容标签链接的支持
• 添加对搜索中页面提升的支持
• 添加对隐藏页脚导航的支持
• 为内容标签添加前后指示器
• 改进浅色和深色模式下的排版链接颜色

8.2.16 2022年5月28日¶

• 修复 #3957：仅在可见时动画代码注释（节省 CPU 周期）

8.2.15 2022年5月14日¶

• 添加乌兹别克语翻译
• 修复内容标签中代码块结果的间距

8.2.14 2022年5月8日¶

• 修复警告上缺失的右上角圆角
• 修复 #3886：使用即时加载时未处理 4xx 状态代码

8.2.13 2022年5月2日¶

• 修复 #3865：标签索引链接到标记页面时出现 404
• 修复 #3866：将所需 Python 版本从 3.6+ 提升到 3.7+

8.2.12 2022年4月30日¶

• 添加对 GitHub 风格哈希片段的支持，以用于深色/亮色图像
• 改进嵌套代码块和注释的渲染
• 修复 #3862：升级到最新的 Pygments 和 Python Markdown 扩展

8.2.11 2022年4月25日¶

• 暂时将 Pygments 固定到 <2.12
• 暂时将 Python Markdown 扩展固定到 <9.4
• 改进代码注释标记的渲染

8.2.10 2022年4月24日¶

• 添加马其顿语翻译
• 更新 Mermaid.js 到版本 9.0.1
• 将移动导航中的侧边栏标题切换为粗体
• 修复深色模式下类图和状态图中的箭头颜色
• 修复 #3836：内联警告被代码块标题覆盖

8.2.9 2022年4月8日¶

• 减少调色板切换时的闪烁，通过禁用所有过渡
• 修复搜索建议在跟随深层链接时未触发
• 修复使用即时加载时计算的标题高度不正确
• 修复 #3782：在 Firefox 中宽屏上警告标题有额外像素
• 修复 #3802：始终渲染目录容器（除非隐藏）

8.2.8 2022年3月27日¶

• 提高 MkDocs 版本到 1.3.0，以减轻 Jinja 中的破坏性更改
• 恢复 Jinja 版本范围限制（在 8.2.7 中添加）
• 改进注释的样式并修复代码块的边框
• 为聚焦/悬停链接中的代码块添加背景颜色
• 在标签插件中检查标签概述页面是否存在
• 修复 #3744：使用后退按钮时内容标签指示器位置错误

8.2.7 2022年3月24日¶

• 暂时将 Jinja 版本范围限制为 < 3.1，由于破坏性更改

8.2.6 2022年3月23日¶

• 修复 #3695：模板中未转义的反斜杠的弃用警告
• 修复 #3696：某些 Terraform 代码块中未挂载的注释
• 修复 #3698：长代码块中未挂载的注释（8.2.5 回归）

8.2.5 2022年3月6日¶

• 修复 #3596：Mermaid 在存在名为 'Mermaid' 的标题时无法工作
• 修复 #3643：减少渲染数千个代码块的时间
• 修复 #3665：缺少 Mermaid.js 流程图集群标签的样式

8.2.4 2022年3月2日¶

• 修复格式错误的 Google Fonts URL，当省略字体设置时
• 修复 #3648：修复列表中的警告的特异性问题
• 修复 #3653：使用即时加载时过时版本横幅 URL 无效

8.2.3 2022年2月27日¶

• 修复 #3578：在大屏幕上活动元素的目录偏差

8.2.2 2022年2月26日¶

• 添加自动删除查询参数的支持，当搜索关闭时
• 修复 #3599：在使用导航跟踪时锚点始终被覆盖

8.2.1 2022年2月17日¶

• 修复模块 material.plugins 未找到（8.2.0 回归）

8.2.0 2022年2月17日¶

• 添加对 Mermaid.js 图表的原生支持
• 添加对标签的原生支持（带搜索集成）
• 添加对切换版本时保持在页面上的支持

8.1.11 2022年2月10日¶

• 添加葡萄牙语（巴西）翻译
• 更新 FontAwesome 到 v6 – 查看哪些图标在这里重命名
• 修复 #3545：调色板切换和搜索覆盖版本选择器

8.1.10 2022年2月6日¶

• 修复移动设备上非常宽的徽标被截断

8.1.9 2022年1月30日¶

• 添加对 mkdocs.yml 验证和自动完成的支持
• 修复拉脱维亚语翻译中的错误

8.1.8 2022年1月23日¶