变更日志¶

¥Changelog¶

MkDocs 内部人员的材料¶

¥Material for MkDocs Insiders¶

4.53.17 2025年8月22日¶

¥4.53.17 August 22, 2025¶

已修复#8408 ：自定义选择器的代码注释错误
¥Fixed #8408: Code annotations bug with custom selectors

4.53.16 2025年3月13日¶

¥4.53.16 March 13, 2025¶

已修复#8019 ：工具提示优先于即时预览
¥Fixed #8019: Tooltips have precedence over instant previews

4.53.15 2025年1月15日¶

¥4.53.15 January 15, 2025¶

已修复#7896 ：作用域标签列表未在小节中呈现
¥Fixed #7896: Scoped tags listings not rendering in subsections

4.53.14 2024年9月29日¶

¥4.53.14 September 29, 2024¶

已修复#7567 ：使用带有锚链接的排版插件时标题为空
¥Fixed #7567: Empty headlines when using typeset plugin with anchorlinks

4.53.13 2024年9月14日¶

¥4.53.13 September 14, 2024¶

已修复#7520 ：生成文件的社交插件错误（MkDocs 1.6+）
¥Fixed #7520: Social plugin errors for generated files (MkDocs 1.6+)

4.53.12 2024年8月2日¶

¥4.53.12 August 2, 2024¶

已修复#7410 ：即时预览通过锚链接跳转到内容选项卡
¥Fixed #7410: Instant previews jump on content tabs with anchor links
已修复#7408 ：即时预览跳转到内容选项卡
¥Fixed #7408: Instant previews jump on content tabs

4.53.11 2024年5月27日¶

¥4.53.11 May 27, 2024¶

修复了在构建子项目之前提供服务时项目插件崩溃的问题
¥Fixed projects plugin crashing when serving before building subprojects

4.53.10 2024年5月20日¶

¥4.53.10 May 20, 2024¶

修复了项目插件在服务模式下禁用时崩溃的问题
¥Fixed projects plugin crashing in serve mode when disabled
修复了构建嵌套项目时项目插件崩溃的问题
¥Fixed projects plugin crashing when building nested projects

4.53.9 2024年5月20日¶

¥4.53.9 May 20, 2024¶

已修复#7191 ：当toc_depth发生更改时，标签列表不会呈现
¥Fixed #7191: Tags listings not rendering when toc_depth is changed

4.53.8 2024年4月26日¶

¥4.53.8 April 26, 2024¶

已修复#7052 ：预览扩展自动包含所有页面
¥Fixed #7052: Preview extension automatically including all pages
已修复#7051 ：脚注引用上的即时预览安装
¥Fixed #7051: Instant previews mounting on footnote references
已修复#5165 ：改进的工具提示未安装在排版插件的侧边栏中
¥Fixed #5165: Improved tooltips not mounting in sidebar for typeset plugin

4.53.7 2024年4月25日¶

¥4.53.7 April 25, 2024¶

已修复#7060 ：使用 static-i18n 时翻译分辨率不正确
¥Fixed #7060: Incorrect resolution of translation when using static-i18n

4.53.6 2024年4月5日¶

¥4.53.6 April 5, 2024¶

确保使用项目插件时为项目设置工作目录
¥Ensure working directory is set for projects when using projects plugin
已修复#6970 ：带有项目插件的 git 子模块中的相对路径不正确
¥Fixed #6970: Incorrect relative paths in git submodules with projects plugin

4.53.5 2024年4月2日¶

¥4.53.5 April 2, 2024¶

修复了调色板中未指定颜色时社交插件崩溃的问题
¥Fixed social plugin crashing when no colors are specified in palettes

4.53.4 2024年3月31日¶

¥4.53.4 March 31, 2024¶

已修复#6973 ：标签额外文件弃用助手中的转义问题
¥Fixed #6973: Escaping issue in tags extra files deprecation helper

4.53.3 2024年3月23日¶

¥4.53.3 March 23, 2024¶

在社交插件中添加了对字体变体的支持
¥Added support for font variants in social plugin
提高了社交插件中字体分辨率的弹性
¥Improved resilience of font resolution in social plugin
修复标签列表有时无法自动填充的问题
¥Fixed tag listing sometimes not being auto-populated
修复标签列表范围未正确解析的问题
¥Fixed tag listing scope not being correctly resolved
已修复#6941 ：元插件添加重复条目
¥Fixed #6941: Meta plugin adding duplicate entries
已修复#6928 ：某些字体的社交插件崩溃
¥Fixed #6928: Social plugin crashes for some fonts

4.53.2 2024年3月18日¶

¥4.53.2 March 18, 2024¶

修复预览扩展中第一次配置不匹配时中止的问题
¥Fixed abort on first non-matching configuration in preview extension
已修复#6914 ：元文件优先于前言
¥Fixed #6914: Meta files take precedence over front matter

4.53.1 2024年3月6日¶

¥4.53.1 March 6, 2024¶

已修复#6877 ：项目插件计算错误的资产路径
¥Fixed #6877: Projects plugin computes incorrect path to assets
已修复#6869 ：博客插件应在无效的相关链接上发出警告
¥Fixed #6869: Blog plugin should emit warning on invalid related link

4.53.0 2024年2月24日¶

¥4.53.0 February 24, 2024¶

增加了对自动即时预览的支持
¥Added support for automatic instant previews
增加了对固定博客文章的支持
¥Added support for pinned blog posts

4.52.3 2024年2月21日¶

¥4.52.3 February 21, 2024¶

修复即时预览中 URL 的分辨率
¥Fixed resolution of URLs in instant previews
修复了同一页面链接无法安装即时预览的问题
¥Fixed instant previews not mounting for same-page links

4.52.2 2024年2月7日¶

¥4.52.2 February 7, 2024¶

已修复#6735 ：标签下方即时预览错位
¥Fixed #6735: Instant previews misplaced when below tabs

4.52.1 2024年1月30日¶

¥4.52.1 January 30, 2024¶

已修复#6705 ：指定时导航路径未被隐藏
¥Fixed #6705: Navigation path not being hidden when specified
已修复#6703 ：新标签插件在 Windows 上崩溃（第二次尝试）
¥Fixed #6703: New tags plugin crashes on Windows (2

4.52.0 2024年1月28日¶

¥4.52.0 January 28, 2024¶

增加了对即时预览的支持
¥Added support for instant previews
修复脚注工具提示定位边缘情况
¥Fixed footnote tooltips positioning edge cases
已修复#6703 ：新标签插件在 Windows 上崩溃
¥Fixed #6703: New tags plugin crashes on Windows

4.51.0 2024年1月24日¶

¥4.51.0 January 24, 2024¶

增加了对脚注工具提示的支持
¥Added support for footnote tooltips

4.50.0 2024 年 1 月 19 日¶

¥4.50.0 January 19, 2024¶

为隐私插件添加了可配置的日志记录功能
¥Added configurable logging capabilities to privacy plugin

4.49.2 2024年1月9日¶

¥4.49.2 January 9, 2024¶

修复了标签插件缺少的属性列表扩展
¥Fixed missing attribute lists extension for tags plugin
已修复#6627 ：新标签插件在 Python 3.8 上崩溃
¥Fixed #6627: New tags plugin crashes on Python 3.8

4.49.1 2024年1月7日¶

¥4.49.1 January 7, 2024¶

改进了新标签插件与其他插件的互操作性
¥Improved interop of new tags plugin with other plugins
已修复#6594 ：标签插件无法与 mkdocs-macros 插件配合使用
¥Fixed #6594: Tags plugin doesn't work with mkdocs-macros plugin
已修复#6569 ：如果位于不同的文件系统位置，社交插件会崩溃
¥Fixed #6569: Social plugin crashes if in different file system location

4.49.0 2023年12月29日¶

¥4.49.0 December 29, 2023¶

增加了对导出标签和映射的支持
¥Added support for exporting tags and mappings
增加了对禁用标签和/或列表或两者的支持
¥Added support for disabling tags and/or listings or both
修复了从页面到主页列表的标签链接
¥Fixed tag links from pages to listings on homepage

4.48.0 2023年12月23日¶

¥4.48.0 December 23, 2023¶

重写标签插件，现在功能更加强大
¥Rewrite of tags plugin, now much more powerful
增加了对嵌套标签（标签层次结构，例如 foo/bar）的支持
¥Added support for nested tags (tag hierarchies, e.g. foo/bar)
增加了对影子标签的支持（通过列表、前缀或后缀）
¥Added support for shadow tags (by list, prefix or suffix)
增加了对自定义标签布局和模板的支持
¥Added support for custom tag layouts and templates
增加了对隐藏目录中标签的支持
¥Added support for hiding tags in table of contents
增加了对可配置内联标签列表的支持
¥Added support for configurable inline tag listings
增加了自动链接到最近标签列表的支持
¥Added support for automatically linking to closest tag listing
增加了对范围列表的支持（限制在网站的子部分）
¥Added support for scoped listings (limit to subsection of site)
增加了对标签插件的多个实例的支持
¥Added support for multiple instances of tags plugin
增加了对更改前置属性和模板变量的支持
¥Added support for changing front matter property and template variable
增加了对标签 slugification 格式字符串的支持
¥Added support for tag slugification format strings
已修复#6510 ：Linux 上的项目插件内存不足（4.47.1 回归）
¥Fixed #6510: Projects plugin out of memory on Linux (4.47.1 regression)
修复项目插件不通知插件服务模式的问题
¥Fixed projects plugin not notifying plugins about serve mode
修复了项目插件在前缀匹配时跳过项目的问题
¥Fixed projects plugin skipping projects on prefix match
弃用 tags_file 和 tags_extra_files 设置
¥Deprecated tags_file and tags_extra_files settings
现代化的标签插件代码库
¥Modernized tags plugin code base

