关于Front-matter的用法

发表于 2020-02-09更新于 2020-02-15字数统计 739阅读时长 4m

前言

写一篇文章最开始就是要知道Front-matter怎么用,关于Front-matter的一些内容和技巧

介绍

Front-matter 是文件最上方以 --- 分隔的区域,用于指定个别文件的变量,举例来说:

1
2
3
4
5
6
---
title: 关于Front-matter的用法
date: 2020-02-09 10:18:57
categories: 建站
tags: Front-matter
---

预设

以下是预先定义的参数,您可在模板中使用这些参数值并加以利用。

参数 描述 默认值
layout 布局
title 标题 文章的文件名
date 建立日期 文件建立日期
updated 更新日期 文件更新日期
comments 开启文章的评论功能 true
tags 标签(不适用于分页)
categories 分类(不适用于分页)
permalink 覆盖文章网址
keywords 仅用于 meta 标签和 Open Graph 的关键词(不推荐使用)
excerpt 指定文章摘要

下面几种 Front-Matter 属性在 Hexo 文档中并没有出现,但在 Hexo 提供的主题单元测试库中出现。这些属性如下:

参数 描述 默认值
link 链接(当点击该文章标题时, 打开所指定的链接地址 )
photos 图片 ( 指定一些图片,Stun 主题将其显示在文章最顶部)
top_image 用于设置某篇文章顶部的大图
toc 文章是否启用目录。会覆盖主题配置文件中的全局设置
quicklink 是否在浏览器空闲时间预取可视区内的链接,以加快后续页面的加载速度
math 是否需要解析数学公式
reward 文章是否启用打赏功能
copyright 文章是否启用版权信息

下面是安装某些插件后,可以设置的几种 Front-Matter 属性

参数 描述 默认值
top 文章是否置顶
no-emoji 是否解析文章中的 emoji 代码

具体参数

分类 和 标签

​ 分类和标签在 Hexo 中两者有着明显的差别:分类具有顺序性和层次性,也就是说 Foo, Bar 不等于 Bar, Foo

注:分类方法的分歧

​ WordPress 支持对一篇文章设置多个分类,而且这些分类可以是同级的,也可以是父子分类。Hexo 不支持指定多个同级分类。下面的指定方法:

1
2
3
categories:
- Diary
- Life

会使分类Life成为Diary的子分类,而不是并列分类。

如果你需要为文章添加多个分类,可以尝试以下 list 中的方法。

1
2
3
4
categories:
- [Diary, PlayStation]
- [Diary, Games]
- [Life]

此时这篇文章同时包括三个分类: PlayStationGames 分别都是父分类 Diary 的子分类,同时 Life 是一个没有子分类的分类。

标签没有顺序性和层次性,只能设置为同级的。也就是说,标签只有一种用法:

1
2
3
4
5
6
---
tags:
- PlayStation
- Games
- [Diary, Life]
---

这样会被解析为 PlayStationGamesDiary,Life 三个并列标签。

(已尝试:直接tags:A 、B就行)

其他

​ 有用到的话,详见主题指南