跳到主要内容
← 返回索引页

3.8.0

Arien Shibani
Ben McCann
程序员小墨
cylewaitforit
Daniel Kuschny
João Victor Lopes
David King Roderos
Hichem Fantar
Hidde de Vries
Oleksiy Gapotchenko

🚀 新特性​

  • docusaurus-plugin-css-cascade-layers, docusaurus-preset-classic, docusaurus-theme-classic, docusaurus-types, docusaurus
    • #11142 feat(主题): 新增 CSS 层叠层插件 + 内置 v4.useCssCascadeLayers 未来特性标记 (@slorber)
  • docusaurus
  • docusaurus-module-type-aliases, docusaurus-plugin-content-blog, docusaurus-theme-classic, docusaurus-theme-common, docusaurus-theme-search-algolia, docusaurus
    • #11090 feat(主题): 支持自定义页面标题格式化器 (@slorber)
  • docusaurus-plugin-content-pages
    • #11088 feat(页面): 支持像文档和博客插件一样的 frontMatter.slug (@slorber)
  • docusaurus-faster, docusaurus
  • docusaurus-theme-classic, docusaurus-theme-common, docusaurus-theme-translations
    • #10987 feat(主题): 允许将 colorMode 重置为系统/操作系统值 (@slorber)
  • docusaurus-remark-plugin-npm2yarn
  • docusaurus-theme-classic, docusaurus-theme-common
    • #10945 feat(主题): 添加主题布局稳定 CSS 类 (@slorber)
    • #10846 feat(主题): 代码块 showLineNumbers=start metastring (@slorber)
  • docusaurus-faster, docusaurus-plugin-content-docs, docusaurus-types, docusaurus
    • #10931 feat(核心): Docusaurus Faster - Rspack 持久化缓存 (@slorber)
  • docusaurus-theme-classic
    • #10852 feat(主题): 为 docsVersionDropdown 导航栏项添加 versions 属性 (@hrumhurum)
  • docusaurus-types, docusaurus
    • #10826 feat(核心): Docusaurus Faster - SSG 工作线程 (@slorber)
  • docusaurus-plugin-sitemap, docusaurus-types, docusaurus
    • #10850 feat(核心): 新增 postBuild({routesBuildMetadata}) API，弃用 head 属性 + v4 未来特性标记 (@slorber)