4.47.1 2023年12月11日¶

¥4.47.1 December 11, 2023¶

改进了项目插件的编辑体验
¥Improved editing experience for projects plugin
提高了优化和社交插件的弹性
¥Improved resilience of optimize and social plugin
修复了在优化和社交插件中写入清单时的竞争条件
¥Fixed race condition when writing manifest in optimize and social plugin
已修复#6475 ：社交卡中的徽标不优先于图标
¥Fixed #6475: Logo not taking precedence over icon in social card
已修复#6399 ：项目插件无法获取已添加/删除的项目
¥Fixed #6399: Projects plugin doesn't pick up added/removed projects
已修复#6306 ：项目插件缓存未正确更新
¥Fixed #6306: Projects plugin cache not correctly updated

4.47.0 2023年12月8日¶

¥4.47.0 December 8, 2023¶

增加了切换语言时停留在页面的支持
¥Added support for staying on page when switching languages
为项目插件添加了可配置的日志记录功能
¥Added configurable logging capabilities to projects plugin
删除了博客插件作者文件格式更改的临时警告
¥Removed temporary warning on blog plugin authors file format change
修复了项目插件在 Linux 系统上两次记录消息的问题
¥Fixed projects plugin logging messages twice on Linux systems
修复了项目插件试图提升不同主题的主题资产的问题
¥Fixed projects plugin trying to hoist theme assets of divergent themes
修复了优化插件和项目插件的兼容性
¥Fixed compatibility of optimize plugin and projects plugin
修复社交插件和项目插件的兼容性
¥Fixed compatibility of social plugin and projects plugin
已修复#6448 ：自定义 ID 的代码块的代码行选择出现问题
¥Fixed #6448: Code line selection broken for code blocks with custom ids
已修复#6437 ：项目插件因某些站点 URL 配置而崩溃
¥Fixed #6437: Projects plugin crashing for certain site URL configurations
已修复#6414 ：项目插件没有为来自项目的消息添加前缀
¥Fixed #6414: Projects plugin doesn't prefix messages coming from projects

4.46.0 2023年11月26日¶

¥4.46.0 November 26, 2023¶

在博客插件中添加了对作者资料的支持
¥Added support for author profiles in blog plugin
修复了自定义索引页产生两个导航项的问题（4.45.0 回归）
¥Fixed custom index pages yielding two navigation items (4.45.0 regression)

4.45.0 2023年11月24日¶

¥4.45.0 November 24, 2023¶

增加了按帖子数或自定义函数对博客类别进行排序的支持
¥Added support for sorting blog categories by post count or custom function
改进的标签插件默认生成支持 Unicode 的 slug
¥Improved tags plugin to generate Unicode-aware slugs by default
修复了博客插件中多个作者的不确定顺序
¥Fixed non-deterministic order of multiple authors in blog plugin

4.44.0 2023年11月23日¶

¥4.44.0 November 23, 2023¶

在博客插件中添加了存档页面的分页设置
¥Added pagination settings for archive pages in blog plugin
在博客插件中添加了类别页面的分页设置
¥Added pagination settings for category pages in blog plugin

4.43.1 2023年11月19日¶

¥4.43.1 November 19, 2023¶

在项目插件中添加了第三方主题支持，改进了编辑功能
¥Added third-party theme support in projects plugin, improving editing
已修复#6360 ：当主题不是 MkDocs 的 Material 时，项目插件崩溃
¥Fixed #6360: Projects plugin crashes when theme is not Material for MkDocs
已修复#6306 ：项目插件未重新加载嵌套项目配置
¥Fixed #6306: Projects plugin not reloading nested project configuration

4.43.0 2023年11月5日¶

¥4.43.0 November 5, 2023¶

增加了对 GitLab 提交者（文档贡献者）的支持
¥Added support for GitLab committers (document contributors)
已修复#6264 ：修复与 Python <3.10 的兼容性
¥Fixed #6264: Fixed compatibility with Python < 3.10
已修复#6254 ：元插件未将元文件应用于博客文章
¥Fixed #6254: Meta plugin not applying meta files to blog posts

4.42.3 2023年10月27日¶

¥4.42.3 October 27, 2023¶

已修复#6251 ：网格中的卡片在非常小的屏幕上被截断
¥Fixed #6251: Cards in grids cut off on very small screens
已修复#6241 ：使用社交插件+static-i18n插件错误
¥Fixed #6241: Using social plugin + static-i18n plugin errors

4.42.2 2023年10月14日¶

¥4.42.2 October 14, 2023¶

已修复#6186 ：隐私插件忽略图像上的哈希片段
¥Fixed #6186: Privacy plugin ignores hash fragments on images
已修复#6180 ：添加或删除文件时项目插件崩溃
¥Fixed #6180: Projects plugin crashing when adding or removing files

4.42.1 2023年10月5日¶

¥4.42.1 October 5, 2023¶

修复了小屏幕上博客文章中相关链接的间距
¥Fixed spacing of related links in blog posts on small screens

4.42.0 2023年9月19日¶

¥4.42.0 September 19, 2023¶

增加了在项目插件中使用 git 子模块的支持
¥Added support for using git submodules in projects plugin
增加了对转换项目配置的支持
¥Added support for transforming project configurations
提高了优化和博客插件的弹性
¥Improved resilience of optimize and blog plugin
修复了优化插件在.jpeg扩展名上崩溃的问题
¥Fixed optimize plugin crashing on .jpeg extension
修复了项目插件中不使用站点 URL 的项目 URL
¥Fixed project URLs not using site URLs in projects plugin

4.41.0 2023年9月11日¶

¥4.41.0 September 11, 2023¶

改进了优化插件的多实例支持
¥Improved multi-instance support for optimize plugin
为优化插件添加了包含和排除模式
¥Added inclusion and exclusion patterns for optimize plugin
在社交插件中添加了用于颜色处理的透明关键字
¥Added transparent keyword for color handling in social plugin
在优化插件中将 PNG 的默认质量更改为 3
¥Changed default quality of PNGs to 3 in optimize plugin
已修复#5979 ：在文档目录的根目录中未检测到元文件
¥Fixed #5979: meta file not detected in root of docs directory

4.40.4 2023年9月4日¶

¥4.40.4 September 4, 2023¶

修复隐私插件因布尔 HTML5 属性而阻塞的问题
¥Fixed privacy plugin choking on boolean HTML5 attributes
修复了排版目录中内联代码块的换行问题
¥Fixed wrapping of inline code blocks in typeset table of contents
修复了在脏重载下运行时博客插件的错误
¥Fixed blog plugin error when running under dirty reload

4.40.3 2023年9月2日¶

¥4.40.3 September 2, 2023¶

已修复#5946 ：Docker 镜像缺少用于优化插件的 pngquant
¥Fixed #5946: Docker image missing pngquant for optimize plugin

4.40.2 2023年8月31日¶

¥4.40.2 August 31, 2023¶

为社交插件添加了可配置的错误处理功能
¥Added configurable error handling capabilities for social plugin
已修复#5922 ：博客插件在构建独立博客时不显示任何帖子
¥Fixed #5922: Blog plugin shows no posts when building a standalone blog
已修复#5914 ：标签插件tags_extra_files错误（4.39.3回归）
¥Fixed #5914: Tags plugin tags_extra_files errors (4.39.3 regression)
已修复#5904 ：博客插件有时会排除文件（4.40.1 回归）
¥Fixed #5904: Blog plugin sometimes excludes files (4.40.1 regression)

4.40.1 2023年8月27日¶

¥4.40.1 August 27, 2023¶

已修复#5902 ：隐私插件未检测到 ResizeObserver polyfill
¥Fixed #5902: ResizeObserver polyfill not detected by privacy plugin
修复博客插件中的空类别页面（4.40.0 回归）
¥Fixed empty category pages in blog plugin (4.40.0 regression)

4.40.0 2023年8月26日¶

¥4.40.0 August 26, 2023¶

在社交插件默认布局中添加了徽标、标题和描述选项
¥Added logo, title and description options to social plugin default layouts
修复了隐私插件与 Python < 3.10 的兼容性问题
¥Fixed privacy plugin compatibility issue with Python < 3.10
已修复#5896 ：使用自定义索引页时博客插件出现错误
¥Fixed #5896: Blog plugin errors when using custom index pages

