はじめに

Hugoで記事を書く際に、各投稿の先頭に投稿の情報を記載できます。
この情報のことをフロントマター（FrontMatter）と言います。

フォーマット

フロントマターはどんな記号で囲まれているかで、フォーマットの指定ができます。

  • TOML: +++
  • YAML: ---
  • JSON: {}

中身はkeyvalueのペアで指定できます。
TOMLの場合はdate = "2021-07-11"のように=で繋ぎます。

定義済み変数

フロントマターには定義済み変数と独自定義変数が存在します。
定義済み変数の一部は以下のようになっています。

  • date: 投稿日付
  • description: コンテンツの説明
  • draft: trueなら下書き段階
  • images: 対象のページに関連する画像のパス配列。_internal/twitter_cards.htmlなどで使用される
  • keywords: メタキーワード
  • lastmod: 最終更新日付
  • linkTitle: コンテンツのリンク生成時に使用されるURL。Hugoはtitleの前にlinkTitleを使用する
  • series: ページが属するシリーズ名
  • slug: 出力URLの末尾に表示される
  • weight: 順番を並べ替える際に、小さいほど優先される

独自定義変数

include_toc = true

このように定義した場合、.Params.include_tocで使用できます。

参考