多语言支持
Hextra 支持使用 Hugo 的多语言模式创建多语言网站。
启用多语言
要使我们的网站支持多语言,我们需要告诉 Hugo 支持的语言。我们需要在站点配置文件中添加:
hugo.yaml
defaultContentLanguage: en
languages:
en:
languageName: English
weight: 1
fr:
languageName: Français
weight: 2
ja:
languageName: 日本語
weight: 3
通过文件名管理翻译
Hugo 支持通过文件名管理翻译。例如,如果我们有一个英文文件 content/docs/_index.md
,我们可以创建一个文件 content/docs/_index.fr.md
作为法语翻译。
-
- _index.md
- _index.fr.md
- _index.ja.md
注意:Hugo 还支持通过内容目录进行翻译。
翻译菜单项
要翻译导航栏中的菜单项,我们需要设置 identifier
字段:
hugo.yaml
menu:
main:
- identifier: documentation
name: Documentation
pageRef: /docs
weight: 1
- identifier: blog
name: Blog
pageRef: /blog
weight: 2
并在相应的 i18n 文件中进行翻译:
i18n/fr.yaml
documentation: Documentation
blog: Blog
翻译字符串
要翻译其他地方的字符串,我们需要将翻译添加到相应的 i18n 文件中:
i18n/fr.yaml
readMore: Lire la suite
主题中使用的字符串列表可以在 i18n/en.yaml
文件中找到。