跳到主要内容

翻译你的站点

让我们把 docs/intro.md 翻译成法语。

配置 i18n​

修改 docusaurus.config.js，添加对 fr 语言的支持：

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

翻译一篇文档​

把 docs/intro.md 文件复制到 i18n/fr 文件夹：

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

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

将 i18n/fr/docusaurus-plugin-content-docs/current/intro.md 翻译成法语。

启动本地化站点​

以法语语言启动站点：

npm run start -- --locale fr

本地化站点可通过 http://localhost:3000/fr/ 访问，「Getting Started」页面已被翻译。

警告

开发模式下，一次只能使用一种语言。

添加语言下拉菜单​

为了在语言之间流畅切换，可以添加一个语言下拉菜单。

修改 docusaurus.config.js 文件：

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

导航栏中现在会出现语言下拉菜单：

Locale Dropdown

构建本地化站点​

为指定语言构建站点：

npm run build -- --locale fr

或者一次性构建包含所有语言的站点：

npm run build