多语言

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
    readMore: Lire la suite

    更多参考

    最后更新于