2.0.0-beta.19

🚀 新特性

• docusaurus-theme-classic, docusaurus-theme-common
  • #7178 功能(theme-classic): 可扩展的代码块魔术注释系统 (@Josh-Cena)
  • #7007 功能(theme-classic): 代码块显示行号 (@lex111)
  • #7012 功能(theme-classic): 在移动设备上显示博客侧边栏 (@Josh-Cena)
• docusaurus-theme-classic, docusaurus-theme-live-codeblock, docusaurus, eslint-plugin
  • #7206 功能: Docusaurus ESLint 插件，用于强制执行最佳 Docusaurus 实践 (@elias-pap)
• docusaurus-plugin-google-analytics, docusaurus-plugin-google-gtag, docusaurus-theme-classic, docusaurus-types, docusaurus
  • #6732 功能(核心): 重构客户端模块生命周期，正式公开 API (@Josh-Cena)
• docusaurus-theme-classic
  • #7231 功能: 允许自定义 navbarItem 类型通过验证 (@slorber)
  • #7058 功能(theme-classic): 新增“html”类型导航栏项目 (@lex111)
  • #7079 功能: 允许在导航栏链接中使用纯 HTML 作为标签 (@lex111)
• docusaurus-theme-classic, docusaurus-theme-common, docusaurus-theme-translations
  • #7036 功能(theme-classic): 切换代码换行按钮 (@lex111)
• docusaurus-plugin-content-docs, docusaurus-theme-classic, docusaurus-theme-common
  • #6457 功能(内容-文档): 草稿文档从构建和侧边栏中排除 (@jodyheavener)
• docusaurus-plugin-content-blog, docusaurus-plugin-content-docs, docusaurus-types, docusaurus
  • #6430 功能: 允许为国际化日期格式设置日历 (@Josh-Cena)
• docusaurus-module-type-aliases, docusaurus-plugin-content-docs, docusaurus-types, docusaurus
  • #7083 功能(核心): 故障安全全局数据获取 (@Josh-Cena)
• docusaurus-plugin-content-docs
  • #7106 功能(内容-文档): 使 docs:version 命令适用于本地化文档 (@Josh-Cena)
• docusaurus-types, docusaurus
  • #7082 功能(核心): 允许插件声明自定义路由上下文 (@Josh-Cena)
  • #7124 功能(核心): 允许插件/预设配置包含 false/null 值 (@Josh-Cena)
• docusaurus-plugin-sitemap, docusaurus-utils
  • #6979 功能(sitemap): 添加 ignorePatterns 选项 (@ApsarasX)

💥 破坏性变更

• docusaurus-types, docusaurus
  • #7257 重构: 移除长期弃用的 routesLoaded 生命周期 (@Josh-Cena)
• docusaurus-theme-classic, docusaurus-theme-common
  • #7277 重构(theme-classic): 将所有侧边栏相关配置移至 themeConfig.docs.sidebar 下 (@Josh-Cena)
• docusaurus-plugin-google-analytics, docusaurus-plugin-google-gtag, docusaurus-theme-classic, docusaurus-types, docusaurus
  • #6732 功能(核心): 重构客户端模块生命周期，正式公开 API (@Josh-Cena)
• create-docusaurus, docusaurus-theme-classic
  • #7176 重构: 通过 CSS 变量自定义代码块行高亮颜色 (@lex111)
• docusaurus-plugin-content-blog, docusaurus-plugin-content-docs, docusaurus-theme-classic, docusaurus-theme-common, docusaurus-types, docusaurus-utils-validation, docusaurus-utils
  • #7117 重构(内容-{博客,文档}): 统一处理标签 (@Josh-Cena)
• docusaurus-mdx-loader, docusaurus-plugin-content-blog, docusaurus-plugin-content-docs, docusaurus-plugin-content-pages, docusaurus-theme-classic, docusaurus-theme-live-codeblock
  • #7027 重构(内容-文档): 去重类型，为部分 API 添加 JSDoc (@Josh-Cena)