4.39.3 2023年8月24日¶

¥4.39.3 August 24, 2023¶

修复了 Docker 容器中缺少的 lxml 依赖项（4.39.2 回归）
¥Fixed lxml dependency missing in Docker container (4.39.2 regression)

4.39.2 2023年8月23日¶

¥4.39.2 August 23, 2023¶

修复调色板切换被反转的问题（9.2.0 回归）
¥Fixed color palette toggle being reversed (9.2.0 regression)

4.39.1 2023年8月21日¶

¥4.39.1 August 21, 2023¶

合并 9.2.0 更改后修复标签插件中的 git diff
¥Fixed git diff in tags plugin after merging back 9.2.0 changes

4.39.0 2023年8月3日¶

¥4.39.0 August 3, 2023¶

增加了在构建项目时提升主题媒体文件的支持
¥Added support for hoisting theme media files when building projects
增加了对标签插件的标签索引页面排序的支持
¥Added support for sorting pages on tags index for tags plugin
增加了对博客文章添加最后更新日期的支持
¥Added support for adding date of last update to blog posts
已修复#5797 ：排版插件中的解析错误（4.38.1 回归）
¥Fixed #5797: Parse error in typeset plugin (4.38.1 regression)

4.38.1 2023年8月1日¶

¥4.38.1 August 1, 2023¶

改进了项目插件的嵌套服务模式
¥Improved nested serve mode for projects plugin
改进了隐私插件与第三方插件的兼容性
¥Improved compat in privacy plugin with third-party plugins
已修复#5790 ：Typeset 插件忽略 data-toc-label 属性
¥Fixed #5790: Typeset plugin ignores data-toc-label attribute
已修复#5778 ：隐私插件与 git-revision-date-localized 的相互作用
¥Fixed #5778: Interplay of privacy plugin with git-revision-date-localized
已修复#5773 ：社区版处于测试阶段时信息插件出错
¥Fixed #5773: Info plugin erroring when community edition is in beta

4.38.0 2023年7月29日¶

¥4.38.0 July 29, 2023¶

添加了用于构建嵌套项目的项目插件
¥Added projects plugin for building nested projects
更新隐私插件至新的 MkDocs API
¥Updated privacy plugin to new MkDocs API

4.37.1 2023年7月28日¶

¥4.37.1 July 28, 2023¶

更新 MkDocs 至 1.5.1
¥Updated MkDocs to 1.5.1
修复了由于 MkDocs 升级导致的社交插件弃用警告
¥Fixed deprecation warning in social plugin due to MkDocs upgrade
已修复#5772 ：由于 MkDocs 中的 API 更改，隐私插件失败
¥Fixed #5772: Privacy plugin fails due to API change in MkDocs

4.37.0 2023年7月7日¶

¥4.37.0 July 7, 2023¶

增加了对每页覆盖社交卡设置的支持
¥Added support for overriding social cards settings per page
添加了新的社交卡default/only/image布局
¥Added new social card default/only/image layout
提高了优化和社交插件的弹性
¥Improved resilience of optimize and social plugin
修复了修剪导航项目的渲染错误
¥Fixed rendering bugs for pruned navigation items
修复了启用即时加载时内容标签锚链接跳转的问题
¥Fixed jumping of content tabs anchor links when instant loading is enabled
已修复#5676 ：优化插件不检查pngquant
¥Fixed #5676: Optimize plugin doesn't check for pngquant

4.36.1 2023年6月23日¶

¥4.36.1 June 23, 2023¶

已修复#5618 ：博客插件中草稿的日期比较中断
¥Fixed #5618: Date comparison breaking for drafts in blog plugin

4.36.0 2023年6月15日¶

¥4.36.0 June 15, 2023¶

增加了对即时预取的支持，以加快慢速连接
¥Added support for instant prefetching to speed up slow connections
提高了内置排版插件中锚链接删除的稳定性
¥Improved stability of anchor link removal in built-in typeset plugin
改进了排版插件中正则表达式的性能
¥Improved performance of regular expressions in typeset plugin
删除了优化插件中不必要的cairosvg导入测试
¥Removed unnecessary import test for cairosvg in optimize plugin
已修复#5590 ：删除锚链接的正则表达式过于贪婪
¥Fixed #5590: Regular expression for anchor link removal too greedy

4.35.3 2023年6月1日¶

¥4.35.3 June 1, 2023¶

已修复#5579 ：标题中的缩写被排版插件过滤
¥Fixed #5579: Abbreviations in headlines filtered by typeset plugin

4.35.2 2023年5月29日¶

¥4.35.2 May 29, 2023¶

已修复#5555 ：计算表情符号的读取时间时，博客插件崩溃
¥Fixed #5555: Blog plugin crashes when computing readtime for emojis

4.35.1 2023年5月20日¶

¥4.35.1 May 20, 2023¶

修复了社交插件内部错误的处理
¥Fixed internal handling of errors in social plugin

4.35.0 2023年5月20日¶

¥4.35.0 May 20, 2023¶

改善社交插件的编辑体验和稳定性
¥Improve editing experience and stability of social plugin
在社交插件中添加了对自定义布局语法验证的支持
¥Added support for custom layout syntax validation in social plugin
增加了对图层原点的支持，以便更轻松地放置在社交插件中
¥Added support for layer origin for easier placement in social plugin
增加了对社交插件中的进入和排除模式的支持
¥Added support for in- and exclusion patterns in social plugin
捕获并打印自定义布局中的语法错误
¥Catch and print syntax errors in custom layouts

4.34.1 2023年5月16日¶

¥4.34.1 May 16, 2023¶

在 mkdocs 构建时默认禁用社交插件调试模式
¥Disable social plugin debug mode by default on mkdocs build
在社交插件调试模式下找不到字体样式时添加警告
¥Added warning in social plugin debug mode when font style couldn't be found
设置内置多线程插件默认并发数为 CPU - 1
¥Set default concurrency of built-in multi-threaded plugins to CPUs - 1
已修复#5521 ：社交插件在下载字体时触发竞争条件
¥Fixed #5521: Social plugin triggers race condition when downloading fonts
已修复#5515 ：当并发设置为 1 时，社交插件崩溃
¥Fixed #5515: Social plugin crashes when concurrency is set to 1

4.34.0 2023年5月14日¶

¥4.34.0 May 14, 2023¶

增加了对社交插件中自动调整文本的新溢出模式的支持
¥Added support for new overflow mode to auto-fit text in social plugin
减少了由于子像素舍入而导致的（代码）注释中的细微渲染错误
¥Reduced subtle rendering bugs in (code) annotations due to subpixel rounding
改进了（代码）注释列表的打印样式
¥Improved print styles for (code) annotation lists
社交插件性能提升，速度提升 3 倍
¥Improved performance of social plugin, now 3x as fast
改进了排版插件与 MkDocstrings 的互操作性
¥Improved interop of typeset plugin with MkDocstrings
修复了社交插件中默认模板变体的徽标位置
¥Fixed logo location for variants of default template in social plugin
已修复#5446 ：内置排版插件拾取代码块中的标题
¥Fixed #5446: Built-in typeset plugin picks up headings in code blocks

4.33.2 2023年5月12日¶

¥4.33.2 May 12, 2023¶

已修复#5508 ：社交插件在 Docker/Windows 上尝试复制卡片时崩溃
¥Fixed #5508: Social plugin crashes trying to copy cards on Docker/Windows
已修复#5507 ：当布局文件夹不存在时，社交插件在服务上崩溃
¥Fixed #5507: Social plugin crashes on serve when layouts folder doesn't exist
已修复#5505 ：社交插件尝试解析错误位置的徽标
¥Fixed #5505: Social plugin trying to resolve logo in wrong location
已修复#5496 ：嵌套列表的注释安装不正确
¥Fixed #5496: Annotations with nested lists incorrectly mounted
已修复#5493 ：社交插件在 Python 3.8 上崩溃
¥Fixed #5493: Social plugin crashes on Python 3.8

4.33.1 2023年5月9日¶

¥4.33.1 May 9, 2023¶

在社交插件中添加了对 SVG 背景图像的支持
¥Added support for SVG background images in social plugin

4.33.0 2023年5月8日¶

¥4.33.0 May 8, 2023¶

增加了对社交插件自定义布局的支持
¥Added support for custom layouts for social plugin
增加了对社交卡片背景图片的支持
¥Added support for background images for social cards

4.32.6 2023年4月22日¶

¥4.32.6 April 22, 2023¶

已修复#5336 ：博客插件与 git-revision-date-localized 的相互作用
¥Fixed #5336: Interplay of blog plugin with git-revision-date-localized

4.32.5 2023年4月7日¶

¥4.32.5 April 7, 2023¶

已修复#5322 ：导航选项卡提升嵌套页面图标
¥Fixed #5322: Navigation tabs hoist nested page icons

4.32.4 2023年3月24日¶

¥4.32.4 March 24, 2023¶

已修复#5241 ：内置排版插件堵塞了标题中锚点的导航
¥Fixed #5241: Built-in typeset plugin jams navigation for anchors in headings

