页面配置

如无特殊说明,本页内容均写在front-matter中。

Front-matter

Front-matter 是文件最上方以 --- 分隔的区域,用于指定个别文件的变量。【详见官方文档】

字段含义值类型默认值
layout布局模版String-
title标题String-
date创建时间Date文件创建时间
updated更新日期Date文件修改时间
comments开启评论Booltrue
permalink覆盖文章网址String-
music内部音乐控件详见【music】-
keywords页面关键词String-
description页面描述String-

layout=post时特有的字段:

字段含义值类型默认值
categories分类String, Array-
tag标签String, Array-
toc是否生成目录Booltrue
excerpt文章摘要String-
popular_posts显示推荐文章Booltrue
mathjax是否渲染公式Bool, Stringfalse
top是否置顶Boolfalse
thumbnail缩略图Stringfalse

layout=links时特有的字段:

字段含义值类型默认值
links友链详见【links】-

布局模板

取值含义
page独立页面
post文章页面
category分类页面
tag标签页面
links友链页面

创建分类页面

source/创建分类页面文件夹,建议名为categories,在文件夹中创建md文件,内容为:

1
2
3
4
---
layout: category
title: 所有分类
---

创建标签页面

source/创建标签页面文件夹,建议名为tags,在文件夹中创建md文件,内容为:

1
2
3
4
---
layout: tags
title: 所有标签
---

创建友链页面

在博客的source/路径下新建一个名为friends或者其它名字的文件夹,这个文件夹的名字就是你的友链的path。然后在里面新建一个index.md文件,写入如下内容:

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
26
27
28
29
---
layout: links # 必须
title: 我的朋友们 # 可选,这是友链页的标题
links:
- group: 技术大佬
icon: fas fa-user-tie
items:
- name: # 博客名
avatar: # 头像链接
url: # 博客链接
backgroundColor: '#3E74C9' # 卡片背景颜色
textColor: '#fff' # 卡片文字颜色
tags: # 标签
- 标签1
- 标签2
- group: 分组2
icon: fas fa-user-tie
items:
- name: # 博客名
avatar: # 头像链接
url: # 博客链接
backgroundColor: '#3E74C9' # 卡片背景颜色
textColor: '#fff' # 卡片文字颜色
tags: # 标签
- 标签1
- 标签2
---

这里可以写友链页面下方的文字备注,例如自己的友链规范、示例等。

文章置顶

在Front-matter中设置以下值:

1
top: true

如果想自定义置顶标签的文字,可以直接设置为字符串,例如:

1
top: 近期更新

如果想隐藏置顶标签,找到或者添加以下值:

1
2
meta:
top: false

文章分类

多个分类有两种关系,一种是层级(等同于文件夹),一种是并列(等同于标签)。

多级分类

1
categories: [分类A, 分类B]

或者

1
2
3
categories:
- 分类A
- 分类B

并列分类

1
2
3
categories:
- [分类A]
- [分类B]

多级+并列分类

1
2
3
categories:
- [分类A, 分类B]
- [分类C, 分类D]

专属BGM

标题右边显示迷你音乐播放器,支持的字段有:servertypeid,取值详见【第三方服务 -> APlayer】。

示例

1
2
3
4
5
6
7
---
music:
enable: true # true(文章内和文章列表都显示) internal(只在文章内显示)
server: netease # netease(网易云音乐)tencent(QQ音乐) xiami(虾米) kugou(酷狗)
type: song # song (单曲) album (专辑) playlist (歌单) search (搜索)
id: 26664345 # 歌曲/专辑/歌单 ID
---

实际效果见:《文章专属BGM》

文章摘要

第一优先级是寻找正文中的<!--more-->,其前面的为摘要,可以显示在文章列表中,后面的是正文。
如果没有,则寻找Front-matter中的excerpt字段,以其为摘要。
如果还没有,就没有摘要,文章列表会显示全文。

如果使用<!-- more -->来实现摘要,则<!-- more -->前后一定要有空行,不然可能导致显示错位。

1
2
3
4
5
这是摘要

<!-- more -->

这是正文

是否开启渲染MathJax

取值含义
false不渲染,默认值
true渲染
internal只在文章内部渲染,文章列表中不渲染
1
2
3
---
mathjax: true
---

如果公式仍无法正确渲染可以阅读@MicDZ大神的这篇文章:《在material-x上使用KaTeX》

隐藏meta标签

文章顶部和底部的日期、分类、更新日期、标签、分享等属于meta标签。

在Front-matter找到或者新增meta,需要隐藏哪个meta标签将其置为false。例如:

1
2
3
4
5
6
7
8
9
10
11
12
13
---
title: 隐藏meta信息
categories: 教程
meta:
top: false # 这代表隐藏置顶标签,如果本文设置了置顶,就默默置顶
author: false # 这代表隐藏作者标签
date: false # 这代表隐藏日期标签,不显示发布日期
categories: false # 这代表隐藏分类标签,不显示文章分类
counter: false # 这代表隐藏阅读计数标签,不显示阅读次数
updated: false # 这代表隐藏更新日期标签,不显示文章更新日期
share: false # 这代表隐藏分享标签,不显示分享按钮
tags: false # 这代表隐藏文章标签,不显示文章的tags
---



评论