博客搭建纪要

准备工作

需要提前配置好

  • node.js（直接点默认配置即可）
1
官网地址：https://nodejs.org/en/

查看是否安装成功：执行node可以看到版本即可。

1
2
3
C:\Users\admin>node
Welcome to Node.js v14.20.0.
Type ".help" for more information.
  • Git（直接点默认配置即可）
1
官网地址：https://git-scm.com/

查看是否安装成功：执行git –version可以看到版本即可。

1
2
C:\Users\admin>git --version
git version 2.33.0.windows.2

同时windows右键的时候可以看到有几个git的选项：git bush here之类的。

Hexo安装

如果准备工作完成可以开始安装hexo，可以在自己喜欢的地方新建一个文件夹（后续博客内容都在这个文件夹里面），然后进这个文件夹右键选择git bush here进入git终端执行命令

1
npm install -g hexo-cli

安装完成后，输入 hexo init 命令初始化博客：

1
hexo init

静态部署

1
2
hexo g  #静态部署
hexo s  #启动

可以看到在本地有一个4000端口，能够访问 http://localhost:4000表示本地部署成功

基础构建

安装主题

在博客文件夹中操作

可以预先找到合适的主题然后使用git进行clone

1
git clone -b master https://github.com/jerryc127/hexo-theme-butterfly.git themes/butterfly

如果沒有pug以及stylus的渲染器，还需要下载，否则在项目运行时会报错：

1
npm install hexo-renderer-pug hexo-renderer-stylus --save

修改项目根目录下的_config.yml文件（称为站点配置文件），开启主题

1
2
3
4
5
# Extensions
## Plugins: https://hexo.io/plugins/
## Themes: https://hexo.io/themes/
#theme: landscape
theme: butterfly

为了減少升级主题带来的不便，我们还需要做以下操作：

把主题文件夹中的 _config.yml 复制到 Hexo 根目录下，同重命名为 _config.butterfly.yml

部署到github

打开根目录下的 _config.yml文件夹，在文件底部添加内容

1
2
3
4
deploy:
  type: git		#推送类型GitHub应该是git，gitee应该是其他
  repository: https://github.com/xxx/xxx.github.io.git  #你的仓库地址
  branch: master

博客所在文件夹中，打开 Git Bash，安装Git部署插件

1
npm install hexo-deployer-git --save

继续输入命令

1
2
3
hexo clean   #清除缓存文件 db.json 和已生成的静态文件 public
hexo g       #生成网站静态文件到默认设置的 public 文件夹(hexo generate 的缩写)
hexo d       #自动生成网站静态文件，并部署到设定的仓库(hexo deploy 的缩写)

在这个hexo d的时候可能会涉及到一个登录操作：需要登陆github或者全局配置一下账号

1
2
git config --global user.email "你的邮箱地址"
git config --global user.name "用户昵称"

执行hexo d之后可以看到GitHub主页中的action中有一些进程在运行就表示推送成功。

网络原因有可能会导致超时可以重新执行。

个性化

安装主题

在hexo项目根目录下执行操作clone主题

1
git clone -b master https://github.com/jerryc127/hexo-theme-butterfly.git themes/butterfly

如果沒有 pug 以及 stylus 的渲染器，还需要下载，否则在项目运行时会报错：

1
npm install hexo-renderer-pug hexo-renderer-stylus --save

修改项目根目录下的_config.yml文件（称为站点配置文件），开启主题

1
2
3
4
5
# Extensions
## Plugins: https://hexo.io/plugins/
## Themes: https://hexo.io/themes/
#theme: landscape
theme: butterfly
  • 升级建议

为了減少升级主题带来的不便，我们还需要做以下操作：

把主题文件夹中的 _config.yml 复制到 Hexo 根目录下，同重命名为 _config.butterfly.yml

1
Hexo会自动合并主题中的_config.yml和 _config.butterfly.yml里的配置，如果存在同名配置，会使用_config.butterfly.yml的配置，其优先度较高。

个人资料

