今天,随着 2.0.0-alpha.71 的发布,我们正式推出 Docusaurus 2 i18n(国际化)功能。
Docusaurus 2 的功能特性现在已可和 Docusaurus 1 等量齐观。 🎉在不久的将来,我们会在更新基础设施并再做些测试后发布 Docusaurus 2 的首个 Beta 测试版本。
我们又挥洒了更多汗水,全新的 i18n 功能甚至比 Docusaurus 1 的内置支持更加强大。
本篇博文中,我们将向您呈现翻译工作流,并诠释部分设计决策及展示已经使用此功能的示例站点,如:Jest、Redwood 和 Datagit。
我们还自给自足,在自己的 Docusaurus 2 站点上启用了 i18n 功能。您可阅读本篇博文的英文、法文及中文版本!
翻译你的站点
您可以遵循以下三步轻松翻译 Docusaurus 站点:
- 配置:在
docusaurus.config.js
中声明默认及备选语言 - 翻译:将译文文件放置在正确的文件系统位置
- 部署:使用单域名或多域名策略构建并部署你的站点
i18n 支持非常灵活,且基于文件系统。
您可参见 **i18n 教程**来轻松上手,我们还提供 Git 或 Crowdin 的翻译方式。
设计决策
Docusaurus i18n 系统旨在:
- 简单:仅需将译文文件放置在正确的文件系统位置
- 灵活翻译流程:可以使用 Git(单仓、fork、子模块)、SaaS 软件、FTP,等等
- 灵活部署选择:可以部署于单个、多个域名,或混合部署
- 模块化:插件作者也可提供国际化支持
- 快速运行时:文档多为静态,无需重量级的 JS 库或 Polyfill
- 构建时间可控:允许独立构建并部署本地化内容网站
- 本地化资源:你的网站上的图像可被翻译