1 2 3 4 5
| title: Title date: YYYY-MM-DD HH:MM:SS tags: [tag1, tag2, ...] categories: category 1234
|
1 2 3 4 5 6 7
| title: 文章标题 date: 2018-03-01 21:46:12 tags: - 标签一 - 标签二 categories: 分类名(可以自定义)
|
Front-matter 选项详解
Front-matter
选项中的所有内容均为非必填的。但我仍然建议至少填写 title
、urlname
和 date
的值。
配置选项 |
默认值 |
描述 |
title |
Markdown 的文件标题 |
文章标题,强烈建议填写此选项 |
date |
文件创建时的日期时间 |
发布时间,强烈建议填写此选项,且最好保证全局唯一 |
author |
根 _config.yml 中的 author |
文章作者 |
img |
featureImages 中的某个值 |
文章特征图,推荐使用图床(腾讯云、七牛云、又拍云等)来做图片的路径.如: http://xxx.com/xxx.jpg |
top |
true |
推荐文章(文章是否置顶),如果 top 值为 true,则会作为首页推荐文章 |
cover |
false |
v1.0.2版本新增,表示该文章是否需要加入到首页轮播封面中 |
coverImg |
无 |
v1.0.2版本新增,表示该文章在首页轮播封面需要显示的图片路径,如果没有,则默认使用文章的特色图片 |
password |
无 |
文章阅读密码,如果要对文章设置阅读验证密码的话,就可以设置 password 的值,该值必须是用 SHA256 加密后的密码,防止被他人识破。前提是在主题的 config.yml 中激活了 verifyPassword 选项 |
urlname |
index |
文章访问路径,需要在Hexo根目录下_config.yml文件中使用permalink: :urlname/和permalink_defaults: |
urlname: index |
|
|
toc |
true |
permalink_defaults:是否开启 TOC,可以针对某篇文章单独关闭 TOC 的功能。前提是在主题的 config.yml 中激活了 toc 选项 |
mathjax |
false |
urlname: index 是否开启数学公式支持 ,本文章是否开启 mathjax,且需要在主题的 _config.yml 文件中也需要开启才行 |
summary |
无 |
文章摘要,自定义的文章摘要内容,如果这个属性有值,文章卡片摘要就显示这段文字,否则程序会自动截取文章的部分内容作为摘要 |
categories |
无 |
文章分类,本主题的分类表示宏观上大的分类,只建议一篇文章一个分类 |
tags |
无 |
文章标签,一篇文章可以多个标签 |
keywords |
文章标题 |
文章关键字,SEO 时需要 |
reprintPolicy |
cc_by |
文章转载规则, 可以是 cc_by, cc_by_nd, cc_by_sa, cc_by_nc, cc_by_nc_nd, cc_by_nc_sa, cc0, noreprint 或 pay 中的一个 |
注意:
- 如果
img
属性不填写的话,文章特色图会根据文章标题的 hashcode
的值取余,然后选取主题中对应的特色图片,从而达到让所有文章都的特色图各有特色。
date
的值尽量保证每篇文章是唯一的,因为本主题中 Gitalk
和 Gitment
识别 id
是通过 date
的值来作为唯一标识的。
- 如果要对文章设置阅读验证密码的功能,不仅要在 Front-matter 中设置采用了 SHA256 加密的 password 的值,还需要在主题的
_config.yml
中激活了配置。有些在线的 SHA256 加密的地址,可供你使用:开源中国在线工具、chahuo、站长工具。
- 您可以在文章 md 文件的 front-matter 中指定 reprintPolicy 来给单个文章配置转载规则