主要操作都是修改根目录下的站点配置文件_config.yml

修改网站各种资料，例如标题、副标题和邮箱等个人资料

1
2
3
4
5
6
7
8
9
10
11
12
# Hexo Configuration
## Docs: https://hexo.io/docs/configuration.html
## Source: https://github.com/hexojs/hexo/

# Site
title: XXXX					#标题
subtitle: 'XXXX'			#副标题
description: XXXX			#个性签名
keywords:XXXX				#关键词
author: XXXX				#作者
language: zh-CN				#语言
timezone: Asia/Shanghai    	#中国的时区

主题支持三种语言：

  • default(en)

  • zh-CN (简体中文)

  • zh-TW (繁体中文)

导航菜单

修改主题配置文件_config.butterfly.yml：

1
2
3
4
5
6
7
8
9
10
menu:
  首页: / || fas fa-home
  归档: /archives/ || fas fa-archive
  标签: /tags/ || fas fa-tags
  分类: /categories/ || fas fa-folder-open
  工具 || fas fa-list:
      CyberChef: /CyberChef/ || fas fa-music
      Linux命令大全: /Linux-command/ || fas fa-video
  友情链接: /link/ || fas fa-link
  关于: /about/ || fas fa-heart

代码块显示设置

代码复制

开启代码复制功能，修改主题配置文件_config.butterfly.yml：

1
highlight_copy: true
代码框展开
  • true 全部代码框不展开，需点击 > 打开
  • false 代码狂展开，有 > 点击按钮
  • none 不显示 > 按钮

修改主题配置文件_config.butterfly.yml：

1
highlight_shrink: false #代码框展开
自动换行

在默认情况下，hexo-highlight 在编译的时候不会实现代码自动换行。如果你不希望在代码块的区域里有横向滚动条的话，可以_config.butterfly.yml开启代码换行：

1
code_word_wrap: true
我的设置

配置文件_config.butterfly.yml：

1
2
3
4
5
6
7
8
# Code Blocks (代码块样式)
# --------------------------------------
highlight_theme: mac #  darker / pale night / light / ocean / mac / mac light / false
highlight_copy: true # copy button 是否显示复制按钮
highlight_lang: true # show the code language 展示代码块语言
highlight_shrink: false # true: 打开文章默认折叠代码块内容 / false: 打开文章默认展开代码块内容
highlight_height_limit: false # unit: px
code_word_wrap: true #是否关闭滚动条

站点配置文件_config.yml

1
2
3
4
5
6
7
highlight:
  enable: true
  line_number: true
  auto_detect: false
  tab_replace: ''
  wrap: true
  hljs: false

本地搜索

安装插件

1
npm install hexo-generator-search --save

修改主题配置文件_config.butterfly.yml：

1
2
3
4
5
6
7
# Local search
local_search:
  enable: true
  labels:
    input_placeholder: Search for Posts
    hits_empty: "We didn't find any results for the search: ${query}" 
    # 如果没有查到内容相关内容显示

副标题

修改主题配置文件_config.butterfly.yml：

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
# 主页subtitle
subtitle:
  enable: true # 打字效果
  effect: true  # 循环或者只打字一次
  loop: false
  # source调用第三方服务
  # source: false 关闭调用
  # source: 1  调用搏天api的随机语录（简体） https://api.btstu.cn/yan/api.php
  # source: 2  调用一言网的一句话（简体） https://v1.hitokoto.cn/?c=f&encode=text
  # source: 3  调用一句网（简体） http://yijuzhan.com/
  # source: 4  调用今日诗词（简体） https://www.jinrishici.com/
  # subtitle 会先显示 source , 再显示 sub 的内容
  #source: false
  source: https://api.btstu.cn/yan/api.php
  # source: 1 https://v1.hitokoto.cn/?c=f&encode=text
  sub:
    - 今日事,今日毕
    - Never put off till tomorrow what you can do today
    - 你在抱怨什么呢
    - 为明天到来的事，说人生像是没有意义
    - 没有选择会是唯一的路
    - 这不是你自己的问题，人终归要好好去生活
   #sub句子轮流出现
