hextra/exampleSite/content/docs/advanced/multi-language.zh-cn.md
2024-12-31 00:34:20 +00:00

2.3 KiB
Raw Blame History

title weight prev
多语言支持 1 /docs/advanced

Hextra 支持使用 Hugo 的多语言模式创建多语言网站。

启用多语言

要使我们的网站支持多语言,我们需要告诉 Hugo 支持的语言。我们需要在站点配置文件中添加:

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 作为法语翻译。

{{< filetree/container >}} {{< filetree/folder name="content" >}} {{< filetree/folder name="docs" state="open" >}} {{< filetree/file name="_index.md" >}} {{< filetree/file name="_index.fr.md" >}} {{< filetree/file name="_index.ja.md" >}} {{< /filetree/folder >}} {{< /filetree/folder >}} {{< /filetree/container >}}

注意Hugo 还支持通过内容目录进行翻译

翻译菜单项

要翻译导航栏中的菜单项,我们需要设置 identifier 字段:

menu:
  main:
    - identifier: documentation
      name: Documentation
      pageRef: /docs
      weight: 1
    - identifier: blog
      name: Blog
      pageRef: /blog
      weight: 2

并在相应的 i18n 文件中进行翻译:

documentation: Documentation
blog: Blog

翻译字符串

要翻译其他地方的字符串,我们需要将翻译添加到相应的 i18n 文件中:

readMore: Lire la suite

主题中使用的字符串列表可以在 i18n/en.yaml 文件中找到。

了解更多