多言語対応

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 というファイルを作成できます。

注: 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 ファイルで確認できます。

さらに詳しく

• Hugo 多言語モード
• Hugo 多言語対応 パート1: コンテンツ翻訳
• Hugo 多言語対応 パート2: 文字列のローカライズ