副标题字体大小颜色

在\themes\butterfly\source\css_layout中的head.styl:

1
2
3
4
5
#site-subtitle
    color: var(--white)   //此处修改为白色
    font-size: 1.05em     // 字体大小
    +minWidth768()
    font-size: 1.40em   // 字体大小

图片设置

图片可以用云图片链接或者放在本地文件夹位置：/themes/butterfly/source/img

网站图标
1
2
# Favicon（网站图标）
favicon: /img/favicon.png
头像
1
2
3
avatar:
  img: /img/avatar.jpg #图片路径
  effect: false #头像会一直转圈
主页封面图片
1
2
# The banner image of home page
index_img: /img/background.jpg
文章详情页的顶部图片

当没有在front-matter设置top_img和cover的情况下会显示该图
修改主题配置文件_config.butterfly.yml：

1
2
# If the banner of page not setting, it will show the top_img
default_top_img: /img/default_top_img.jpg #设置的本地图片
归档页顶部图片
1
2
3
#归档子标签页图片
# The banner image of archive page
archive_img: /img/archive.jpg
tag页顶部图
1
2
3
4
#tag页（标签页）
# If the banner of tag page not setting, it will show the top_img
# note: tag page, not tags page (子標籤頁面的 top_img)
tag_img: /img/tag_img.jpg
category页顶部图
1
2
3
4
#category页
# If the banner of category page not setting, it will show the top_img
# note: category page, not categories page (子分類頁面的 top_img)
category_img: /img/category_img.jpg
文章封面

每篇文章都可以设置一张封面，可以为每篇文章设置默认封面

也可以修改每个md文件的front-matter的cover属性，会覆盖上面的默认封面。修改主题配置文件_config.butterfly.yml：

1
2
3
4
5
6
7
8
9
10
11
12
13
14
cover:
  index_enable: true #  是否展示文章封面
  aside_enable: true
  archives_enable: true
  position: both # 封面展示的位置 left/right/both
  # 当没有设置cover时，默认展示的文章封面
  default_cover:
    # 当配置多张图片时，会随机选择一张作为 cover. 此时写法为
    - https:
    - http:
    - http:
    - http:
    - http:
    - http:
错误页面

配置了该属性后会替换无法展示的图片

1
2
3
4
# Replace Broken Images (替換無法顯示的圖片)
error_img:
  flink: /img/friend_404.gif
  post_page: /img/404.jpg
图片懒加载

这个就是图片没加载出来的时候，出现一个动图转转转的文章页样式

新增hexo-lazyload-image模块

1
npm install hexo-lazyload-image --save

在主目录配置文件_config.yml增加配置

1
2
3
lazyload:
  enable: true
  loadingImg: /img/loading.gif
图片大图查看

修改主题配置文件_config.butterfly.yml

1
2
3
4
5
6
7
8
9
10
11
# Lightbox (圖片大圖查看模式)
# --------------------------------------
# You can only choose one, or neither (只能選擇一個 或者 兩個都不選)

# medium-zoom
# https://github.com/francoischalifour/medium-zoom
medium_zoom: false

# fancybox
# http://fancyapps.com/fancybox/3/
fancybox: true

文章样式

以下修改主题配置文件_config.butterfly.yml

复制的内容后面加上版权信息
1
2
3
4
5
6
7
# copy settings
# copyright: Add the copyright information after copied content (複製的內容後面加上版權信息)
copy:
  enable: true # 是否开启网站复制权限
  copyright:  # 复制的内容后面加上版权信息
    enable: false  # 是否开启复制版权信息添加
    limit_count: 50 # 字数限制，当复制文字大于这个字数限制时
文章版权信息

在底部会出现对应的作者、链接、声明

1
2
3
4
5
post_copyright:
  enable: true
  decode: true
  license: CC BY-NC-SA 4.0
  license_url: https://creativecommons.org/licenses/by-nc-sa/4.0/=
相关文章

在文章最下面出现推送