🐛 错误修复

• docusaurus-theme-classic
  • #7304 修复(theme-classic): 从微数据中移除没有 href 的面包屑项 (@Josh-Cena)
  • #7179 修复(theme-classic): 不将微数据项目属性添加到尾部面包屑 (@Josh-Cena)
  • #7173 修复(theme-classic): 提示标题：禁用内联代码块的文本转换 (@chelproc)
  • #7048 修复(theme-classic): 为移动端下拉菜单添加插入符号 (@lex111)
  • #7025 修复: 使文档页面包装器占据完整高度 (@lex111)
  • #7013 修复(theme-classic): 调整代码块阴影 (@chernodub)
  • #7015 修复(theme-classic): 不为不可折叠的类别添加插入符号 (@Josh-Cena)
• docusaurus-plugin-client-redirects, docusaurus-plugin-content-blog, docusaurus-plugin-content-docs, docusaurus-plugin-content-pages, docusaurus-plugin-debug, docusaurus-plugin-google-analytics, docusaurus-plugin-google-gtag, docusaurus-plugin-sitemap, docusaurus-preset-classic, docusaurus-theme-classic
  • #7294 修复(*): 让 TypeScript 识别每个插件包都有一个默认导出 (@Josh-Cena)
• docusaurus
  • #7285 修复(核心): 允许空的静态目录 (@Josh-Cena)
  • #7180 修复: 将 pollOptions 传递给 webpack (@JohnnyMcWeed)
  • #7184 修复(核心): 访问 /page.html 时防止 404 错误 (@Josh-Cena)
  • #7225 修复: 允许 Swizzling 组件的父文件夹 (@slorber)
  • #7066 修复(核心): 所有插件生命周期都应接收翻译内容 (@Josh-Cena)
• docusaurus-plugin-content-docs
  • #7233 修复(内容-文档): 使类别索引文本可翻译 (@Josh-Cena)
• docusaurus-theme-common
  • #7200 修复(theme-common): 不保留由操作系统触发的颜色模式更改 (@Josh-Cena)
  • #7057 修复(theme-common): 当 CSS 中设置了平滑行为时，使用原生滚动 (@Josh-Cena)
  • #7033 修复(主题): 只解析 MD 代码中的 HTML 和 JSX 风格注释 (@Josh-Cena)
• docusaurus-plugin-content-blog
  • #7212 修复(内容-博客): 使文章列表页上的脚注引用 DOM ID 唯一 (@AkiraVoid)
• docusaurus-utils, docusaurus
  • #7187 修复(核心): 处理 CWD 中 package.json 不可用的情况 (@Josh-Cena)
• docusaurus-theme-translations
  • #7222 修复(主题-翻译): 修复 cs 中的无效复数形式 (@Josh-Cena)
  • #7166 修复(主题-翻译): 始终尝试所有可能的区域设置解析 (@Josh-Cena)
• docusaurus-theme-classic, docusaurus-theme-search-algolia
  • #7164 修复: 正确调整自定义搜索的间距 (@lex111)
• docusaurus-plugin-debug, docusaurus-plugin-sitemap, docusaurus-preset-classic, docusaurus-types, docusaurus
  • #7143 修复(sitemap): 从站点地图中排除带有 robots noindex 的页面 (@Josh-Cena)
• create-docusaurus, docusaurus-types
  • #7078 修复(创建): 也为 JS 模板安装类型 (@Josh-Cena)
• docusaurus-utils
  • #7043 修复(工具): 解析带 CRLF 换行的 Markdown 标题 (@Josh-Cena)
• docusaurus-plugin-content-blog, docusaurus-plugin-content-docs, docusaurus-utils, docusaurus
  • #7023 重构: 修复一些路径处理问题 (@Josh-Cena)