🐛 错误修复​

  • docusaurus-plugin-content-blog
  • docusaurus-plugin-content-blog
  • docusaurus-plugin-content-docs
    • #11179 修复(mdx-loader): 移除 mdx 依赖文件的选择性加入 (@slorber)
    • #10875 修复(文档): 版本控制 CLI 应该将本地化翻译文件 current.json 复制到 version-<v>.json (@jkboxomine)
  • create-docusaurus
    • #11157 修复(create-docusaurus): 改进初始化模板 README，修复标题并移除 bash 代码块中的 $ 符号 (@arienshibani)
  • docusaurus-theme-common
    • #11153 修复(主题): 恢复旧的代码块主题通用内部 API (@slorber)
    • #11046 修复(主题): 修复代码块魔术注释中的 CRLF 换行符错误 (@coder-xiaomo)
    • #10989 修复(主题): 移动抽屉历史阻挡器应有条件地渲染（临时解决方案） (@slorber)
    • #10954 修复(主题): 修复 useColorMode().colorMode 导致 React 水合不匹配的问题 (@slorber)
  • docusaurus-theme-classic
    • #11085 修复(主题): 为文档/博客标签添加缺失的 rel="tag" 属性 (@slorber)
    • #10999 修复(主题): CodeBlock 应该接受 ReactNode 类型的 title (@lebalz)
    • #10705 修复(主题): 仅在应显示时才渲染 secondaryMenu (@hidde)
    • #10898 修复(主题): 移动端 DropdownNavbarItem 的无障碍修复 (@mxschmitt)
    • #10909 修复(主题): 在 DocCard 中应用文档 sidebar_class_name + 更好的内部测试 (@slorber)
    • #10849 修复(主题): 修复 <DocCard> 高度不一致的问题 (@hichemfantar)
    • #10866 修复(主题): 在 React 水合之前隐藏代码块按钮 (@kennethormandy)
  • docusaurus-theme-classic, docusaurus-theme-translations
    • #11053 修复(主题): 导航栏移动侧边栏应允许点击下拉父链接 (@slorber)
  • docusaurus-utils
  • docusaurus-theme-translations
  • docusaurus-plugin-ideal-image
    • #11026 修复(ideal-image): 修复路径点初始滚动错误 (@slorber)
    • #11014 修复(ideal-image): 内置 react-waypoint 依赖，修复 React 19 兼容性 (@slorber)
    • #10910 修复(ideal-image): 为 ideal-image Webpack 加载器添加发行者 (@slorber)
  • docusaurus-mdx-loader
    • #11004 修复(mdx-loader): 重构并修复标题到 toc html 值序列化 (@slorber)
  • docusaurus-module-type-aliases
  • docusaurus-theme-classic, docusaurus-theme-common, docusaurus-theme-translations
    • #10987 feat(主题): 允许将 colorMode 重置为系统/操作系统值 (@slorber)
  • create-docusaurus, docusaurus-utils
    • #10958 修复(create-docusaurus): 修复 CLI 并移除 shelljs escapeShellArg 工具 (@slorber)
  • docusaurus-mdx-loader, docusaurus-plugin-content-docs
    • #10934 修复(文档): 修复版本变更时 mdx 加载器缓存失效错误 (@slorber)
  • docusaurus-plugin-content-blog, docusaurus-plugin-content-docs, docusaurus-plugin-content-pages
    • #10929 修复(插件): 添加缺失的 validateOptions 类型 (@slorber)
  • docusaurus-plugin-content-blog, docusaurus-plugin-content-docs, docusaurus-theme-classic, docusaurus-theme-common
    • #10888 修复(SEO): 文档面包屑结构化数据应使用 JSON-LD 并过滤掉不喜欢的类别 (@johnnyreilly)
  • docusaurus-theme-classic, docusaurus-theme-common
    • #10886 修复(主题): 如果侧边栏类别处于活动状态，点击标签时折叠该类别 (@slorber)
  • docusaurus
    • #10915 修复(核心): 使用 os.availableParallelism() 作为 SSG 工作线程计数 (@slorber)
  • docusaurus-plugin-content-docs, docusaurus-theme-classic
    • #10847 修复(主题): 修复 <DocCardList> 在侧边栏根目录文档中的使用问题 (@slorber)
  • docusaurus-plugin-svgr, docusaurus-types, docusaurus-utils, docusaurus
  • docusaurus-logger

:running: 性能​

  • docusaurus-utils, docusaurus
    • #11178 性能(核心): 暂时禁用 Rspack parallelCodeSplitting (@slorber)
  • docusaurus
    • #11177 性能(核心): 修复 mergeDuplicateChunks 的错误值（拼写错误） (@slorber)
    • #11170 性能(核心): 为 DOCUSAURUS_SSG_WORKER_THREAD_RECYCLER_MAX_MEMORY 添加默认值 (@slorber)
    • #11166 feat(核心): 暴露 SSG 线程回收的选择性加入环境变量 (@slorber)
    • #11072 性能(核心): 移除打包器 optimization.removeAvailableModules (@slorber)
    • #11067 feat(核心): 启用 Rspack parallelCodeSplitting (@slorber)
    • #11037 重构(核心): 移除 clean-webpack-plugin (@slorber)
    • #11007 性能(核心): 优化 docusaurus start/serve，修复 macOS 上 openBrowser() 性能问题 (@slorber)
  • docusaurus-bundler, docusaurus-faster, docusaurus
  • docusaurus-utils
  • docusaurus-logger, docusaurus
    • #11162 性能(核心): 优化 SSG 收集的数据内存和工作线程通信 (@slorber)
  • docusaurus-bundler, docusaurus
    • #10956 重构: 移除 react-dev-utils (CRA) 依赖，内置代码 (@slorber)
  • docusaurus-theme-classic
    • #10885 性能(主题): IconExternalLink 使用 SVG 精灵图 (@slorber)
  • docusaurus-types, docusaurus
    • #10826 feat(核心): Docusaurus Faster - SSG 工作线程 (@slorber)

