はじめに

ページ毎の変数は、 フロントマター で定義されるか、コンテンツのファイルの場所から生成されるか、コンテンツ本体から生成されます。
この記事では、ページレベル変数のリストの一部をまとめました。

ページ変数

多くの変数は、 フロントマター で定義されている変数です。
その中の一部を説明します。

  • .Kind: page、home、section、taxonomy、term、RSS、sitemap、robotsTXT、404などページの種類
  • .LinkTitle: ページのリンクを設定。設定されていれば、titleより優先的に使用される
  • .Next: 次のregular page
  • .Prev: 前のregular page
  • .Site: Site Variables
  • .Type: Content Types タイプが未設定ならcontent/<TYPE>のフォルダ名がタイプになる

.Pages変数

regular pageはpostページかcontentページです。
一方、list pageはregular pageか他のlist pageを一覧化します。
（例: homepage、section page、taxonomy term page、taxonomypage）
記事をツリー状にした場合、末端がregular page、幹がlist pageです。

  • .Site.Pages: サイト内の全ページ。セクションやtaxonomyページも含む
  • .Site.RegularPages: サイト内の全通常ページ

以下の変数は、現在のスコープだけを返します。

  • .Pages: 現在のページのスコープのregular pageとセクションページ。.Data.Pagesのエイリアスです。(第一階層のみ)
  • .RegularPages: 現在のページのスコープのregular page。入れ子になっているものは除く
  • .RegularPagesRecursive: 現在のページ以下の全てのregular page。入れ子になっているものを含む

regular pageから.Pagesや.RegularPagesを使用しても、空が返ります。

セクション変数と関数

  • .Parent: ページのセクションや、セクションの親セクション
  • .Section: 現在の記事が属するセクション
  • .Sections: 現在の配下のセクション

参考