• docusaurus-types
  • #7014 修复(类型): 声明 history 和 react-loadable 为依赖项 (@sulu5890)

💅 优化

• docusaurus-theme-classic, docusaurus-theme-translations
  • #7299 重构: 面包屑的次要改进 (@lex111)
• create-docusaurus
  • #7290 重构(创建): 在初始化模板中添加 i18n 配置 (@Josh-Cena)
  • #7286 重构(创建): 更新快速启动教程中的截图 (@Josh-Cena)
  • #7223 重构: 在初始化模板中使用生成的索引 (@slorber)
  • #7118 重构(创建): 提及编辑链接可以被移除 (@Josh-Cena)
• docusaurus-plugin-debug, docusaurus-theme-classic
  • #7306 维护: 将 Infima 升级到 alpha.39 (@lex111)
• docusaurus-plugin-debug, docusaurus-types, docusaurus
  • #7291 功能(类型): 为 docusaurus 配置字段添加 JSDoc (@Josh-Cena)
• docusaurus-theme-classic, docusaurus-theme-common
  • #7267 修复(theme-common): 允许 details 不提供摘要 (@Josh-Cena)
  • #7172 重构: 通过 CSS 变量控制代码块的基本样式 (@lex111)
  • #7129 重构(theme-classic): 修复一些边距不一致问题 (@lex111)
• docusaurus-plugin-content-docs, docusaurus-utils
  • #7248 重构: 规范 Markdown 链接行为，并在文档中详细说明 (@Josh-Cena)
• docusaurus-theme-classic
  • #7244 重构: 语义标记改进，修复验证警告 (@Josh-Cena)
  • #7183 重构: 为主页面包屑使用 SVG 图标 (@Dr-Electron)
  • #7139 修复: 移动设备上生成卡片项之间正确的间距 (@lex111)
  • #7134 修复(theme-classic): 修复展开类别时文档侧边栏布局偏移问题 (@slorber)
  • #7068 重构(theme-classic): 博客移动端二级菜单使用一致的样式 (@Josh-Cena)
  • #7004 修复(theme-classic): 缩小移动设备上的标题大小 (@Pierre-Gilles)
• docusaurus-theme-translations
  • #7214 维护(主题-翻译): 完成波兰语翻译 (@rev4324)
  • #7031 维护(主题-翻译): 完成德语翻译 (@deployn)
• create-docusaurus, docusaurus-theme-classic
  • #7176 重构: 通过 CSS 变量自定义代码块行高亮颜色 (@lex111)
• docusaurus
  • #7218 修复(CLI): 总是显示未处理拒绝的错误堆栈 (@Josh-Cena)
  • #7142 重构(核心): 将渲染进度条前的超时时间缩短至 200 毫秒 (@Josh-Cena)
  • #7103 修复(核心): 保留 Interpolate 子元素的语义 (@Josh-Cena)
  • #7029 重构: 控制台输出改进 (@lex111)
  • #7017 重构: 从 Swizzled 组件中移除版权注释 (@lex111)
• docusaurus-plugin-content-docs, docusaurus-preset-classic, docusaurus-theme-classic
  • #7148 功能(preset-classic, content-docs/client): JSDoc (@Josh-Cena)
• docusaurus-plugin-debug, docusaurus-preset-classic
  • #7122 功能(preset-classic): 将调试插件路由从站点地图中排除 (@lex111)
• docusaurus-theme-common, docusaurus-utils, docusaurus
  • #7113 测试: 提高测试覆盖率 (@Josh-Cena)
• docusaurus-mdx-loader, docusaurus-migrate, docusaurus-module-type-aliases, docusaurus-plugin-content-blog, docusaurus-plugin-content-docs, docusaurus-plugin-ideal-image, docusaurus-remark-plugin-npm2yarn, docusaurus-theme-classic, docusaurus-theme-common, docusaurus-theme-live-codeblock, docusaurus-types, docusaurus-utils-validation, docusaurus
  • #7080 重构: 将非 prop 接口替换为类型；允许插件生命周期具有同步类型 (@Josh-Cena)