4.32.3 2023年3月9日¶

¥4.32.3 March 9, 2023¶

修复了 Docker 镜像发布工作流程（9.1.0 回归）
¥Fixed Docker image release workflow (9.1.0 regression)
已修复#5159 ：缩写缺少下划线（9.1.0 回归）
¥Fixed #5159: Missing underline for abbreviations (9.1.0 regression)

4.32.2 2023年2月23日¶

¥4.32.2 February 23, 2023¶

已修复#5127 ：隐私插件无法处理大量事件
¥Fixed #5127: Privacy plugin not handling large number of occurrences
已修复#5126 ：更换特定表情符号时隐私插件会中断
¥Fixed #5126: Privacy plugin breaks when replacing specific emojis

4.32.1 2023年2月23日¶

¥4.32.1 February 23, 2023¶

修复代码块跨度干扰复制的问题
¥Fixed code block spans interfering with copying
已修复#5077 ：隐私插件破坏了图像alt文本编码
¥Fixed #5077: Privacy plugin breaks image alt text encoding
已修复#5079 ：隐私插件删除外部链接上的rel=me
¥Fixed #5079: Privacy plugin removing rel=me

4.32.0 2023年2月19日¶

¥4.32.0 February 19, 2023¶

增加了对代码注释自定义选择器的支持
¥Added support for custom selectors for code annotations
增加了对代码行范围选择的支持，以便更好地共享
¥Added support for code line range selection for better sharing

4.31.0 2023年2月18日¶

¥4.31.0 February 18, 2023¶

增加了对博客索引和存档页面目录的支持
¥Added support for table of contents on blog index and archive pages
已修复#4512 ：允许自定义搜索字段提升（实验性）
¥Fixed #4512: Allow custom search field boosts (experimental)

4.30.2 2023年2月13日¶

¥4.30.2 February 13, 2023¶

修复隐私插件排除不起作用的问题（4.30.0 回归）
¥Fixed privacy plugin excludes not working (4.30.0 regression)

4.30.1 2023年2月12日¶

¥4.30.1 February 12, 2023¶

修复隐私插件不处理静态模板（例如404.html ）的问题
¥Fixed privacy plugin not handling static templates (e.g. 404.html)

4.30.0 2023年2月6日¶

¥4.30.0 February 6, 2023¶

重写隐私插件以实现并发，速度现在提高了两倍
¥Rewrite of privacy plugin for concurrency, now twice as fast
增加了对隐私插件的明确包含的支持
¥Added support for explicit inclusion for privacy plugin
增加了对隐私插件的优化支持（+优化插件）
¥Added optimization support for privacy plugin (+ optimize plugin)

4.29.0 2023年1月21日¶

¥4.29.0 January 21, 2023¶

添加了内置优化插件，用于自动压缩图像
¥Added built-in optimize plugin for automatically compressing images
将内置隐私插件中的报告切换至info级别
¥Switched reporting in built-in privacy plugin to info level

4.28.1 2023年1月17日¶

¥4.28.1 January 17, 2023¶

修复了内部人员在版本检查时出现的内置信息插件错误
¥Fixed built-in info plugin erroring for Insiders on version check
修复#4865 ：当没有顶级部分时，导航路径呈现错误
¥Fixed #4865: Navigation paths render bug when there's no top-level section
已修复#4875 ：增加了对隐藏导航路径的支持
¥Fixed #4875: Added support for hiding navigation paths
改进导航路径，不再渲染单个项目
¥Improved navigation path to not render for a single item

4.28.0 2023年1月14日¶

¥4.28.0 January 14, 2023¶

增加了对导航路径（面包屑）的支持
¥Added support for navigation path (breadcrumbs)

4.27.1 2022年12月20日¶

¥4.27.1 December 20, 2022¶

修复了排版插件中后续导航项的渲染
¥Fixed rendering of succeeding navigation items in typeset plugin
已修复#4795 ：内置排版插件更改 MkDocs 的标题优先级
¥Fixed #4795: Built-in typeset plugin changes MkDocs' title precedence
已修复#4724 ：博客插件无法渲染集成目录
¥Fixed #4724: Blog plugin not rendering integrate table of contents

4.27.0 2022 年 12 月 20 日¶

¥4.27.0 December 20, 2022¶

添加了内置排版插件以保留侧边栏的格式
¥Added built-in typeset plugin to preserve formatting in sidebars
增加了对博客类别的 URL 和目录支持
¥Added URL and table of contents support for blog categories

4.26.6 2022年11月28日¶

¥4.26.6 November 28, 2022¶

已修复#4683 ：当标签为空时，标签插件崩溃
¥Fixed #4683: Tags plugin crashes when a tag is empty

4.26.5 2022年11月27日¶

¥4.26.5 November 27, 2022¶

已修复#4632 ：文章摘录标题链接未指向页面顶部
¥Fixed #4632: Post excerpt title link doesn't point to top of the page

4.26.4 2022年11月27日¶

¥4.26.4 November 27, 2022¶

修复使用隐私插件时冗余文件扩展名的问题
¥Fixed redundant file extension when using privacy plugin

4.26.3 2022年11月15日¶

¥4.26.3 November 15, 2022¶

已修复#4637 ：博客插件中相关链接中附件无标题的错误
¥Fixed #4637: Attachments w/o titles in related links error in blog plugin
已修复#4631 ：隐私插件未下载和内联远程图标
¥Fixed #4631: Remote favicons not downloaded and inlined by privacy plugin

4.26.2 2022年11月3日¶

¥4.26.2 November 3, 2022¶

更新 MkDocs 至 1.4.2
¥Updated MkDocs to 1.4.2
增加了对索引页排序时标签比较功能的支持
¥Added support for tag compare functions when sorting on index pages
修复了在文章摘录中呈现的脚注没有分隔符的问题
¥Fixed footnotes being rendered in post excerpts without separators
修复了未启用toc扩展时博客插件出现的错误
¥Fixed error in blog plugin when toc extension is not enabled
修复了无效资产路径和链接帖子标题的问题
¥Fixed issues with invalid asset paths and linked post titles
已修复#4572 ：无法创建符号链接时隐私插件失败
¥Fixed #4572: Privacy plugin fails when symlinks cannot be created
已修复#4545 ：博客插件不会自动将标题链接到帖子
¥Fixed #4545: Blog plugin doesn't automatically link headline to post
已修复#4542 ：博客插件不允许多个实例
¥Fixed #4542: Blog plugin doesn't allow for multiple instances
已修复#4532 ：博客插件不允许混合使用日期和日期时间
¥Fixed #4532: Blog plugin doesn't allow for mixed use of date and datetime

4.26.1 2022年10月22日¶

¥4.26.1 October 22, 2022¶

改进了标签插件中配置错误的报告
¥Improved reporting of configuration errors in tags plugin
已修复#4515 ：当未定义站点 URL 时，隐私插件失败
¥Fixed #4515: Privacy plugin fails when site URL is not defined
已修复#4514 ：隐私插件无法获取 Google 字体（4.26.0 回归）
¥Fixed #4514: Privacy plugin doesn't fetch Google fonts (4.26.0 regression)

4.26.0 2022年10月18日¶

¥4.26.0 October 18, 2022¶

重构隐私插件以准备新功能
¥Refactored privacy plugin to prepare for new features
在隐私插件中添加了对rel=noopener链接的支持
¥Added support for rel=noopener links in privacy plugin
解决博客和隐私插件的编码问题
¥Resolve encoding issues with blog and privacy plugin

4.25.5 2022年10月16日¶

¥4.25.5 October 16, 2022¶

更新 MkDocs 至 1.4.1
¥Updated MkDocs to 1.4.1
为内置插件添加了命名空间前缀
¥Added namespace prefix to built-in plugins
更新了部分content和header
¥Updated content and header

4.25.4 2022年10月9日¶

¥4.25.4 October 9, 2022¶

修复了独立博客的其他路径问题（4.24.2 回归）
¥Fixed other path issues for standalone blogs (4.24.2 regression)

4.25.3 2022年10月9日¶

¥4.25.3 October 9, 2022¶

已修复#4457 ：未收集独立博客的帖子（4.24.2 回归）
¥Fixed #4457: Posts not collected for standalone blog (4.24.2 regression)

4.25.2 2022年10月4日¶

¥4.25.2 October 4, 2022¶

修复#4452 ：指定 slugify 函数时博客和标签插件崩溃
¥Fixed #4452: Blog and tags plugin crash when specifying slugify function

4.25.1 2022年10月3日¶

¥4.25.1 October 3, 2022¶

更新了Dockerfile中的mkdocs-rss-plugin ，以修复 MkDocs 兼容错误
¥Updated mkdocs-rss-plugin in Dockerfile to fix MkDocs compat errors

4.25.0 2022年10月2日¶

¥4.25.0 October 2, 2022¶

