Front-matter

Front-matter 是 markdown 文件最上方以---分隔的区域，用于指定个别档案的变数。

  • Page Front-matter 用于页面配置
  • Post Front-matter 用于文章页配置

如果标注可选的参数，可根据自己需要添加，不用全部都写

Page Front-matter：

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
---
title:
date:
updated:
type:
comments:
description:
keywords:
top_img:
mathjax:
katex:
aside:
aplayer:
highlight_shrink:
---
写法解释
title页面标题，必需项
date页面创建日期，必需项
type标签、分类和友情链接三个页面需要配置，必需项
updated页面更新日期，可选项
description页面描述，可选项
keywords页面关键字，可选项
comments显示页面评论模块（默认为true），可选项
top_img页面顶部图片，可选项
mathjax显示MathJax（当设置mathjax的per_page为false时，才需要配置，默认为false），可选项
kates显示Katex（当设置katex的per_page为false时，才需要配置，默认为false），可选项
aside显示侧边栏（默认为true），可选项
aplayer在需要的页面加载APlayer的JS和CSS，请参考文章下面的音乐配置，可选项
highlight_shrink配置代码框是否展开（true/false），默认为设置中highlight_shrink的配置，可选项

Post Front-matter：

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
---
title:
date:
updated:
tags:
categories:
keywords:
description:
top_img:
comments:
cover:
toc:
toc_number:
toc_style_simple:
copyright:
copyright_author:
copyright_author_href:
copyright_url:
copyright_info:
mathjax:
katex:
aplayer:
highlight_shrink:
aside:
---
写法解释
title文章标题，必需项
date文章创建日期，必需项
updated文章更新日期，可选项
tags文章标签，可选项
categories文章分类，可选项
keywords文章关键字，可选项
description文章描述，可选项
top_img文章顶部图片，可选项
cover文章缩略图（如果没有设置top_img，则文章页顶部将显示缩略图），可设为false/图片地址/留空，可选项
comments显示文章评论模块（默认为true），可选项
toc显示文章TOC（默认为设置中toc的enable配置），可选项
toc_number显示toc_number（默认为设置中toc的number配置），可选项
toc_style_simple显示简洁模式的TOC，可选项
copyright显示文章版权模块（默认为设置中post_copyright的enable配置），可选项
copyright_author文章版权模块的文章作者，可选项
copyright_author_href文章版权模块的文章作者链接，可选项
copyright_url文章版权模块的文章链接，可选项
copyright_info文章版权模块的版权声明文字，可选项
mathjax显示MathJax（当设置mathjax的per_page为false时，才需要配置，默认为false），可选项
katex显示Katex（当设置katex的per_page为false时，才需要配置，默认为false），可选项
aplayer在需要的页面加载APlayer的JS和CSS，请参考文章下面的音乐配置，可选项
highlight_shrink配置代码框是否展开（true/false），默认为设置中highlight_shrink的配置，可选项
aside显示侧边栏（默认为true），可选项