Front-matter 是檔案最上方以 --- 分隔的區域,用於指定個別檔案的變數,舉例來說:
|
以下是預先定義的設定,您可在模板中取得這些設定值並加以利用。
| 設定 | 描述 | 預設值 |
|---|---|---|
layout | 佈局 | config.default_layout |
title | 標題 | 文章的檔案名 |
date | 建立日期 | 檔案建立日期 |
updated | 更新日期 | 檔案更新日期 |
comments | 開啟文章的留言功能 | true |
tags | 標籤(不適用於分頁) | |
categories | 分類(不適用於分頁) | |
permalink | 覆蓋文章網址 | |
excerpt | 純文字的頁面摘要。使用這個外掛進行文字格式化。 | |
disableNunjucks | 當啟用時,禁止 Nunjucks 標籤 {{ }}/{% %} 以及標籤外掛的渲染功能 | |
lang | 設定語言並寫自動偵測 | 繼承自 _config.yml |
published | 文章是否發布 | 在 _posts 中的文章為 true;而在 _draft 中的文章則為 false |
佈局
依照 _config.yml 中所設定的 default_layout 值,預設的佈局為 post。當在文章中取消佈局 (layout: false),則不會為它套用主題。然而,這依然會在任意的渲染引擎 (renderer) 中渲染,若一個文章是用 Markdown 編寫且已經安裝了 Markdown 算圖引擎(如預設的hexo-renderer-marked),則會被渲染為 HTML。
無論任何佈局,標籤外掛一定會進行處理,除非禁止 disableNunjucks 的設定或是渲染引擎.
分類和標籤
分類和標籤只有文章才支援,您可以在 Front-matter 中設定。在其他系統中,分類和標籤可能聽起來很接近,但是在 Hexo 中有著決定性的差別:分類是有順序和階層性的,也就是說 Foo, Bar 不等於 Bar, Foo;而標籤沒有順序和階層。
categories: |
此外我們可以透過 list 來對一篇文章同時定義多個分類。
categories: |
JSON Front-matter
除了 YAML 外,你也可利用 JSON 來撰寫 Front-matter,只要將 --- 代換成 ;;; 即可。
"title": "Hello World", |