增加了对导航字幕的支持
¥Added support for navigation subtitles
增加了对定义内置标签插件允许列表的支持
¥Added support for defining an allow list for built-in tags plugin
增加了对内置标签插件的自定义 slugify 函数的支持
¥Added support for custom slugify functions for built-in tags plugin
使用--dirtyreload时提高了搜索插件的稳定性
¥Improved stability of search plugin when using --dirtyreload

4.24.2 2022年10月1日¶

¥4.24.2 October 1, 2022¶

更新 MkDocs 至 1.4
¥Updated MkDocs to 1.4
修复了与 MkDocs 1.4 的兼容性问题
¥Fixed compatibility issues with MkDocs 1.4
修复了隐私插件中错误生成的路径
¥Fixed incorrectly generated paths in privacy plugin
修复使用元插件时博客索引页不显示导航的问题
¥Fixed blog index page not showing navigation when using meta plugin

4.24.1 2022年9月30日¶

¥4.24.1 September 30, 2022¶

已修复#4430 ：在没有存储库 URL 的情况下启用同意时出现构建错误
¥Fixed #4430: build error when enabling consent without repository URL

4.24.0 2022 年 9 月 27 日¶

¥4.24.0 September 27, 2022¶

增加了对索引页（博客）上自定义内容的支持
¥Added support for custom content on index pages (blog)
增加了对在分页索引页上保留内容的支持（博客）
¥Added support for keeping content on paginated index pages (blog)
增加了对文章摘录中限制类别的支持（博客）
¥Added support for limiting categories in post excerpts (blog)
增加了通过前端内容简单覆盖模板的支持（博客）
¥Added support for simple override of templates via front matter (blog)
在包含加密内容的页面导航中添加图标
¥Added icon in navigation for pages with encrypted content
已修复#4396 ：索引页的封面内容未被分页继承（博客）
¥Fixed #4396: Front matter of index pages not inherited by pagination (blog)
通过一次性构建帖子摘录来提高性能（博客）
¥Improved performance by building post excerpts once (blog)

4.23.6 2022年9月22日¶

¥4.23.6 September 22, 2022¶

已修复#4389 ：一年中第一周的博客文章存档错误
¥Fixed #4389: Blog posts in first week of year in wrong archive
已修复（= 已切换）博客文章页脚上的上一个和下一个链接
¥Fixed (= switched) footer previous and next links for blog posts

4.23.5 2022年9月18日¶

¥4.23.5 September 18, 2022¶

已修复#4367 ：改进了 MultiMarkdown 语法的博客插件日期处理
¥Fixed #4367: Improved blog plugin date handling for MultiMarkdown syntax
已修复#4374 ：修复了其他博客文章相关链接的无效 URL
¥Fixed #4374: Fixed invalid URLs of related links to other blog posts

4.23.4 2022年9月14日¶

¥4.23.4 September 14, 2022¶

已修复#4365 ：由于deepcopy导致博客插件出现递归错误
¥Fixed #4365: Recursion error in blog plugin due to deepcopy
修复 Windows 上博客插件的路径错误
¥Fixed path errors for blog plugin on Windows
修复了分叉存储库中的发布工作流程
¥Fixed publishing workflow in forked repositories

4.23.3 2022年9月13日¶

¥4.23.3 September 13, 2022¶

修复了博客文章草稿的上一页和下一页链接
¥Fixed previous and next page links for drafts of blog posts

4.23.2 2022年9月13日¶

¥4.23.2 September 13, 2022¶

已修复#4348 ：博客插件在自定义nav标题上崩溃
¥Fixed #4348: Blog plugin crashes on custom nav title
修复了当类别仅包含草稿时博客插件崩溃的问题
¥Fixed blog plugin crashing when category contained only drafts
修复了博客索引文件内容的渲染
¥Fixed rendering of content from blog index file

4.23.1 2022年9月12日¶

¥4.23.1 September 12, 2022¶

已修复#4345 ：博客插件默认设置错误
¥Fixed #4345: Blog plugin errors with default settings

4.23.0 2022 年 9 月 12 日¶

¥4.23.0 September 12, 2022¶

通过内置博客插件添加博客支持
¥Added blogging support via built-in blog plugin

4.22.1 2022年9月7日¶

¥4.22.1 September 7, 2022¶

已修复#4217 ：数据表中的工具提示渲染位置错误
¥Fixed #4217: Tooltips in data tables render in wrong position

4.22.0 2022 年 8 月 21 日¶

¥4.22.0 August 21, 2022¶

增加了对导航状态的支持
¥Added support for navigation status

4.21.1 2022年8月13日¶

¥4.21.1 August 13, 2022¶

已修复#4176 ：当头像由 Gravatar 提供时，图像损坏
¥Fixed #4176: Broken image when avatar is served by Gravatar
已修复#4212 ：file:// 位置的延迟搜索初始化
¥Fixed #4212: Deferred search initialization for file:// locations

4.21.0 2022 年 7 月 17 日¶

¥4.21.0 July 17, 2022¶

添加元插件：为文件夹中的所有页面设置封面
¥Added meta plugin: set front matter for all pages in a folder
已修复#4114 ：如果仅设置了tags_extra_files ，则标签插件会失败
¥Fixed #4114: Tags plugin fails if only tags_extra_files is set

4.20.1 2022年7月11日¶

¥4.20.1 July 11, 2022¶

已修复#4105 ：如果未设置tags_file ，则标签插件失败（4.20.0 回归）
¥Fixed #4105: Tags plugin fails if tags_file is not set (4.20.0 regression)

4.20.0 2022 年 7 月 7 日¶

¥4.20.0 July 7, 2022¶

增加了对附加标签索引的支持
¥Added support for additional tags indexes
已修复#4100 ：标签图标未显示在标签索引中
¥Fixed #4100: Tag icons not shown in tags index

4.19.2 2022年7月4日¶

¥4.19.2 July 4, 2022¶

已修复#4051 ：如果 Windows 上不允许符号链接，隐私插件将失败
¥Fixed #4051: Privacy plugin fails if symlinking isn't allowed on Windows

4.19.1 2022年6月25日¶

¥4.19.1 June 25, 2022¶

将mkdocs-git-committers-plugin添加到 Dockerfile
¥Added mkdocs-git-committers-plugin to Dockerfile
将mkdocs-git-revision-date-localized-plugin添加到 Dockerfile
¥Added mkdocs-git-revision-date-localized-plugin to Dockerfile

4.19.0 2022 年 6 月 24 日¶

¥4.19.0 June 24, 2022¶

增加了对文档贡献者的支持
¥Added support for document contributors
更新了 Cookie 同意的法语翻译
¥Updated French translations for cookie consent

4.18.2 2022年6月16日¶

¥4.18.2 June 16, 2022¶

已修复#4026 ：修复了嵌套导航链接未安装的工具提示
¥Fixed #4026: Fixed tooltips not mounted for nested navigation links

4.18.1 2022年6月14日¶

¥4.18.1 June 14, 2022¶

已修复#3990 ：中文搜索突出显示在非边界上不起作用
¥Fixed #3990: Chinese search highlighting not working on non-boundaries

4.18.0 2022 年 6 月 11 日¶

¥4.18.0 June 11, 2022¶

增加了对自动暗/亮模式的支持
¥Added support for automatic dark/light mode
已修复#4009 ：隐私插件在 Windows 上使用无效路径进行文件缓存
¥Fixed #4009: Privacy plugin uses invalid paths for file cache on Windows

4.17.2 2022年6月5日¶

¥4.17.2 June 5, 2022¶

增加了对自定义jieba词典（中文搜索）的支持
¥Added support for custom jieba dictionaries (Chinese search)

4.17.1 2022年6月5日¶

¥4.17.1 June 5, 2022¶

增加了对 Cookie 同意拒绝按钮的支持
¥Added support for cookie consent reject button
增加了对 Cookie 同意自定义按钮排序的支持
¥Added support for cookie consent custom button ordering
已修复#3988 ：交替锚链接后内容选项卡未聚焦
¥Fixed #3988: Content tab not focused after alternating anchor links

4.17.0 2022 年 6 月 4 日¶

¥4.17.0 June 4, 2022¶

增加了对内容标签锚链接（深层链接）的支持
¥Added support for content tabs anchor links (deep linking)
修复#3975 ：检测搜索界面中的构图事件（中文）
¥Fixed #3975: Detect composition events in search interface (Chinese)
已修复#3980 ：搜索插件不使用通过前置内容设置的标题
¥Fixed #3980: Search plugin doesn't use title set via front matter

4.16.2 2022年5月29日¶

¥4.16.2 May 29, 2022¶

已修复#3961 ：嵌套部分触发导航选项卡的构建错误
¥Fixed #3961: Nested sections triggered build error for navigation tabs

4.16.1 2022年5月28日¶

¥4.16.1 May 28, 2022¶

将反馈小部件评级标题切换为工具提示
¥Switched feedback widget rating titles to tooltips
改进了明暗配色方案的链接颜色对比度
¥Improved contrast of link colors for light/dark color schemes
已修复#3950 ：粘性导航标签渲染损坏（4.15.2 回归）
¥Fixed #3950: Sticky navigation tabs rendering broken (4.15.2 regression)
修复#3958 ：使用white原色时链接不可见
¥Fixed #3958: Links invisible when using white primary color