• create-docusaurus, docusaurus-logger, docusaurus-plugin-content-docs, docusaurus
  • #7019 功能(日志): 新的“url”格式，为路径添加双引号 (@lex111)
• docusaurus-plugin-content-docs, docusaurus-theme-classic, docusaurus-theme-common
  • #7006 重构: 拆分并清理 theme/DocPage (@slorber)
• docusaurus-plugin-content-docs, docusaurus-theme-classic
  • #7005 重构: 按项目类型拆分 DocSidebarItem (@slorber)

📝 文档

• docusaurus-logger
  • #7305 文档: 更新日志器文档，将 API 文档添加到网站 (@Josh-Cena)
• 其他
  • #7284 文档: 添加关于 SSR 作为优化技术的段落 (@Josh-Cena)
  • #7278 文档: 增强关于 Markdown 目录和元数据的文档 (@Josh-Cena)
  • #7271 文档: 将 Node 版本要求精确到次版本 (@DanRoscigno)
  • #7252 文档: 更新 gtag 文档以反映 GA4 标签的样式 (@johnnyreilly)
  • #7240 文档: 将 PCC Archive 网站添加到案例展示 (@CuratorCat)
  • #7239 文档: 将 Chaos Mesh 网站添加到案例展示 (@cwen0)
  • #7235 文档: 将 TiDB 社区书籍添加到案例展示 (@shczhen)
  • #7236 文档: 添加关于复数形式的文档 (@Josh-Cena)
  • #7230 文档: 将 OSS Insight 添加到案例展示 (@sykp241095)
  • #7208 文档: 从 README 安装指南中删除“template”的提及 (@Josh-Cena)
  • #7159 文档: 更清楚地解释 ref 侧边栏类型的用途 (@andrewnicols)
  • #7126 文档: 多项文档改进 (@Josh-Cena)
  • #7123 重构(案例展示): 强制描述的最大长度为 120 个字符 (@Josh-Cena)
  • #7026 文档: 更正插件示例文件名 (@mxhdx)
  • #7110 文档: 添加关于附加语言需要是 Prism 组件名称的说明 (@Josh-Cena)
  • #6746 修复(网站): 延迟加载 YouTube iframe (@Josh-Cena)
  • #7061 文档: 将 docusaurus-plugin-typedoc 添加到资源 (@nartc)
  • #7059 文档: 将 firelordjs 添加到案例展示 (@Josh-Cena)
  • #7050 文档: 在 JSX 文件示例中添加 import React 语句 (@kaycebasques)
  • #7022 文档: 将 Easypanel 添加到案例展示 (@deiucanta)
  • #7016 文档: 统一使用 sidebars.js 文件名 (@leedom92)
  • #7020 文档: 将 Divine WSF 和 Ghostly 添加到案例展示 (@LeviticusMB)
  • #7000 文档: 移除不必要的分号 (@imsingh)
• docusaurus-plugin-content-docs, docusaurus-utils
  • #7248 重构: 规范 Markdown 链接行为，并在文档中详细说明 (@Josh-Cena)
• create-docusaurus, docusaurus-plugin-content-docs, docusaurus-theme-classic, docusaurus-utils
  • #7081 文档: 修复一些大小写不一致问题 (@Josh-Cena)

🔧 维护

• 其他
  • #7309 维护: 在变更日志中使用“维护”而非“内部” (@Josh-Cena)
  • #7300 杂项: 使用 Lighthouse CI 检查文档页面 (@lex111)
  • #7266 杂项: 将链接部分添加到 PR 模板 (@slorber)
  • #7224 维护: GitHub Actions 取消进行中 (@slorber)
  • #7216 维护: 从 devDependencies 中移除 netlify-cli (@Josh-Cena)
  • #7211 维护: 在 CI 矩阵中将 Node 17 替换为 18 (@Josh-Cena)
  • #7168 杂项: 添加 CI actions/dependency-review-action 用于安全 (@slorber)
  • #6984 杂项: 将 actions 固定到完整长度的提交 SHA (@naveensrinivasan)
  • #7002 维护: 为 2.0 beta.18 重新生成示例 (@slorber)
