以后如果修改任何主题配置，都只需修改_config.fluid.yml的配置即可。
1
2
| navbar:
blog_title: 博客标题
DTS
|
导航
1
2
3
4
5
| navbar:
menu:
- { key: 'home', link: '/', icon: 'iconfont icon-home-fill' }
- { key: 'tag', link: '/tags/', icon: 'iconfont icon-tags-fill' }
- { key: 'about', link: '/about/', icon: 'iconfont icon-user-fill', name: '联系我' }
SAS
|
二级菜单
1
2
3
4
5
6
7
8
9
10
| menu:
- {
key: '文档',
icon: 'iconfont icon-books',
submenu: [
{ key: '主题博客', link: 'https://hexo.fluid-dev.com/' },
{ key: '配置指南', link: 'https://hexo.fluid-dev.com/docs/guide/' },
{ key: '图标用法', link: 'https://hexo.fluid-dev.com/docs/icon/' }
]
}
SAS
|
摘要，默认开启
1
2
3
| index:
auto_excerpt:
enable: true
YAML
|
若要手动指定摘要，使用 <!-- more --> MD文档里划分，如：
或者在 front-matter (opens new window)里设置 excerpt 字段，如：
1
2
3
4
| ---
title: 这是标题
excerpt: 这是摘要
---
YAML
|
文章跳转方式
1
2
| index:
post_url_target: _self
DTS
|
文章信息
可配置隐藏包括发布时间、分类、标签。
经过测试，如果首页的文章列表中没有略缩图和摘要，标题+文章信息的显示方式会使页面过于拥挤，所以给出此项配置供喜欢首页只显示文章标题的同学使用。
1
2
3
4
5
| index:
post_meta:
date: true
category: true
tag: true
YAML
|
隐藏文章
如果想把某些文章隐藏，不在首页和其他归档分类页里展示，可以在文章开头 front-matter (opens new window)中配置 hide: true 属性。
1
2
3
4
5
6
7
| ---
title: 文章标题
index_img: /img/example.jpg
date: 2019-10-10 10:00:00
hide: true
---
以下是文章内容
YAML
|
隐藏后依然可以通过文章链接访问，所以可以用于一些需要链接跳转的特殊文章。
归档文章
如果只是想让文章在首页隐藏，但仍需要在归档分类页里展示，可以在文章开头 front-matter (opens new window)中配置 archive: true 属性。
1
2
3
4
5
6
7
| ---
title: 文章标题
index_img: /img/example.jpg
date: 2019-10-10 10:00:00
archive: true
---
以下是文章内容
YAML
|
文章排序
如果想手动将某些文章固定在首页靠前的位置，可以在安装 hexo-generator-index >= 2.0.0 版本的情况下，在文章开头 front-matter (opens new window)中配置 sticky 属性：
1
2
3
4
5
6
7
| ---
title: 文章标题
index_img: /img/example.jpg
date: 2019-10-10 10:00:00
sticky: 100
---
以下是文章内容
YAML
|
sticky 数值越大，该文章越靠前，达到类似于置顶的效果，其他未设置的文章依然按默认排序。
当文章设置了 sticky 后，主题会默认在首页文章标题前增加一个图标，来标识这是一个置顶文章，你可以通过主题配置去关闭或修改这个功能：
1
2
3
4
5
| index:
post_sticky:
enable: true
icon: 'iconfont icon-top'
icon 可以通过自定义图标修改为其他图标。
YAML
|
文章在首页的封面图
对于单篇文章，在文章开头 front-matter (opens new window)中配置 index_img 属性。
1
2
3
4
5
6
7
| ---
title: 文章标题
tags: [Hexo, Fluid]
index_img: /img/example.jpg
date: 2019-10-10 10:00:00
---
以下是文章内容
YAML
|
和 Banner 配置相同，/img/example.jpg 对应的是存放在 /source/img/example.jpg 目录下的图片（目录也可自定义，但必须在 source 目录下）。
也可以使用外链 Url 的绝对路径。
如果想统一给文章设置一个默认图片（文章不设置 index_img 则默认使用这张图片），可在主题配置中设置：
1
2
| post:
default_index_img: /img/example.jpg
DTS
|
当 default_index_img 和 index_img 都为空时，该文章在首页将不显示图片。
文章页顶部大图
默认显示主题配置中的 post.banner_img，如需要设置单个文章的 Banner，在 front-matter (opens new window)中指定 banner_img 属性。
本地图片存放位置同上。
1
2
3
4
5
6
7
8
| ---
title: 文章标题
tags: [Hexo, Fluid]
index_img: /img/example.jpg
banner_img: /img/post_banner.jpg
date: 2019-10-10 10:00:00
---
以下是文章内容
YAML
|
日期/字数/阅读时长/阅读数
显示在文章页大标题下的文章信息，除了作者和阅读次数，其他功能都是默认开启的。
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
| post:
meta:
author: # 作者，优先根据 front-matter 里 author 字段，其次是 hexo 配置中 author 值
enable: false
date: # 文章日期，优先根据 front-matter 里 date 字段，其次是 md 文件日期
enable: true
format: "dddd, MMMM Do YYYY, h:mm a" # 格式参照 ISO-8601 日期格式化
wordcount: # 字数统计
enable: true
format: "{} 字" # 显示的文本，{}是数字的占位符（必须包含)，下同
min2read: # 阅读时间
enable: true
format: "{} 分钟"
views: # 阅读次数
enable: false
source: "leancloud" # 统计数据来源，可选：leancloud | busuanzi 注意不蒜子会间歇抽风
format: "{} 次"
DTS
|
TIP
日期格式必须遵循 ISO-8601 规范，否则无法正常显示；
其他格式必须包括 {} 符号代替数字，文字可自由设置。
代码块
1
2
3
4
5
6
7
8
9
10
11
12
| code:
copy_btn: true
highlight:
enable: true
line_number: true
lib: "highlightjs"
highlightjs:
style: 'Github Gist'
bg_color: false
prismjs:
style: "default"
preprocess: true
YAML
|
copy_btn: 是否开启复制代码的按钮
line_number: 是否开启行号
highlight: 是否开启代码高亮
lib: 选择生成高亮的库，可选项: highlightjs、prismjs，对应下面两组配置，高亮的配置说明具体见主题配置中的注释