4.16.0 2022年5月25日¶

¥4.16.0 May 25, 2022¶

增加了对导航修剪的支持
¥Added support for navigation pruning
修复非分段字符的搜索结果（4.15.2 回归）
¥Fixed search results for non-segmented characters (4.15.2 regression)

4.15.2 2022年5月22日¶

¥4.15.2 May 22, 2022¶

删除了触摸设备上abbr的解决方法（由工具提示取代）
¥Removed workaround for abbr on touch devices (superseded by tooltips)
修复#3915 ：改进中文搜索查询分割
¥Fixed #3915: Improved Chinese search query segmentation
已修复#3938 ：修复了带有省略号的导航标题的工具提示位置
¥Fixed #3938: Fixed tooltips position for navigation titles with ellipsis

4.15.1 2022年5月14日¶

¥4.15.1 May 14, 2022¶

改进元素焦点可观测数据的性能
¥Improved performance of element focus observables
已修复#3531 ：在内容选项卡中添加了上一个/下一个按钮
¥Fixed #3531: Added prev/next buttons to content tabs
修复了主机元素隐藏时的工具提示定位问题
¥Fixed tooltip positioning when host element is hidden

4.15.0 2022 年 5 月 8 日¶

¥4.15.0 May 8, 2022¶

增加了对改进工具提示的支持
¥Added support for improved tooltips
已修复#3785 ：悬停时显示溢出导航链接的工具提示
¥Fixed #3785: Show tooltip on hover for overflowing navigation link

4.14.0 2022年5月5日¶

¥4.14.0 May 5, 2022¶

为内置搜索插件添加了中文支持
¥Added Chinese language support to built-in search plugin
修复了社交插件中全数字页面标题引发的错误
¥Fixed all-numeric page titles raising error in social plugin

4.13.2 2022年4月30日¶

¥4.13.2 April 30, 2022¶

改进了隐私插件中下载资源的缓存
¥Improved caching of downloaded resources in privacy plugin
已修复#3851 ：隐私插件未下载外部图像
¥Fixed #3851: External images not downloaded by privacy plugin

4.13.1 2022年4月25日¶

¥4.13.1 April 25, 2022¶

已修复#3839 ：标签插件在没有图标的情况下中断（4.13.0 回归）
¥Fixed #3839: Tags plugin breaks without icons (4.13.0 regression)

4.13.0 2022 年 4 月 24 日¶

¥4.13.0 April 24, 2022¶

增加了对标签图标的支持
¥Added support for tag icons

4.12.0 2022年3月27日¶

¥4.12.0 March 27, 2022¶

增加了对卡片网格和网格布局的支持
¥Added support for card grids and grid layouts
已修复#3685 ：使用即时加载时注释有时会损坏
¥Fixed #3685: Annotations sometimes broken when using instant loading
已修复#3742 ：在构建离线使用时自动添加 Mermaid.js
¥Fixed #3742: Automatically add Mermaid.js when building for offline usage

4.11.0 2022年3月6日¶

¥4.11.0 March 6, 2022¶

增加了从隐私插件中排除外部资产的支持
¥Added support for excluding external assets from privacy plugin

4.10.1 2022年3月2日¶

¥4.10.1 March 2, 2022¶

向 Dockerfile 添加了缺少的构建依赖项
¥Added missing build dependencies to Dockerfile
修复了隐私插件中的编码问题，现在强制使用 UTF-8 编码
¥Fixed encoding issues in privacy plugin, now forcing UTF-8 encoding
已修复#3624 ：在 Firefox 中滚动到活动导航项不可靠
¥Fixed #3624: Scroll to active navigation item unreliable in Firefox
修复#3642 ：省略字体设置时隐私插件错误
¥Fixed #3642: Privacy plugin errors when font setting was omitted

4.10.0 2022 年 2 月 27 日¶

¥4.10.0 February 27, 2022¶

增加了对离线插件的支持（取代离线搜索支持）
¥Added support for offline plugin (supersedes offline search support)
改进了内置隐私插件，可下载嵌套的 JavaScript 资产
¥Improved built-in privacy plugin to download nested JavaScript assets
重构内置隐私插件的配置
¥Refactored configuration of built-in privacy plugin

4.9.1 2022年2月21日¶

¥4.9.1 February 21, 2022¶

已修复#3610 ：隐私插件缺少lxml依赖项
¥Fixed #3610: missing lxml dependency for privacy plugin
修复content-type标头中缺少字符集时的错误
¥Fixed error when charset is missing in content-type header

4.9.0 2022年2月20日¶

¥4.9.0 February 20, 2022¶

添加了隐私插件：自动下载外部资产
¥Added privacy plugin: automatic downloading of external assets

4.8.3 2022年2月13日¶

¥4.8.3 February 13, 2022¶

已修复#3560 ：美人鱼图无法渲染file://位置
¥Fixed #3560: Mermaid diagrams don't render for file:// locations

4.8.2 2022年2月10日¶

¥4.8.2 February 10, 2022¶

已修复#3559 ：美人鱼图无法在封闭details内呈现
¥Fixed #3559: Mermaid diagrams don't render inside closed details

4.8.1 2022年2月6日¶

¥4.8.1 February 6, 2022¶

修复了使用锚点跟随时在移动设备上跳转回顶部的问题
¥Fixed jump back to top on mobile when using anchor following

4.8.0 2022 年 2 月 6 日¶

¥4.8.0 February 6, 2022¶

增加了对锚点跟随目录的支持（=自动滚动）
¥Added support for anchor following table of contents (= auto scroll)

4.7.2 2022年2月2日¶

¥4.7.2 February 2, 2022¶

修复#3526 ：由于 Safari 错误导致侧边栏标题透明
¥Fixed #3526: Transparent sidebar title due to Safari bug
已修复#3528 ：Firefox 有时会剪辑流程图中的文本
¥Fixed #3528: Firefox sometimes clips text in flow chart diagrams

4.7.1 2022年1月30日¶

¥4.7.1 January 30, 2022¶

已修复#3506 ：标签索引不尊重通过前言设置的标题
¥Fixed #3506: Tags index not respecting title set via front matter

4.7.0 2022 年 1 月 25 日¶

¥4.7.0 January 25, 2022¶

增加了对离线搜索的原生支持
¥Added native support for offline search

4.6.1 2022年1月16日¶

¥4.6.1 January 16, 2022¶

已修复#3459 ：章节索引页拾取错误标题
¥Fixed #3459: Section index pages picking up wrong title

4.6.0 2022 年 1 月 11 日¶

¥4.6.0 January 11, 2022¶

增加了对注释的支持（代码块之外）
¥Added support for annotations (outside of code blocks)

4.5.2 2022年1月8日¶

¥4.5.2 January 8, 2022¶

已修复#3440 ：使用链接时内容选项卡指示器不移动
¥Fixed #3440: Content tab indicator not moving when using linking
已修复#3445 ：使用链接时内容选项卡切换闪烁/抖动
¥Fixed #3445: Content tab switch flickers/jitters when using linking

4.5.1 2022年1月2日¶

¥4.5.1 January 2, 2022¶

增加了对设置 Cookie 同意初始状态的支持
¥Added support for setting initial state of cookie consent
已修复#3396 ：由于 Safari 错误导致导航中的链接消失
¥Fixed #3396: Disappearing link in navigation due to Safari bug

4.5.0 2021年12月16日¶

¥4.5.0 December 16, 2021¶

增加了对导航图标的支持
¥Added support for navigation icons

4.4.0 2021年12月10日¶

¥4.4.0 December 10, 2021¶

增加了对代码注释锚链接（深度链接）的支持
¥Added support for code annotation anchor links (deep linking)
添加了新的代码注释语法修饰符以删除注释
¥Added new code annotation syntax modifier to strip comment
更新了 Cookie 同意的德语翻译
¥Updated German translations for cookie consent

4.3.0 2021年12月5日¶

¥4.3.0 December 5, 2021¶

增加了对社交卡片中自定义字体的支持
¥Added support for custom fonts in social cards
修复#3300 ：使用即时加载时公告栏重新出现
¥Fixed #3300: Announcement bar reappearing when using instant loading

4.2.0 2021年12月2日¶

¥4.2.0 December 2, 2021¶

增加了对可关闭公告栏的支持
¥Added support for dismissible announcement bar
在反馈小部件中添加了对命名占位符的支持
¥Added support for named placeholders in feedback widget

4.1.0 2021年11月30日¶

¥4.1.0 November 30, 2021¶

增加了将页面标题传递到反馈表的支持
¥Added support for passing page title to feedback forms

4.0.0 2021年11月28日¶

¥4.0.0 November 28, 2021¶

