forked from openservicemesh/osm-docs
-
Notifications
You must be signed in to change notification settings - Fork 4
多语言支持
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 指南为文档增加新语种支持。
- 复制
content/en
目录并重名,比如中文使用content/zh
,然后对文档内容进行翻译。 - 修改
config.toml
中的languages
部分,增加新语种的配置;同时在themes/dosmy/i18n
中创建对应语种的toml
文件,以便支持站点元素的国际化。
新增/更新文档,大多数情况下首先是针对英文文档。这种场景下,操作会稍微复杂。
完成英文完档的编写之后,手动复制该文档到各语种的目录,并为其他语种的翻译创建相应的 issue。此时,静态编译之后其他语种的文档中该文档会展示英文内容。待翻译完成后,才会展示响应的翻译。
如果仅编写的英文的文档,该文档只会在英文文档中展示,在其他语言的侧边栏中并不会出现。
更新完英文文档之后,为其他语种的翻译创建相应的 issue。在翻译完成之前,其他语种文档仍展示旧的内容。