
Docusaurus是由Meta的开源团队维护的基于React的静态网站生成器,现已发布3.9版本。此次更新的重点在于现代化运行环境、提升搜索能力,并通过Algolia DocSearchv4 AI扩展国际化(i18n)的灵活性,同时保持对现有文档项目的向后兼容性。
Docusaurus 3.9在三个方面进行了关键更新:AI驱动的搜索、运行时现代化和全球站点管理。最引人注目的新增功能是对DocSearch v4的全面支持,这带来了Algolia的新Ask AI功能,直接集成到文档网站中。这允许用户通过嵌入式聊天助手以对话方式查询内容,该助手经过训练可访问网站的索引页面。项目可以继续使用DocSearch v3或逐步升级到v4以解锁AI助手。要进行升级,开发者可以使用npm update @docsearch/react命令。
此次发布将Node.js的最低要求提高到v20.0.0,停止支持Node 18。虽然此更改可能会影响CI/CD管道或容器化构建,但由于Node 18已达到生命周期终点且不再受支持,因此不被视为重大更改。一些开发者认为,由于此次发布停止支持Node v18,应该被视为重大更改。
Docusaurus 3.9改进了i18n的配置。开发者现在可以使用新的i18n.localeConfigs[locale]字段为每个语言环境覆盖baseUrl和url属性,从而实现多域或深度本地化的部署设置。
对i18n的进一步改进包括一个新的translate标志,默认设置为false,这提高了不使用翻译的网站的构建速度。还为侧边栏项目添加了一个新的key属性,使开发者可以明确为侧边栏项目分配键。
此次发布还包括对巴西葡萄牙语和乌克兰语的翻译修复。
其他改进包括Mermaid ELK布局支持以实现更丰富的图表渲染,以及通过Rspack 1.5升级进行的内部构建优化。
从3.8到3.9的迁移过程设计得非常简单。维护者建议在升级到DocSearch v4时验证Node.js版本并检查搜索配置。集成Ask AI的团队必须确保其Algolia爬虫已更新,并将适当的凭据添加到themeConfig.algolia部分。除此之外,没有API级别的重大更改,大多数网站可以通过简单地更新其依赖项来升级。
此次发布捆绑了许多其他更改和修复,完整的更改列表可以在这里找到。
Docusaurus是一个开源框架,用于使用React构建现代文档和内容驱动的网站。最初由Meta和Facebook开发和维护,它支持许多大型开源和企业文档网站。您可以在网站或Github的发布讨论线程中了解更多关于此次发布的内容。