1
2
3
4
5
# Related Articles
related_post:
  enable: true
  limit: 6 				# Number of posts displayed
  date_type: created 	# or created or updated 文章日期顯示創建日或者更新日
打赏

给文章结尾设置打赏按钮，可以放上收款二维码

1
2
3
4
5
6
7
8
9
10
# Sponsor/reward
reward:
  enable: true
  QR_code:
     - img: /img/wechat.jpg
       link:
       text: 微信
     - img: /img/alipay.jpg
       link:
       text: 支付宝
字数统计

项目目录右键打开 Git Bash Here

1
npm install hexo-wordcount --save or yarn add hexo-wordcount

修改主题配置文件_config.butterfly.yml

1
2
3
4
5
6
# wordcount (字數統計)
wordcount:
  enable: true
  post_wordcount: true
  min2read: true
  total_wordcount: true
文章分享功能

addThis、sharejs、addtoany三个选一个开启

addThis官网：https://www.addthis.com/

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
# Share System (分享功能)
# --------------------------------------

# AddThis
# https://www.addthis.com/
addThis:
  enable: false
  pubid:  #访问 AddThis 官网, 找到你的 pub-id

# Share.js
# https://github.com/overtrue/share.js
sharejs:
  enable: true  #我开启的
  sites: facebook,twitter,wechat,weibo,qq  #想要显示的内容

# AddToAny
# https://www.addtoany.com/
addtoany:
  enable: false
  item: facebook,twitter,wechat,sina_weibo,facebook_messenger,email,copy_link

侧边栏样式

以下修改主题配置文件_config.butterfly.yml

调整侧边栏出现位置
1
2
3
4
5
6
aside:
  enable: true
  hide: false
  button: true
  mobile: true # display on mobile
  position: right # left or right 我的是右边
个人信息
1
2
3
4
5
6
7
8
card_author:
    enable: true
    description:
    button:
      enable: true
      icon: fab fa-github
      text: Follow Me 					#按钮文字
      link: https://github.com/xxxxxx 	#可以放上自己的github地址
社交图标
1
2
3
4
5
6
7
8
# social settings (社交圖標設置)
# formal:
#        icon: link || the description
#书写格式：图标名：url || 描述性文字`
social:
   fab fa-github: URL || Github
   fa fa-book-open: URL || CSDN
   fas fa-envelope-open-text: mailto:	邮箱地址@qq.com || Email
公告
1
2
3
card_announcement:
    enable: true
    content: This is my Blog #修改公告栏信息
Toc目录
1
2
3
4
5
6
# toc (目錄)
toc:
  enable: true
  number: true
  #style_simple: false
  auto_open: true # auto open the sidebar
个人设置
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
aside:
  enable: true
  hide: false
  button: true
  mobile: true # 手机页面（ 显示宽度 < 768px ）是否显示aside内容
  position: right # left or right
  card_author:
    enable: true
    description:
    button:
      enable: true
      icon: fab fa-github
      text: Follow Me 			#按钮文字
      link: https://github.com/0314Valen/0314Valen.github.io #可以放上自己的github地址
  card_announcement:
    enable: true
    content: 不要担心辜负了别人的期待，对你有期待的，只有你自己。 #修改公告栏信息

主站特效

以下均为修改主题配置文件 _config.butterfly.yml:

鼠标点击的效果

有冒光特效、烟火特效、爱心特效、文字特效，选择其中一个将enable设置为true就可以

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
30
31
32
33
34
35
36
37
# Typewriter Effect (打字效果)
# https://github.com/disjukr/activate-power-mode
activate_power_mode:
  enable: false
  colorful: true # open particle animation (冒光特效)
  shake: true #  open shake (抖動特效)
  mobile: false

# Mouse click effects: fireworks (鼠標點擊效果: 煙火特效)
fireworks:
  enable: false
  zIndex: 9999 # -1 or 9999
  mobile: false

# Mouse click effects: Heart symbol (鼠標點擊效果: 愛心)
click_heart:
  enable: false
  mobile: false