• docusaurus-logger, docusaurus-remark-plugin-npm2yarn
  • #7295 重构: 对 Node 工具包使用 export = 语法 (@Josh-Cena)
• docusaurus-mdx-loader, docusaurus-plugin-content-blog, docusaurus-plugin-content-docs, docusaurus-theme-classic, docusaurus-theme-common, docusaurus-types, docusaurus-utils-validation, docusaurus-utils, docusaurus
  • #7293 重构(类型): 将非核心、非公共类型移出 types 包 (@Josh-Cena)
• docusaurus-types, docusaurus
  • #7292 重构(核心): 将 CLI 命令及其选项类型并置 (@Josh-Cena)
  • #7084 重构(核心): 代码清理 (@Josh-Cena)
• docusaurus-module-type-aliases, docusaurus
  • #7282 重构(核心): 预取/预加载重构 (@Josh-Cena)
• docusaurus-theme-classic, docusaurus-theme-common
  • #7273 重构(theme-classic): 多次重新排列 (@Josh-Cena)
  • #7268 重构(theme-classic): DocPage 主题重构优化 (@slorber)
  • #7269 重构: 提取 useSkipToContent() (@slorber)
  • #7175 重构(theme-classic): 拆分 CodeBlock (@slorber)
  • #7067 重构(theme-classic): 将文档相关的导航栏项目逻辑提取到 theme-common (@Josh-Cena)
  • #7021 重构(主题): 将 BTT 按钮的辅助代码提取到 theme-common (@Josh-Cena)
• docusaurus-theme-classic
  • #7270 重构(theme-classic): 重构与 TOC 相关的主题组件 (@slorber)
• docusaurus
  • #7220 重构(CLI): 规范默认选项值的应用 (@Josh-Cena)
  • #7141 重构(核心): 次要 PendingNavigation 重构 (@Josh-Cena)
• docusaurus-plugin-content-docs
  • #7243 维护: 将 Jest 升级到 28；添加 GitHub Actions 报告器 (@Josh-Cena)
  • #7140 重构(内容-文档): 将版本处理拆分为多个文件 (@Josh-Cena)
• docusaurus-mdx-loader, docusaurus-plugin-content-blog, docusaurus-plugin-ideal-image, docusaurus-plugin-pwa, docusaurus-theme-live-codeblock, docusaurus
  • #7194 修复: 修复一些内部声明语义错误 (@Josh-Cena)
• create-docusaurus, docusaurus-migrate, docusaurus-theme-translations, docusaurus
  • #7186 重构: 优先使用 fs.readJSON 而非 readFile.then(JSON.parse) (@Josh-Cena)
• docusaurus-mdx-loader, docusaurus-plugin-content-blog, docusaurus-plugin-content-docs, docusaurus-plugin-content-pages
  • #7145 重构: 统一 MDX 内容类型的表示方式 (@Josh-Cena)
• create-docusaurus, docusaurus-mdx-loader, docusaurus-migrate, docusaurus-plugin-content-blog, docusaurus-plugin-content-docs, docusaurus-plugin-content-pages, docusaurus-plugin-ideal-image, docusaurus-plugin-pwa, docusaurus-theme-classic, docusaurus-theme-common, docusaurus-theme-search-algolia, docusaurus-types, docusaurus-utils, docusaurus, lqip-loader
  • #7138 维护: 升级依赖项 + 升级 React 类型 (@Josh-Cena)
