hugoサイトの多言語化

hugoの多言語化機能は、 Multilingual Modeに解説があります。

ただしマニュアルは複数のシナリオ向けのリファレンスになっていため、あらかじめ構成を決める必要があります。

各国語サイトを個別サイトとして独立させる、または１つのサイトの各国語ページ構成にする、のいずれかを選択
- 個別サイトのバリエーションとして、独立したサブディレクトリ構成も可能
記事の原稿を言語別に分ける、または１つのディレクトリに混在させる、のいずれかを選択

各国語サイトの分割

言語設定はconfigのlanguagesセクションに記述します。
詳細に設定しない場合、hugoは１つのサイト内に多言語ページを持つ構成で生成する挙動となります。

各国語のサイトを個別に切り分ける構成にするには、 Configure Multilingual Multihostの設定が必要です。

[languages]
  [languages.en]
    baseURL = 'https://example.com'
  [languages.fr]
    baseURL = 'https://example.fr'

上の例ではbaseURLにドメインを指定していますが、同一ドメインのサブディレクトリを指定する構成も可能です。
この設定でhugoコマンドを実行すると、public/ディレクトリにen/とfr/の2つのサブディレクトリが生成されます。

１サイトに統合すると配信はシンプルです。
各国語サイトを作るとなると、その言語を用いる文化圏に近い場所からホストしたいケースが多くなるため、地理的に分散構成をとるのであれば複数サイト構成の必要性が高まります。

原稿レイアウトのデフォルトは、各国語の原稿を単一ディレクトリに置く想定になっています。たとえば、sample.en.mdとsample.fr.mdのようにサブの拡張子に言語名を指定して、同じディレクトリに置きます。

言語別にディレクトリを分けたい場合、 Translation by content directoryの追加設定が必要です。

[languages]
  [languages.en]
    contentDir = 'content/english'
  [languages.fr]
    contentDir = 'content/french'

デフォルトではcontent/ディレクトリ以下に原稿を置きますが、contentDirを分割した場合、各サブディレクトリに同じ構成で原稿を置きます。
ディレクトリ名・ファイル名が一致するものが、翻訳のあるコンテンツとして認識されます。

ここまでの設定により、似ているPathのファイル間でhugoが翻訳版を認識しますが、それらのリンク表示は Reference the Translated Contentを参考にテンプレートに実装します。

{{ if .IsTranslated }}
<ul>
  {{ range .Translations }}
  <li>
    <a href="{{ .Permalink }}">{{ .Lang }}</a>
  </li>
  {{ end }}
</ul>
{{ end }}

あるページに対応する翻訳ページは、Pageオブジェクトの.Translationsに入ります。
特定の言語にしか存在しないページは、.Translationsが空になりリンク表示をスキップします。

hugoのconfigでは、title変数にサイト名称を設定できます。これらの変数は、各言語セクションにも定義でき言語別の設定が優先されます。
テンプレートから参照する変数も言語別に指定可能です。

言語設定と連動して、多言語メッセージカタログも利用できます。テンプレートで以下のようにi18n関数を呼ぶと、該当する言語のラベルに置換されます。

{{ i18n "some_catalog" }}

言語カタログデータは、テーマのトップディレクトリにi18nディレクトリを作成し、i18n/en.tomlのように言語別のファイルを置きます。

言語カタログは以下のような書式になっています。otheerは単数形・複数形などを識別するkeyになっており、区別しない場合はotherがデフォルト参照されるようです。

[some_catalog]
other = "Some meesage in english"

なお、カタログの言語選択は冒頭の言語コードをもとに選択されます。マニュアルでは"en-US"といった例で紹介されていますが、“en-US"という言語コードを定義した場合に参照されます。

i18nの詳細は Translation of Stringsにマニュアルがあります。単純な置換だけでなく、ページ変数を利用したテンプレートも作成できます。

⁋ 2022/05/16↻ 2024/12/18