跳到主要内容

多语言支持

如果你希望站点支持多语言，可以启用 i18n 配置。

配置 i18n​

在 docusaurus.config.js 中添加语言：

docusaurus.config.js
export default {
  i18n: {
    defaultLocale: 'zh-Hans',
    locales: ['zh-Hans', 'en'],
  },
};

翻译文档​

复制文档到对应语言目录：

mkdir -p i18n/en/docusaurus-plugin-content-docs/current/

cp docs/intro.md i18n/en/docusaurus-plugin-content-docs/current/intro.md

然后翻译该文件内容。

启动指定语言​

npm run start -- --locale en

访问： http://localhost:3000/en/

警告

开发模式下同一时间只能启用一个语言。

添加语言切换​

在导航栏加入语言下拉：

docusaurus.config.js
export default {
  themeConfig: {
    navbar: {
      items: [
        {
          type: 'localeDropdown',
        },
      ],
    },
  },
};

构建多语言站点​

构建单一语言：

npm run build -- --locale en

构建全部语言：

npm run build