发布 Docusaurus 国际化 (i18n)
今天，我们正式发布 Docusaurus 2 国际化 (i18n) （ 国际化 ），作为 2.0.0-alpha.71 的一部分。
Docusaurus 2 现在已经 与 Docusaurus 1 实现了完全的功能 parity 。🎉 很快，在一些额外的基础设施更新和更多测试之后， 第一个 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
- 灵活的部署选项 : 单域、多域或混合模式
- 模块化 : 允许插件作者提供 i18n 支持
- 低开销的运行时 : 文档大多是静态的，不需要重量级的 JS 库或 polyfill
- 可扩展的构建时间 : 允许独立构建和部署本地化网站
- 本地化资产 : 您网站的图片可能包含需要翻译的文本
- 无耦合 : 不强制使用任何 SaaS，但集成是可能的
- 易于与 Crowdin 一起使用 : 多个 Docusaurus 1 网站使用 Crowdin，应该能够迁移到 v2
- 良好的 SEO 默认值 : 我们为您设置有用的 SEO 头部，例如
hreflang - RTL 支持 : 支持从右到左阅读的语言环境（阿拉伯语、希伯来语等），并且易于实现
- 默认翻译 : 经典主题标签已为您翻译成多种语言
展示
在发布之前，我们与一些志愿者合作 试用了 i18n 支持 。
Jest：升级 Docusaurus
我们已经使 升级 翻译后的 Docusaurus 1 网站 到 Docusaurus 2 成为可能。
使用 Docusaurus 1 和 Crowdin 的 Jest 就是其中一个网站。
Docusaurus 2 的迁移成功，新网站现已部署到生产环境中（ 公告文章 ）。
[! Jest 的日语网站首页](https://jestjs.io)
Redwood：采用 Docusaurus
Redwood 是一个 React 全栈 Jamstack 框架。
他们正在寻找一个创建 国际化学习平台 的解决方案，并成为 learn.redwoodjs.com 的 Docusaurus 2 i18n 早期采用者，使用 Crowdin 将其翻译成法语。
[! Redwood 的法语文档页面](https://learn.redwoodjs.com/)
Datagit：使用 LTR 支持
i18n 系统应该适用于任何语言，包括 从右到左的语言 。
Datagit.ir 使用波斯语，一个简单的配置选项能够 翻转 Docusaurus 主题 以添加所需的从右到左支持。
[! Datagit 的波斯语网站，一种从右到左的语言。侧边栏出现在窗口右侧，目录出现在左侧。](https://datagit.ir/)
结论
我们真诚地希望您能采用并喜欢新的 i18n 支持。
此功能并非易事，我们要感谢所有参与此过程的人：
- Alexey 帮助使 i18n 支持更全面，甚至比 v1 更好
- Simen 志愿参与并支持 Jest 迁移
- Claire 在新的 Redwood 平台上采用 Docusaurus 2 并提供许多反馈
- Massoud 审核我在 LTR 上的工作并在 Datagit 上采用它
- Crowdin 为他们的支持和改进其翻译 SaaS 的意愿
- Docusaurus 社区 感谢你们的耐心，并在 GitHub 上提供了许多有用的反馈
感谢您的阅读。
🙏 请将您全新的 i18n 网站添加到我们的 展示页面 。我们在此接受任何经过打磨的 Docusaurus 网站，我们正在进行 重新设计 ，允许您按功能筛选网站。