# Mouse click effects: words (鼠標點擊效果: 文字)
ClickShowText:
  enable: true
  text:
     - 富强
     - 民主
     - 文明
     - 和谐
     - 平等
     - 公正
     - 法治
     - 爱国
     - 敬业
     - 诚信
     - 友善
  fontSize: 15px
  random: true
  mobile: true
打字效果
1
2
3
4
5
6
7
# Typewriter Effect (打字效果)
# https://github.com/disjukr/activate-power-mode
activate_power_mode:
  enable: true
  colorful: true # open particle animation (冒光特效)
  shake: true #  open shake (抖動特效)
  mobile: true
自定义主题色
1
2
3
4
5
6
7
8
9
10
11
12
13
14
# theme_color:
#   enable: true
#   main: "#49B1F5"
#   paginator: "#00c4b6"
#   button_hover: "#FF7242"
#   text_selection: "#00c4b6"
#   link_color: "#99a9bf"
#   meta_color: "#858585"
#   hr_color: "#A4D8FA"
#   code_foreground: "#F47466"
#   code_background: "rgba(27, 31, 35, .05)"
#   toc_color: "#00c4b6"
#   blockquote_padding_color: "#49b1f5"
#   blockquote_background_color: "#49b1f5"
网站背景

默认显示白色，可设置图片或者颜色

修改主题配置文件_config.butterfly.yml：

1
background:

修改为渐变色，步骤：

1.在\Butterfly\source\css\目录下创建css文件 backgound.css：可以自己调色

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
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
//代码百度得来
#web_bg {
  background: -webkit-linear-gradient(
    0deg,
    rgba(247, 149, 51, 0.1) 0,
    rgba(243, 112, 85, 0.1) 15%,
    rgba(239, 78, 123, 0.1) 30%,
    rgba(161, 102, 171, 0.1) 44%,
    rgba(80, 115, 184, 0.1) 58%,
    rgba(16, 152, 173, 0.1) 72%,
    rgba(7, 179, 155, 0.1) 86%,
    rgba(109, 186, 130, 0.1) 100%
  );
  background: -moz-linear-gradient(
    0deg,
    rgba(247, 149, 51, 0.1) 0,
    rgba(243, 112, 85, 0.1) 15%,
    rgba(239, 78, 123, 0.1) 30%,
    rgba(161, 102, 171, 0.1) 44%,
    rgba(80, 115, 184, 0.1) 58%,
    rgba(16, 152, 173, 0.1) 72%,
    rgba(7, 179, 155, 0.1) 86%,
    rgba(109, 186, 130, 0.1) 100%
  );
  background: -o-linear-gradient(
    0deg,
    rgba(247, 149, 51, 0.1) 0,
    rgba(243, 112, 85, 0.1) 15%,
    rgba(239, 78, 123, 0.1) 30%,
    rgba(161, 102, 171, 0.1) 44%,
    rgba(80, 115, 184, 0.1) 58%,
    rgba(16, 152, 173, 0.1) 72%,
    rgba(7, 179, 155, 0.1) 86%,
    rgba(109, 186, 130, 0.1) 100%
  );
  background: -ms-linear-gradient(
    0deg,
    rgba(247, 149, 51, 0.1) 0,
    rgba(243, 112, 85, 0.1) 15%,
    rgba(239, 78, 123, 0.1) 30%,
    rgba(161, 102, 171, 0.1) 44%,
    rgba(80, 115, 184, 0.1) 58%,
    rgba(16, 152, 173, 0.1) 72%,
    rgba(7, 179, 155, 0.1) 86%,
    rgba(109, 186, 130, 0.1) 100%
  );
  background: linear-gradient(
    90deg,
    rgba(247, 149, 51, 0.1) 0,
    rgba(243, 112, 85, 0.1) 15%,
    rgba(239, 78, 123, 0.1) 30%,
    rgba(161, 102, 171, 0.1) 44%,
    rgba(80, 115, 184, 0.1) 58%,
    rgba(16, 152, 173, 0.1) 72%,
    rgba(7, 179, 155, 0.1) 86%,
    rgba(109, 186, 130, 0.1) 100%
  );
}

