跳到主要内容
版本：1.4.0

翻译

Yunikorn网站采用Docusaurus管理文档。 Docusaurus国际化系统(i18n)允许开发人员翻译文档。 为网站添加新的语言翻译时，开发者应进行如下操作。

修改docusaurus.config.js以支持新语言​

假设通过新语言关键字进行翻译。 预期的结果会像这个图(右上方的<新语言关键字>為test)。 翻译结果

当前的Yunikorn网站包括en和zh-cn文档。 如果开发者想添加一个新的带有新语言关键字的翻译，如fr, jp。 则开发者需要修改docusaurus.config.js中的i18n栏位。

i18n: {
    defaultLocale: 'en',
    locales: ['en', 'zh-cn', '<新语言关键字>'],
    localeConfigs: {
      en: {
        label: 'English',
      },
      "zh-cn": {
        label: '中文',
      },
      "<新语言关键字>": {
        label: 'test',
      }
    },
  },

更新local-build.sh中的帮助信息​

将新语言关键字添加到print_usage函数的语言环境列表中。

Usage: $(basename "$0") run [locale] | build | clean | help
    run     build the website, and launch the server in a docker image.
            a locale can be specified, currently supported: "en", "zh-cn", "<新语言关键字>"

将最新文件复制到i18n资料夹​

mkdir -p i18n/<新语言关键字>/docusaurus-plugin-content-docs/current
cp -r docs/** i18n/<新语言关键字>/docusaurus-plugin-content-docs/current
mkdir -p i18n/<新语言关键字>/docusaurus-plugin-content-pages
cp -r src/pages/** i18n/<新语言关键字>/docusaurus-plugin-content-pages
mkdir -p i18n/<新语言关键字>/docusaurus-theme-classic

在sidebar.json和footer.json中添加翻译后的信息​

在docusaurus-theme-classic资料夹中创建sidebar.json和footer.json档案。 例如，添加的footer.json内容如下。

{
    "link.item.label.Get Involved": {
        "message": "参与"
    },
    "link.title.Code Repositories": {
        "message": "代码库"
    },
    "link.item.label.People": {
        "message": "人们"
    },   
    "link.title.Blog": {
        "message": "博客"
    },
    "link.title.Community": {
        "message": "社区"
    }
}

链接img、assest与styles.module.css​

在i18n/new language keyword/docusaurus-plugin-content-pages中创建链接文件。

# 清理重复文件
rm -rf img
rm styles.module.css
# 链接
ln -s ../../../static/img
ln -s ../../../src/pages/styles.module.css

在i18n/new language keyword/docusaurus-plugin-content-docs/current中创建链接文件。

# 清理重复文件
rm -rf assests
# 链接
ln -s ../../../../docs/assets

采用相对路径​

src/pages/index.js中有部分图片url采用绝对路径，采用绝对路径会导致png丢失。 开发人员需要确保/i18n/new language keyword/docusaurus-plugin-content-pages/index.js中的图链接有效。 例如，在index.js中有一个resource-scheduling.png图像，图像链接是/img/resource-scheduling.png。

/img/resource-scheduling.png -> ./img/resource-scheduling.png

测试​

./local-build.sh run <新语言关键字>

建设网站