删除了已弃用的内容标签旧版实现
¥Removed deprecated content tabs legacy implementation
删除了已弃用的seealso警告类型
¥Removed deprecated seealso admonition type
删除了已弃用的site_keywords设置（MkDocs 不支持）
¥Removed deprecated site_keywords setting (unsupported by MkDocs)
删除了已弃用的预建搜索索引支持
¥Removed deprecated prebuilt search index support
删除了已弃用的 Web 应用清单 - 使用自定义
¥Removed deprecated web app manifest – use customization
删除了extracopyright变量 – 使用新的copyright部分
¥Removed extracopyright variable – use new copyright partial
删除 Disqus 集成 – 使用自定义
¥Removed Disqus integration – use customization
切换到:is()选择器以获取简单的选择器列表
¥Switched to :is() selectors for simple selector lists
将自动前缀从last 4 years更改为last 2 years
¥Switched autoprefixer from last 4 years to last 2 years
全面改进 CSS，以符合现代标准
¥Improved CSS overall to match modern standards
改进了字体的 CSS 变量语义
¥Improved CSS variable semantics for fonts
通过重组部分结构来提高可扩展性
¥Improved extensibility by restructuring partials
改进了打印时的details处理
¥Improved handling of details when printing
改进了脚注的键盘导航
¥Improved keyboard navigation for footnotes
已修复#3214 ：搜索突出显示在空白处中断网站
¥Fixed #3214: Search highlighting breaks site when empty

3.2.3 2021年11月20日¶

¥3.2.3 November 20, 2021¶

更新了瑞典语和法语翻译
¥Updated Swedish and French translations
删除了对.mermaid-experimental类（现为.mermaid ）的支持
¥Removed support for .mermaid-experimental class (now .mermaid)
已修复#3202 ：在file://位置上无法取消 Cookie 同意
¥Fixed #3202: Cookie consent not dismissable on file:// locations
已修复#3216 ：通过锚点调用时 Cookie 同意未被取消
¥Fixed #3216: Cookie consent not dismissed when invoked via anchor
已修复#3232 ：Mermaid.js 有时运行两次（竞争条件）
¥Fixed #3232: Mermaid.js sometimes runs twice (race condition)

3.2.2 2021年11月6日¶

¥3.2.2 November 6, 2021¶

修复总是发送最后的反馈评级
¥Fixed always last feedback rating being sent
已修复#3145 ：代码注释占用整个注释行
¥Fixed #3145: Code annotations eat whole comment lines
已修复#3170 ：反馈小部件未向 GA4 发送数据
¥Fixed #3170: Feedback widget doesn't send data to GA4

3.2.1 2021年11月4日¶

¥3.2.1 November 4, 2021¶

通过附加 JavaScript 添加了对自定义 Mermaid.js 版本的支持
¥Added support for custom Mermaid.js version via additional JavaScript
修复了标签插件的一些配置边缘情况（3.1.5 回归）
¥Fixed some configuration edge cases for tags plugin (3.1.5 regression)
修复了反馈小部件标题在 Firefox 中未居中的问题
¥Fixed feedback widget title not being centered in Firefox
已修复#3179 ：Safari 不发送反馈小部件请求
¥Fixed #3179: Safari doesn't send request for feedback widget

3.2.0 2021年10月31日¶

¥3.2.0 October 31, 2021¶

增加了对反馈小部件的支持（此页面有帮助吗？）
¥Added support for feedback widget (Was this page helpful?)

3.1.5 2021年10月28日¶

¥3.1.5 October 28, 2021¶

已修复#3144 ：使用带有自动填充导航的标签时出现恶意链接
¥Fixed #3144: Rogue link when using tags with auto-populated navigation
已修复#3147 ：代码块行号出现在搜索结果中
¥Fixed #3147: Code block line numbers appear in search results
已修复#3158 ：社交卡片不会从标题中删除 HTML 标签
¥Fixed #3158: Social cards do not strip HTML tags from title

3.1.4 2021年10月17日¶

¥3.1.4 October 17, 2021¶

已修复#2974 ：社交插件中文本被Roboto以外的其他字体裁剪
¥Fixed #2974: Text cropped with other fonts than Roboto in social plugin
已修复#3099 ：社交插件中非拉丁字符的编码问题
¥Fixed #3099: Encoding problems with non-latin character in social plugin
已修复#3112 ：日语分段器未作为新标记器的一部分执行
¥Fixed #3112: Japanese segmenter not executed as part of new tokenizer
修复了禁用标签插件后搜索中出现的标签（前言）
¥Fixed tags (front matter) appearing in search with disabled tags plugin

3.1.3 2021年10月12日¶

¥3.1.3 October 12, 2021¶

向搜索插件添加了对不受支持的选项和语法的警告
¥Added warnings to search plugin for unsupported options and syntax
已修复#3503 ：搜索有时会返回整个页面
¥Fixed #3503: Search sometimes returns entire page
修复#3089 ：打印时单行代码注释消失
¥Fixed #3089: Single-line code annotations disappear when printing

3.1.2 2021年10月6日¶

¥3.1.2 October 6, 2021¶

修复了 Windows 上社交卡的错误路径分隔符
¥Fixed incorrect path separators for social cards on Windows

3.1.1 2021年9月26日¶

¥3.1.1 September 26, 2021¶

修复了搜索排除逻辑中的排序错误
¥Fixed ordering bug in search exclusion logic

3.1.0 2021 年 9 月 26 日¶

¥3.1.0 September 26, 2021¶

增加了从搜索中排除页面、部分和元素的支持
¥Added support for excluding pages, sections, and elements from search
已修复#2803 ：打印时代码块注释不可见
¥Fixed #2803: Code block annotations not visible when printing

3.0.1 2021年9月19日¶

¥3.0.1 September 19, 2021¶

增加了对使用文字h1-6标签进行搜索插件的支持
¥Added support for using literal h1-6 tags for search plugin
修复了搜索插件在没有斜线的空元素上中断的问题
¥Fixed search plugin breaking on void elements without slashes
修复了搜索插件过滤标题中的链接内容
¥Fixed search plugin filtering link contents from headlines
修复了搜索插件对多个h1标题的处理
¥Fixed search plugin handling of multiple h1 headlines
修复了搜索插件对缺失h1标题的处理
¥Fixed search plugin handling of missing h1 headlines

3.0.0 2021 年 9 月 13 日¶

¥3.0.0 September 13, 2021¶

重写 MkDocs 的搜索插件
¥Rewrite of MkDocs' search plugin
增加了对丰富搜索预览的支持
¥Added support for rich search previews
增加了对带有前瞻功能的标记器的支持
¥Added support for tokenizer with lookahead
改进的搜索索引性能（速度提高一倍）
¥Improved search indexing performance (twice as fast)
改进的搜索突出显示
¥Improved search highlighting

2.13.3 2021年9月1日¶

¥2.13.3 September 1, 2021¶

增加了禁用社交卡生成的支持
¥Added support for disabling social card generation

2.13.2 2021年8月25日¶

¥2.13.2 August 25, 2021¶

已修复#2965 ：未定义主色时社交插件错误
¥Fixed #2965: Social plugin error when primary color is not defined

2.13.1 2021年8月21日¶

¥2.13.1 August 21, 2021¶

已修复#2948 ：社交卡未缓存
¥Fixed #2948: Social cards are not cached
已修复#2953 ：Mermaid.js 图表无法再居中
¥Fixed #2953: Mermaid.js diagrams can't be centered anymore

2.13.0 2021年8月7日¶

¥2.13.0 August 7, 2021¶

增加了对社交卡片自定义颜色的支持
¥Added support for custom colors in social cards

2.12.2 2021年8月4日¶

¥2.12.2 August 4, 2021¶

已修复#2891 ：社交插件中的除以零错误
¥Fixed #2891: Division by zero error in social plugin

2.12.1 2021年7月26日¶

¥2.12.1 July 26, 2021¶

修复了未设置site_description时社交插件中的错误
¥Fixed error in social plugin when site_description was not set
修复了社交插件中非 ASCII 字符的错误
¥Fixed error in social plugin for non-ASCII characters

2.12.0 2021年7月25日¶

¥2.12.0 July 25, 2021¶

增加了对社交卡的支持
¥Added support for social cards

2.11.1 2021年7月20日¶

¥2.11.1 July 20, 2021¶

修复了标签索引的顺序，现在按字母顺序排序
¥Fixed order of tags index, now sorted alphabetically

2.11.0 2021年7月18日¶

¥2.11.0 July 18, 2021¶

改进了 Mermaid.js 集成，现在稳定了
¥Improved Mermaid.js integration, now stable
增加了对序列图的支持
¥Added support for sequence diagrams
增加了对实体关系图的支持
¥Added support for entity relationship diagrams
增加了对 Cookie 同意配置的支持
¥Added support for cookie consent configuration
添加了始终启用注释的功能标志
¥Added feature flag to always enable annotations

2.10.0 2021 年 7 月 10 日¶

¥2.10.0 July 10, 2021¶

增加了对 Cookie 同意的支持
¥Added support for cookie consent
已修复#2807 ：使用粘性标签时，返回顶部按钮未隐藏
¥Fixed #2807: Back-to-top button not hidden when using sticky tabs

2.9.2 2021年5月30日¶

¥2.9.2 May 30, 2021¶