修改配置文件_config.butterfly.yml的引入方式

1
2
3
4
5
6
7
8
# Inject
# Insert the code to head (before '</head>' tag) and the bottom (before '</body>' tag)
# 插入代码到头部 </head> 之前 和 底部 </body> 之前
inject:
  head:
     - <link rel="stylesheet" href="/css/background.css">
  bottom:
    # - <script src="xxxx"></script>

如果背景色不生效，设置_config.butterfly.yml

1
2
3
4
# Website Background (設置網站背景)
# can set it to color or image (可設置圖片 或者 顔色)
# The formal of image: url(http://xxxxxx.com/xxx.jpg)
background: '#efefef'

footer 的背景，当设置 false 时，将与主题色一致。

修改主题配置文件_config.butterfly.yml：

1
2
# footer是否显示图片背景(与top_img一致)
footer_bg: true
背景特效

有三种，自己选择开启，将enable设置为true就可以

修改主题配置文件_config.butterfly.yml：

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
# Background effects (背景特效)
# --------------------------------------

# canvas_ribbon (静止彩带)
# See: https://github.com/hustcc/ribbon.js
canvas_ribbon:
  enable: false
  size: 150
  alpha: 0.6
  zIndex: -1
  click_to_change: false
  mobile: false

# Fluttering Ribbon (动态彩带)
canvas_fluttering_ribbon:
  enable: false
  mobile: false

#星空特效
# canvas_nest
# https://github.com/hustcc/canvas-nest.js
canvas_nest:
  enable: true
  color: '0,0,255' #color of lines, default: '0,0,0'; RGB values: (R,G,B).(note: use ',' to separate.)
  opacity: 0.7 # the opacity of line (0~1), default: 0.5.
  zIndex: -1 # z-index property of the background, default: -1.
  count: 99 # the number of lines, default: 99.
  mobile: false

搜索功能

  • 安装依赖

前往博客根目录，打开cmd命令窗口执行npm install hexo-generator-search –save。

1
npm install hexo-generator-search --save
  • 注入配置

修改站点配置文件_config.yml，添加如下代码：

1
2
3
4
search:
  path: search.xml
  field: post
  content: true
  • 主题中开启搜索

在主题配置文件_config.butterfly.yml中修改以下内容：

1
2
3
local_search:
-  enable: false
+  enable: true
  • 重新编译运行，即可看到效果。

前往博客根目录，打开cmd命令窗口依次执行如下命令：

1
2
3
hexo cl && hexo generate
hexo s -p 8000
hexo d

hexo命令

  • hexo init
1
$ hexo init 命令用于初始化一个本地文件夹为网站的根目录
  • hexo new
1
$ hexo new title 新建一篇文章
  • hexo generate
1
2
$ hexo generate 可以简写成 hexo g
该命令用于生成静态文件
  • hexo server
1
2
3
4
5
$ hexo server 命令用于启动本地服务器，一般可以简写成 hexo s
可以加一些参数
-p    选项，指定服务器端口，默认为 4000
-i    选项，指定服务器 IP 地址，默认为 0.0.0.0
-s    选项，静态模式 ，仅提供 public 文件夹中的文件并禁用文件监视
  • hexo deploy
1
$ hexo deploy 命令用于部署网站，一般可以简写成 hexo d
  • hexo clean
1
$ hexo clean 命令用于清理缓存文件，是一个比较常用的命令
  • hexo –safe
1
$ hexo --safe 表示安全模式，用于禁用加载插件和脚本
  • hexo –debug
1
$ hexo --debug 表示调试模式，用于将消息详细记录到终端和 debug.log 文件
  • hexo –silent
1
$ hexo --silent  表示静默模式，用于静默输出到终端

markdown 文件参数

page

新建的一些界面的要markdown 文件的文件头参数

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

文章

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
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)

参考链接

1
https://tzy1997.com/articles/hexo1600/