テーマ コンポーネント

theme:
- my-shortcodes
- base-theme
- hyde

theme = ['my-shortcodes', 'base-theme', 'hyde']

{
   "theme": [
      "my-shortcodes",
      "base-theme",
      "hyde"
   ]
}

これをネストして、テーマ コンポーネント自身が自身の hugo.toml (テーマの継承) にテーマ コンポーネントを含めることもできます。¹

上記の hugo.toml でのテーマ定義の例では、左から右へ優先順位をつけた 3 つのテーマコンポーネントを持つテーマを作成します。

任意のファイルやデータ入力などに対して、Hugo はまずプロジェクトを探し、次に my-shortcode 、base-theme、そして最後に hyde を探します。

Hugo は、ファイルの種類に応じて、以下の 2 つの異なるアルゴリズムを使用してファイル システムをマージします。

• i18n および data ファイルの場合、Hugo はファイル内の翻訳 ID とデータ キーを使用して深くマージします。
• static、layouts (テンプレート)、および archetypes ファイルの場合、これらはファイル レベルでマージされます。 したがって、一番左のファイルが選択されます。

上記の theme 定義で使用する名前は /your-site/themes 内のフォルダーと一致しなければなりません。たとえば、 /your-site/themes/my-shortcodes です。これを改善し、 URL スキームを取得して、これを自動的に解決できるようにする計画があります。

また、テーマの一部であるコンポーネントは、独自の設定ファイル、たとえば hugo.toml を持つことができることに注意してください。現在、テーマ コンポーネントが設定できる内容には、いくつかの制限があります。

• params (global および language ごと)
• menu (global および language ごと)
• outputformats および mediatypes

ここでも同じルールが適用されます。つまり、同じ ID を持つ一番左のパラメータ/メニューなどが優先されます。 上記にはいくつかの隠れた実験的な名前空間のサポートがあり、将来的に改善する予定ですが、テーマの作成者は名前の衝突を避けるために独自の名前空間を作成することが推奨されます。