Skip to content

多语言支持

Addo.Zhang edited this page Jun 15, 2022 · 3 revisions

多语言的支持参考了文档 Translation by content directory ,每个语种使用独立的目录。

语言使用简写:

  • en: English
  • zh: Chinese
  • fr: French
  • jp: Japanese

参考 Adding release-specific docs 指南为文档增加新语种支持。

增加新语种

  1. 复制 content/en 目录并重名,比如中文使用 content/zh,然后对文档内容进行翻译。
  2. 修改 config.toml 中的 languages 部分,增加新语种的配置;同时在 themes/dosmy/i18n 中创建对应语种的 toml 文件,以便支持站点元素的国际化。

新增/更新文档

新增/更新文档,大多数情况下首先是针对英文文档。这种场景下,操作会稍微复杂。

新增文档

完成英文完档的编写之后,手动复制该文档到各语种的目录,并为其他语种的翻译创建相应的 issue。此时,静态编译之后其他语种的文档中该文档会展示英文内容。待翻译完成后,才会展示响应的翻译。

如果仅编写的英文的文档,该文档只会在英文文档中展示,在其他语言的侧边栏中并不会出现。

更新文档

更新完英文文档之后,为其他语种的翻译创建相应的 issue。在翻译完成之前,其他语种文档仍展示旧的内容。

Clone this wiki locally