前置内容 | Hexo 中文

前置内容是文件开头的一段 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