• docusaurus-logger, docusaurus-mdx-loader, docusaurus-migrate, docusaurus-plugin-client-redirects, docusaurus-plugin-content-blog, docusaurus-plugin-content-docs, docusaurus-plugin-content-pages, docusaurus-plugin-sitemap, docusaurus-remark-plugin-npm2yarn, docusaurus-theme-classic, docusaurus-theme-common, docusaurus-theme-live-codeblock, docusaurus-theme-search-algolia, docusaurus-theme-translations, docusaurus-utils-validation, docusaurus-utils, docusaurus
  • #7131 维护: 在快照中禁用字符串转义 (@Josh-Cena)
• docusaurus-module-type-aliases, docusaurus-plugin-content-blog, docusaurus-theme-common, docusaurus-types, docusaurus-utils, docusaurus
  • #7054 重构(核心): 重构路由生成逻辑 (@Josh-Cena)
• docusaurus-module-type-aliases, docusaurus-plugin-content-blog, docusaurus-plugin-content-docs, docusaurus-plugin-content-pages, docusaurus-types, docusaurus
  • #7042 重构(核心): 重组文件 (@Josh-Cena)
• docusaurus-plugin-content-docs, docusaurus-utils, docusaurus
  • #7037 重构(核心): 重组函数 (@Josh-Cena)
• docusaurus-mdx-loader, docusaurus-plugin-content-blog, docusaurus-plugin-content-docs, docusaurus-plugin-content-pages, docusaurus-theme-classic, docusaurus-theme-live-codeblock
  • #7027 重构(内容-文档): 去重类型，为部分 API 添加 JSDoc (@Josh-Cena)

:running: 性能

• docusaurus-plugin-content-docs, docusaurus-theme-classic, docusaurus-theme-common, docusaurus-theme-live-codeblock, docusaurus-theme-search-algolia, docusaurus-utils-common
  • #7085 重构: 将一些客户端包标记为无副作用 (@Josh-Cena)
• docusaurus-mdx-loader, docusaurus-remark-plugin-npm2yarn
  • #4997 性能(mdx-loader): 缓存 mdx/remark 编译器实例 (@phryneas)

贡献者: 47

• Aaron Nwabuoku (@aerovulpe)
• AkiraVoid (@AkiraVoid)
• Alexey Pyltsyn (@lex111)
• Andrei Canta (@deiucanta)
• Andrew Lyons (@andrewnicols)
• ApsarasX (@ApsarasX)
• Chau Tran (@nartc)
• Chinazaekpere Ngubo (@dr-ngubo)
• Cwen Yin (@cwen0)
• Dan Roscigno (@DanRoscigno)
• Elias Papavasileiou (@elias-pap)
• Evan (@sulu5890)
• Fusang❀ (@cxOrz)
• Indermohan Singh (@imsingh)
• JMW (@JohnnyMcWeed)
• Jeffrey Aven (@jeffreyaven)
• Jody Heavener (@jodyheavener)
• John Reilly (@johnnyreilly)
• Joshua Chen (@Josh-Cena)
• Karl Ward (@mjau-mjau)
• Kayce Basques (@kaycebasques)
• Leedom (@leedom92)
• Lenz Weber-Tronic (@phryneas)
• Lukas Bach (@lukasbach)
• Martin Blom (@LeviticusMB)
• Naveen (@naveensrinivasan)
• Pablo Cordon (@pcordon)
• Pierre-Gilles Leymarie (@Pierre-Gilles)
• Qi Zhang (@zzzhangqi)
• Sébastien Lorber (@slorber)
• Viktor Chernodub (@chernodub)
• Zac A (@sandypockets)
• @Dr-Electron
• @chelproc
• @deployn
• @duanwilliam
• @kgolubic
• @redhat123456
• @surendran82
• @svix-ken
• apq (@AntonPalmqvist)
• curatorcat.pcc.eth (@CuratorCat)
• czhen (@shczhen)
• loic (@layerzzzio)
• mehdim (@mxhdx)
• rev (@rev4324)
• sykp241095 (@sykp241095)