Front-matter

Front Matterは、ファイルの先頭に配置されるYAMLまたはJSONのブロックで、記事の設定のために使用されます。 YAMLの場合は三つのハイフン、JSONの場合は三つのセミコロンで終了します。

YAML

---
title: Hello World
date: 2013/7/13 20:46:25
---

JSON

"title": "Hello World",
"date": "2013/7/13 20:46:25"
;;;

設定とデフォルト値

設定	説明	デフォルト
`layout`	レイアウト	`config.default_layout`
`title`	タイトル	ファイル名（記事のみ）
`date`	公開日	ファイル作成日
`updated`	更新日	ファイル更新日
`comments`	記事へのコメント機能を有効にする	`true`
`tags`	タグ（ページには利用不可）
`categories`	カテゴリ（ページには利用不可）
`permalink`	記事のデフォルトパーマリンクを上書き。パーマリンクは`/`または`.html`で終わるべき	`null`
`excerpt`	プレーンテキストでのページの抜粋。テキストのフォーマットにはこのプラグインを使用
`disableNunjucks`	有効にするとNunjucksタグ`{{ }}`/`{% %}`とタグプラグインのレンダリングを無効にする	false
`lang`	自動検出を上書きする言語を設定	`_config.yml`から継承
`published`	記事を公開するか？	`_posts`配下の記事では`true`、`_draft`配下の記事では`false`

レイアウト

デフォルトのレイアウトはpostです。これは_config.ymlのdefault_layout設定に従います。記事やページでレイアウトが無効にされた場合（layout: false）、テーマでは処理されませんが、任意のレンダラーによるレンダリングは行われます。例えば記事やページがMarkdownで書かれ、Markdownレンダラー（デフォルトのhexo-renderer-markedなど）がインストールされている場合はHTMLにレンダリングされます。

タグプラグインは、disableNunjucks設定やレンダラーによって無効にされない限り、レイアウトに関わらず常に処理されます。

カテゴリーとタグ

カテゴリーとタグは記事でのみサポートされています。カテゴリーは指定された順に、記事に対する階層やサブ階層として機能します。タグは同じ階層レベルで定義されるため、指定される順序は重要ではありません。

例

categories:
  - Sports
  - Baseball
tags:
  - Injury
  - Fight
  - Shocking

複数のカテゴリ階層を適用したい場合は、カテゴリ名のリストを単一の名前の代わりに使用します。 Hexoが記事でこのように定義されたカテゴリを見つけると、その記事の各カテゴリを独自の独立した階層として扱います。

例

categories:
  - [Sports, Baseball]
  - [MLB, American League, Boston Red Sox]
  - [MLB, American League, New York Yankees]
  - Rivalries