关于Front-matter的用法
前言
写一篇文章最开始就是要知道Front-matter怎么用,关于Front-matter的一些内容和技巧
介绍
Front-matter 是文件最上方以 ---
分隔的区域,用于指定个别文件的变量,举例来说:
1 | --- |
预设
以下是预先定义的参数,您可在模板中使用这些参数值并加以利用。
参数 | 描述 | 默认值 |
---|---|---|
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 | categories: |
会使分类Life
成为Diary
的子分类,而不是并列分类。
如果你需要为文章添加多个分类,可以尝试以下 list 中的方法。
1 | categories: |
此时这篇文章同时包括三个分类: PlayStation
和 Games
分别都是父分类 Diary
的子分类,同时 Life
是一个没有子分类的分类。
标签没有顺序性和层次性,只能设置为同级的。也就是说,标签只有一种用法:
1 | --- |
这样会被解析为 PlayStation
、Games
、Diary,Life
三个并列标签。
(已尝试:直接tags:A 、B就行)
其他
有用到的话,详见主题指南