写在前面:本文以openfde-doc项目为例,介绍和记录将docusaurus网站国际化的过程。
1、在配置文件docusaurus.config.js中添加中文语言
i18n: {
defaultLocale: 'en',
locales: ['en','zh-CN'],
}, |
2、在导航栏添加多语言选项(docusaurus.config.js)
{
type: 'localeDropdown',
position: 'left',
persistLocale: true,
} |
3、翻译网站首页(src/pages/index.js)
4、初始化i18n文件夹
npm run write-translations -- --locale zh-CN |
5、把未翻译的md文件复制到简体中文文件夹中
mkdir -p i18n/zh-CN/docusaurus-plugin-content-docs/current
cp -r docs/** i18n/zh-CN/docusaurus-plugin-content-docs/current
mkdir -p i18n/zh-CN/docusaurus-plugin-content-blog
cp -r blog/** i18n/zh-CN/docusaurus-plugin-content-blog
mkdir -p i18n/zh-CN/docusaurus-plugin-content-pages
cp -r src/pages/**.md i18n/zh-CN/docusaurus-plugin-content-pages
cp -r src/pages/**.mdx i18n/zh-CN/docusaurus-plugin-content-pages |
6、启动简体中文站点,并查看翻译
npm run start -- --locale zh-CN |