Front-matter 前置数据

Front-matter 是一个放在文件前面被 --- 包裹的区块。例如

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

可以在 front-matter 中配置所有文章的配置项。下面是预定义的设置。

编写 front-matter 使用 YAML 格式。在 front-matter 不能使用制表符而要使用空格进行缩进，在冒号后面有一个空格。

设置 描述 默认值
layout 布局 post/page
title 标题
date 发布时间 文件创建日期
updated 最后修改时间 文件的最后时间
comments 对这篇文章开启评论 true
tags 标签 (对于独立页面不可用)
categories 分类 (对于独立页面不可用)
permalink 对于这篇文章覆盖默认的链接规则 文件名

分类和标签

Hexo 支持分类和标签。分类和标签只在文章中支持并且必须在 front-matter 中设置。例如:

1
2
3
4
5
categories:
- Diary
tags:
- PS3
- Games

分类和标签在其他系统中听起来是很相似的，但是他们在 Hexo 中是完全不同的。分类是分层的、有序的，这意味着 Foo, Bar 和 Bar, Foo 是不同的。 而标签是无序的、扁平的。

摘要

你可以在你文章中添加 <!-- more --> 来隐藏部分内容。列表页面只会显示第一个 <!-- more --> 和第二个 <!-- more --> 之间的内容。

1
2
3
4
5
...

<!-- more -->

...

模版

Hexo 会基于对应的模版创建新的文章。例如：

1
2
$ hexo new photo "My Gallery"
# => 文件将会被创建到 source/_posts/my-gallery.md

Hexo 会使用 scaffolds 文件夹下以 photo 命名的模版文件，如果模版不存在，会使用文章的模版。

例子

变量会被两个大括号包裹。例如：

1
2
3
4
layout: {{ layout }}
title: {{ title }}
date: {{ date }}
---

变量

变量 描述
layout 布局名称
title 文章标题
date 文件创建时间

资源文件夹

如果你将所有图片和其他资源放在 source 文件夹。你可以开启 post_asset_folder 设置。

1
post_asset_folder: true

开启此设置后，当你在新建一篇文章时会创建一个文件夹。你可以将所有这篇文章需要的资源文件放在这个文件夹里。这让在文章中使用图片变得非常简单。