frontmatter

Front-matter は、ファイルの先頭にある YAML または JSON のブロックで、記事の設定を構成するために使用されます。 Front-matter は、YAML で記述する場合は3つのダッシュ、JSON で記述する場合は3つのセミコロンで終了します。

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