Front-matter

Front-matter 是檔案最上方以 --- 分隔的區域,用於指定個別檔案的變數,舉例來說:

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

以下是預先定義的設定,您可在模板中取得這些設定值並加以利用。

設定 描述 預設值
layout 佈局 config.default_layout
title 標題 文章的檔案名
date 建立日期 檔案建立日期
updated 更新日期 檔案更新日期
comments 開啟文章的留言功能 true
tags 標籤(不適用於分頁)
categories 分類(不適用於分頁)
permalink 覆蓋文章網址
excerpt Page excerpt in plain text. Use this plugin to format the text
disableNunjucks Disable rendering of Nunjucks tag {{ }}/{% %} and tag plugins when enabled
lang Set the language to override auto-detection Inherited from _config.yml
published Whether the post should be published For posts under _posts, it is true, and for posts under _draft, it is false

佈局

The default layout is post, in accordance to the value of default_layout setting in _config.yml. When the layout is disabled (layout: false) in an article, it will not be processed with a theme. However, it will still be rendered by any available renderer: if an article is written in Markdown and a Markdown renderer (like the default hexo-renderer-marked) is installed, it will be rendered to HTML.

Tag plugins are always processed regardless of layout, unless disabled by the disableNunjucks setting or renderer.

分類和標籤

分類和標籤只有文章才支援,您可以在 Front-matter 中設定。在其他系統中,分類和標籤可能聽起來很接近,但是在 Hexo 中有著決定性的差別:分類是有順序和階層性的,也就是說 Foo, Bar 不等於 Bar, Foo;而標籤沒有順序和階層。

categories:
- Diary
tags:
- PS3
- Games

此外我們可以透過 list 來對一篇文章同時定義多個分類。

categories:
- [Diary, PlayStation]
- [Diary, Games]
- [Life]

JSON Front-matter

除了 YAML 外,你也可利用 JSON 來撰寫 Front-matter,只要將 --- 代換成 ;;; 即可。

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