Skip to content

国际化配置

Hugo Narrow 有良好的多语言支持,目前支持的语言如下:

  • ar:阿拉伯语
  • de:德语
  • en:英语
  • es:西班牙语
  • fr:法语
  • it:意大利语
  • ja:日语
  • ko:韩语
  • pt:葡萄牙语
  • ru:俄语
  • vi:越南语
  • zh-cn:简体中文
  • zh-tw:繁体中文

NOTE

翻译由 Agent 生成。

基础语言配置

hugo.yaml 中配置支持的语言:

yaml
# 基础语言设置
languageCode: en-US
defaultContentLanguage: en
defaultContentLanguageInSubdir: false

# 语言配置 语言切换按钮从此处读取支持切换的语言
languages:
  en:
    languageCode: en-US
    languageName: "English"
    weight: 1
  zh-cn:
    languageCode: zh-CN
    languageName: "简体中文"
    weight: 2
  ja:
    languageCode: ja-JP
    languageName: "日本語"
    weight: 3
  fr:
    languageCode: fr-FR
    languageName: "Français"
    weight: 4

语言切换配置

yaml
params:
  # 语言切换器设置
  showLanguageSwitch: true    # 显示语言切换器

多语言组织方式

若配置多语言站点,请根据下面两种方式配置多语言目录结构。

Hugo 支持两种主要的多语言文件组织方式:文件名翻译目录翻译。每种方式都有其优势和适用场景。

方式一:文件名翻译

文件结构

content/
├── posts/
│   ├── my-first-post.md
│   ├── my-first-post.zh-cn.md
│   ├── my-first-post.ja.md
│   └── my-first-post.fr.md
├── about/
│   ├── _index.md
│   ├── _index.zh-cn.md
│   ├── _index.ja.md
│   └── _index.fr.md
└── _index.md

方式二:目录翻译

文件结构

content/
├── en/
│   ├── posts/
│   │   └── my-first-post.md
│   ├── about/
│   │   └── _index.md
│   └── _index.md
├── zh-cn/
│   ├── posts/
│   │   └── my-first-post.md
│   ├── about/
│   │   └── _index.md
│   └── _index.md
├── ja/
│   ├── posts/
│   │   └── my-first-post.md
│   ├── about/
│   │   └── _index.md
│   └── _index.md
└── fr/
    ├── posts/
    │   └── my-first-post.md
    ├── about/
    │   └── _index.md
    └── _index.md