将标签移至部分以便于定制
¥Moved tags to partial for easier customization
增加了对在任何页面上隐藏标签的支持
¥Added support for hiding tags on any page

2.9.1 2021年5月24日¶

¥2.9.1 May 24, 2021¶

添加了内容标签链接缺失的保护
¥Added missing guard for linking of content tabs

2.9.0 2021年5月23日¶

¥2.9.0 May 23, 2021¶

增加了对内容标签链接的支持
¥Added support for linking of content tabs

2.8.0 2021年5月12日¶

¥2.8.0 May 12, 2021¶

增加了对搜索中提升页面的支持
¥Added support for boosting pages in search

2.7.2 2021年5月8日¶

¥2.7.2 May 8, 2021¶

已修复#2638 ：使用没有目录 URL 的tags插件时显示警告
¥Fixed #2638: Warnings shown when using tags plugin without directory URLs

2.7.1 2021年5月3日¶

¥2.7.1 May 3, 2021¶

修复git-revision-date-localized插件集成（2.7.0 回归）
¥Fixed git-revision-date-localized plugin integration (2.7.0 regression)

2.7.0 2021年5月1日¶

¥2.7.0 May 1, 2021¶

增加了对标签的支持（带有搜索集成）
¥Added support for tags (with search integration)

2.6.0 2021年4月11日¶

¥2.6.0 April 11, 2021¶

切换版本时停留在页面上
¥Stay on page when switching versions

2.5.0 2021年3月28日¶

¥2.5.0 March 28, 2021¶

增加了对版本警告的支持
¥Added support for version warning

2.4.0 2021年3月20日¶

¥2.4.0 March 20, 2021¶

增加了对自定义警告图标的支持
¥Added support for custom admonition icons
已修复#2444 ：带有额外注释的代码块注释索引错误
¥Fixed #2444: Code block annotations with extra comments have wrong index

2.3.1 2021年3月14日¶

¥2.3.1 March 14, 2021¶

修复使用粘性导航标签时永久链接的锚点偏移问题
¥Fixed anchor offset for permalinks when using sticky navigation tabs

2.3.0 2021年3月13日¶

¥2.3.0 March 13, 2021¶

增加了对返回顶部按钮的支持
¥Added support for back-to-top button

2.2.1 2021年3月4日¶

¥2.2.1 March 4, 2021¶

已修复#2382 ：当不存在发布标签时，存储库统计信息失败
¥Fixed #2382: Repository stats failing when no release tag is present

2.2.0 2021年2月28日¶

¥2.2.0 February 28, 2021¶

增加了对代码块注释的支持
¥Added support for code block annotations

2.1.0 2021年2月26日¶

¥2.1.0 February 26, 2021¶

增加了对锚点跟踪的支持
¥Added support for anchor tracking

2.0.0 2021年2月24日¶

¥2.0.0 February 24, 2021¶

将 Insiders 迁移到新架构
¥Migrated Insiders to the new architecture
交换调色板切换配置
¥Swapped color palette toggle configuration

1.17.0 2021年1月31日¶

¥1.17.0 January 31, 2021¶

增加了对部分索引页的支持
¥Added support for section index pages

1.16.1 2021年1月26日¶

¥1.16.1 January 26, 2021¶

已修复#2249 ：即时加载 + 粘性标签导致链接无效
¥Fixed #2249: Instant loading + sticky tabs result in invalid links
已修复#2248 ：始终添加搜索突出显示 URL 参数
¥Fixed #2248: Search highlighting URL parameter always added
已修复#2235 ：版本选择器未选择别名的当前版本
¥Fixed #2235: Version selector doesn't select current version for aliases

1.16.0 2021年1月7日¶

¥1.16.0 January 7, 2021¶

将最新版本添加到存储库信息（GitHub）
¥Added latest release to repository info (GitHub)
存储库信息略有改进（字体、间距和图标更浅）
¥Slight facelift of repository info (lighter fonts, spacing and icons)

1.15.0 2021年1月2日¶

¥1.15.0 January 2, 2021¶

增加了对原生 Mermaid.js 集成的支持
¥Added support for native Mermaid.js integration

1.14.0 2020年12月30日¶

¥1.14.0 December 30, 2020¶

增加了对共享搜索的支持
¥Added support for sharing searches

1.13.2 2020年12月22日¶

¥1.13.2 December 22, 2020¶

修复版本选择器+粘性标签导航渲染问题
¥Fixed version selector + sticky tabs navigation rendering issues
修复版本选择器包装
¥Fixed version selector wrapping

1.13.1 2020年12月20日¶

¥1.13.1 December 20, 2020¶

删除了语言和版本选择器上的水平滚动条
¥Removed horizontal scrollbars on language and version selector
修复 JavaScript 配置中的类型转换
¥Fixed type conversion in JavaScript config

1.13.0 2020年12月13日¶

¥1.13.0 December 13, 2020¶

重构导航选项卡以简化分组行为
¥Refactored navigation tabs to simplify grouping behavior
增加了对粘性导航标签的支持
¥Added support for sticky navigation tabs
增加了对导航选项卡中任意链接的支持
¥Added support for arbitrary links in navigation tabs
已修复#2098 ：后续活动子部分未正确突出显示
¥Fixed #2098: Subsequent active subsection not highlighted correctly

1.12.1 2020年12月8日¶

¥1.12.1 December 8, 2020¶

修复显示空的语言选择器
¥Fixed empty language selector being shown

1.12.0 2020年12月6日¶

¥1.12.0 December 6, 2020¶

增加了对添加语言选择器的支持
¥Added support for adding a language selector

1.11.2 2020年11月29日¶

¥1.11.2 November 29, 2020¶

已修复#2068 ：搜索突出显示将代码块解释为 JavaScript
¥Fixed #2068: Search highlight interprets code blocks as JavaScript

1.11.1 2020年11月29日¶

¥1.11.1 November 29, 2020¶

重构样式使其更加稳定且更易于调整
¥Refactored styling to be more stable and easier to adjust
修复了最新功能的一些样式回归问题
¥Fixed some styling regressions from latest features

1.11.0 2020年11月22日¶

¥1.11.0 November 22, 2020¶

增加了将警告渲染为内联块的支持
¥Added support for rendering admonitions as inline blocks

1.10.0 2020年11月15日¶

¥1.10.0 November 15, 2020¶

增加了将目录集成到导航中的支持
¥Added support for integrating table of contents into navigation

1.9.0 2020年11月7日¶

¥1.9.0 November 7, 2020¶

增加了在任何页面上隐藏导航和目录的支持
¥Added support for hiding navigation and table of contents on any page
删除了目录为空时的自动隐藏功能
¥Removed autohiding table of contents when empty

1.8.0 2020年11月1日¶

¥1.8.0 November 1, 2020¶

增加了对导航部分的支持
¥Added support for navigation sections
修复非活动搜索建议的外观
¥Fixed appearance of inactive search suggestions

1.7.0 2020年10月25日¶

¥1.7.0 October 25, 2020¶

增加了对部署多个版本的支持
¥Added support for deploying multiple versions
修复内容区域太小时侧边栏的对齐问题
¥Fixed alignment of sidebar when content area is too small

1.6.0 2020年10月11日¶

¥1.6.0 October 11, 2020¶

增加了对搜索建议的支持以节省按键
¥Added support for search suggestions to save keystrokes
添加了从页脚中删除Made with Material for MkDocs 的支持
¥Added support for removing Made with Material for MkDocs from footer
已修复#1915 ：按Enter 键搜索应转到第一个结果
¥Fixed #1915: search should go to first result by pressing Enter

1.5.1 2020年9月21日¶

¥1.5.1 September 21, 2020¶

固定内容区域延伸至长代码块的整个宽度
¥Fixed content area stretching to whole width for long code blocks

1.5.0 2020年9月19日¶

¥1.5.0 September 19, 2020¶

添加了当目录为空时自动隐藏目录的支持
¥Added support for autohiding table of contents when empty

1.4.1 2020年9月6日¶

¥1.4.1 September 6, 2020¶

改进的预先输入和搜索结果相关性和评分
¥Improved typeahead and search result relevance and scoring

1.4.0 2020年8月30日¶

¥1.4.0 August 30, 2020¶

增加了对滚动时自动隐藏标题的支持
¥Added support for autohiding header on scroll

1.3.0 2020年8月26日¶

¥1.3.0 August 26, 2020¶

增加了对用户可选调色板的支持
¥Added support for user-selectable color palettes

1.2.0 2020年8月11日¶

¥1.2.0 August 11, 2020¶

添加了默认扩展导航的功能
¥Added feature to expand navigation by default

1.1.0 2020年8月3日¶

¥1.1.0 August 3, 2020¶

增加了搜索结果的突出显示
¥Added highlighting of search results

1.0.0 2020年7月14日¶

¥1.0.0 July 14, 2020¶

增加了搜索结果分组
¥Added grouping of search results
将缺失的查询词添加到搜索结果中
¥Added missing query terms to search result
提高搜索结果的相关性和评分
¥Improved search result relevance and scoring