💅 优化​

  • docusaurus-theme-live-codeblock
    • #11120 修复(主题): 改善实时代码块标题的颜色对比度 (@JackHowa)
  • docusaurus-theme-translations

📝 文档​

  • #11181 文档: 调整 Docusaurus 发布流程文档以适应我们新的简化流程 (@slorber)
  • #11180 文档(ideal-image): 为 pnpm 10+ 和 sharp 安装脚本添加警告 (@slorber)
  • #11137 文档(部署): 从部署文档中移除 layer0 (@PaiJi)
  • #10822 文档(网站): 与 Rspress 的比较 (@DevJoaoLopes)

🤖 依赖​

🔧 维护​

  • docusaurus-mdx-loader, docusaurus-utils
    • #11168 杂项: 将 Node 24 添加到 CI + 修复弃用警告 (@slorber)
  • docusaurus-plugin-content-blog
  • docusaurus-mdx-loader, docusaurus-theme-common, docusaurus-theme-live-codeblock
    • #11077 重构(实时代码块): 重构实时代码块主题组件 (@slorber)
  • 其他
  • docusaurus-faster
    • #11073 杂项: 升级 Rspack 1.3.3 (@slorber)
    • #10870 杂项(依赖): 将 Faster 中的 @rspack/core 从 1.2.0-alpha.0 升级到 1.2.2 (@tats-u)
  • docusaurus-theme-mermaid
  • docusaurus-mdx-loader
  • docusaurus-theme-classic, docusaurus-theme-common
    • #11062 重构(主题): 引入 CodeBlockContextProvider + 拆分为更小的组件 (@slorber)
    • #11059 重构(主题): CodeBlock，集中元数据解析 + 重构主题组件 (@slorber)
  • docusaurus-plugin-content-blog, docusaurus-plugin-content-docs, docusaurus-theme-common
    • #11058 重构(主题): 重构 CodeBlock parseLines 逻辑 + 使用内联快照方便审查 (@slorber)
  • docusaurus-faster, docusaurus
  • docusaurus-plugin-ideal-image
    • #11010 重构(ideal-image-plugin): 内置旧的组件代码 (@slorber)
  • docusaurus-theme-classic, docusaurus-theme-common, docusaurus-theme-mermaid, docusaurus-theme-search-algolia
  • docusaurus-cssnano-preset, docusaurus-mdx-loader, docusaurus-plugin-content-blog, docusaurus-remark-plugin-npm2yarn, eslint-plugin, stylelint-copyright
  • docusaurus-bundler, docusaurus
    • #10956 重构: 移除 react-dev-utils (CRA) 依赖，内置代码 (@slorber)
  • create-docusaurus, docusaurus-plugin-content-docs, docusaurus-utils, docusaurus
  • docusaurus-theme-search-algolia
    • #10941 杂项(algolia): 将 docsearch 依赖升级到 v3.9 (@slorber)
  • docusaurus-plugin-debug
    • #10903 杂项(plugin-debug): 将 react-json-view-lite 升级到 v2.3.0 以支持 react 19 (@reece-white)
    • #10819 杂项(plugin-debug): 将 react-json-view-lite 升级到 v2，为 React 19 做准备 (@slorber)
  • create-docusaurus
    • #10871 重构(create-docusaurus): 为初始化模板添加 future.v4 标志 (@slorber)

贡献者: 38​