📦Page Configuration
🧱 Front-matter 的基本认识
Front-matter 是 markdown 文件最上方以 --- 分隔的区域,用于指定个别档案的变数。
其中又分为两种
Page Front-matter 用于页面配置
Post Front-matter 用于文章页配置
---
title:
date:
updated:
type:
comments:
description:
keywords:
top_img:
mathjax:
katex:
aside:
aplayer:
highlight_shrink:
type:
---title
【必需】页面标题
date
【必需】页面创建日期
type
【必需】标签、分类、关于、音乐馆、友情链接、相册、相册详情、朋友圈、即刻页面需要配置
updated
【可选】页面更新日期
description
【可选】页面描述
keywords
【可选】页面关键字
comments
【可选】显示页面评论模块(默认 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 的配置)
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)
swiper_index
【可选】首页轮播图配置 index 索引,数字越小越靠前
top_group_index
【可选】首页右侧卡片组配置, 数字越小越靠前
background
【可选】文章背景可配置为 16 进制颜色值
首页轮播图配置:
swiper_index, 数字越小越靠前首页卡片配置:
top_group_index, 数字越小越靠前page 中
background, 可配置为 16 进制颜色值
只需要在你的文章顶部的Front-matter配置swiper_index和top_group_index这两个字段即可显示轮播图和推荐卡
标签页
前往你的 Hexo 博客的根目录
在 Hexo 博客根目录
[blog]下打开终端,输入你会找到
source/tags/index.md这个文件修改这个文件: 记得添加
type: "tags"
type
【必须】页面类型,必须为 tags
comments
【可选】是否显示评论
top_img
【可选】是否显示顶部图
orderby
【可选】排序方式 :random/name/length
order
【可选】排序次序: 1, asc for ascending; -1, desc for descending
分类页
前往你的 Hexo 博客的根目录
在 Hexo 博客根目录
[blog]下打开终端,输入你会找到
source/categories/index.md这个文件修改这个文件: 记得添加
type: "categories"
首页即刻说说页面配置
前往你的 Hexo 博客的根目录
在 Hexo 博客根目录
[blog]下打开终端,输入你会找到
source/essay/index.md这个文件修改这个文件: 记得添加
type: "essay"添加数据,新建文件
[blog]\source\_data\essay.yml,没有_data文件夹的话也请自己新建。以下是默认格式示例,打开[blog]\source\_data\essay.yml,输入:
主题配置文件中开启menu中关于和闲言碎语的注释,导航栏闲言碎语,注意缩进!!!
警告
示例数据中的图片不保证可用性,请自行更换为您自己的图床链接。图床相关知识=>我的图床方案
友情链接配置
前往你的 Hexo 博客的根目录
在 Hexo 博客根目录
[blog]下打开终端,输入你会找到
source/link/index.md这个文件修改这个文件: 记得添加
type: "link"
新建文件source\_data\link.yml,没有_data文件夹的话也请自己新建。以下是默认友链格式示例(自己写的教程,夹带点私货不过分吧,嘻嘻)。打开source\_data\link.yml,输入:
会根据 flink_style 产生两种效果,可选值有flexcard或者anzhiyu
当友链数目超过 50 以后会触发,与博主共同进步板块
值得注意的是可以自行配置 hundredSuffix: "!w120",该参数可以解决共同进步板块头像质量问题,配置后共同进步板块的头像会添加该后缀。
主题配置文件中开启menu中友链和友人帐的注释,注意缩进!!!
关于页面配置
前往你的 Hexo 博客的根目录
在 Hexo 博客根目录
[blog]下打开终端,输入你会找到
source/about/index.md这个文件修改这个文件: 记得添加
type: "about"主题配置文件中开启
menu中关于和关于本人的注释,注意缩进!!!
新建source/_data/about.yml,输入以下内容
class_name
关于页
【必须】页面类
subtitle
string
【必须】副标题
avatarImg
url
【必须】头像链接
name
string
【必须 作者名称
description
string
【必须】描述
aboutsiteTips
object
【必须】站点关于提示相关配置
aboutsiteTips.tips
string
【必须】站点关于提示性文字
aboutsiteTips.title1
string
【必须】站点关于标题文字 1
aboutsiteTips.title2
string
【必须】站点关于标题文字 2
aboutsiteTips.word
list
【必须】站点关于标题滚动文字
helloAbout
string
【必须】hello 文字
skillsTips
object
【必须】技能相关配置
skillsTips.tips
string
【必须】技能提示文字
skillsTips.title
string
【必须】技能标题
careers
object
【必须】生涯相关配置
careers.tips
string
【必须】生涯提示性文字
careers.title
string
【必须】生涯标题
careers.item
list
【必须】生涯 item
careers.img
string
【必须】生涯图片
statistic
object
【必须】统计数据相关配置
statistic.link
url
【必须】统计数据按钮前往链接
statistic.text
string
【必须】统计数据按钮文字
map
object
【必须】地图相关配置
map.title
string
【必须】地图标题
map.StrengthenTitle
string
【必须】地图大标题
map.background
url
【必须】地图亮色模式背景
map.backgroundDark
url
【必须】地图暗色模式背景
selfInfo
object
【必须】作者相关信息配置
selfInfo.selfInfoTips1
string
【必须】作者相关提示文字 1
selfInfo.selfInfoContentYear
number
【必须】作者生日年份
selfInfo.selfInfoTips2
string
【必须】作者相关提示文字 2
selfInfo.selfInfoContent2
string
【必须】作者相关内容 2
selfInfo.selfInfoTips3
string
【必须】作者相关提示文字 3
selfInfo.selfInfoContent3
string
【必须】作者相关内容 3
personalities
object
【必须】作者性格相关配置
personalities.author_name
string
【必须】作者性格名称
personalities.personality_type
string
【必须】作者性格类型
personalities.photo_url
url
【必须】作者自拍图片
personalities.personality_img
url
【必须】作者性格表述图片
personalities.name_url
url
【必须】点击性格跳转到链接
maxim
object
【必须】座右铭相关配置
maxim.maxim_tips
string
【必须】座右铭相关提示文字
maxim.maxim_top
string
【必须】座右铭相关顶部文字
maxim.maxim_bottom
string
【必须】座右铭相关底部文字
buff
object
【必须】特长相关配置
buff.buff_tips
string
【必须】特长相关提示文字
buff.buff_top
string
【必须】特长相关顶部文字
buff.buff_bottom
string
【必须】特长相关底部文字
game
object
【必须】爱好游戏相关配置
game.game_tips
string
【必须】爱好游戏提示文字
game.game_title
string
【必须】爱好游戏标题
game.game_uid
string
【必须】爱好游戏 uid
game.game_bg
url
【必须】爱好游戏背景
comic
object
【必须】追番相关配置,需要 5 条数据
comic.comic_tips
string
【必须】追番相关提示文字
comic.comic_title
string
【必须】追番相关标题
comic.comic_list
list
【必须】追番相关列表
comic.comic_list.name
string
【必须】追番 item 名称
comic.comic_list.href
url
【必须】追番 item 链接
comic.comic_list.cover
url
【必须】追番 item 的 cover
like
object
【必须】关注偏好相关配置
like.like_tips
string
【必须】关注偏好配置提示文字
like.like_title
string
【必须】关注偏好配置标题
like.like_bg
url
【必须】关注偏好配置背景
like.like_bottom
string
【必须】关注偏好配置底部文字
music
object
【必须】音乐偏好相关配置
music.music_tips
string
【必须】音乐偏好提示性文字
music.music_title
string
【必须】音乐偏好标题
music.music_bg
url
【必须】音乐偏好背景
music.music_link
url
【必须】音乐偏好按钮链接
reward_list
object
【可选】打赏相关配置,如果不配置将没有打赏模块
reward_list.name
string
【必须】打赏 item 名称
reward_list.amount
number
【必须】打赏 item 金额
reward_list.datatime
Date
【必须】打赏 item 时间
reward_list.suffix
string/元
【可选】打赏 item 后缀(默认元)
extra
boolean/false
【必须】开发字段,表示额外模块内容可通过修改主题themes/anzhiyu/layout/includes/anzhiyu/about-extra.pug自行开发,修改为 true 后会引入该 pug 内容。
配置相册页面
前往你的 Hexo 博客的根目录
在 Hexo 博客根目录
[blog]下打开终端,输入你会找到
source/album/index.md这个文件修改这个文件: 记得添加
type: "album"需要修改顶部图可以修改
top_background字段的链接,主题版本需1.4.1或以上。主题配置文件中开启
menu中我的和相册集的注释,注意缩进!!!
新建文件source\_data\album.yml,没有_data文件夹的话也请自己新建。打开source\_data\album.yml,输入:
class_name
string
【必须】页面类
path_name
url
【必须】当前相册路径
type
number
【必须】当前相册页面样式类型
description
string
【必须】当前相册描述
cover
url
【必须】当前相册 cover 图片
top_background
url
【可选】当前相册顶部 banner 图片,可以不填,主题版本需要1.4.1或以上
rowHeight
number
【可选】仅当 type 为 2 时有效,当前相册 rowHeight
limit
number
【可选】仅当 type 为 2 时有效,当前相册 一次懒加载的数量
lazyload
boolean
【可选】仅当 type 为 2 时有效,当前相册 lazyload 是否开启懒加载,默认懒加载为滚动懒加载,type 为 1 时懒加载不可关闭。
btnLazyload
boolean
【可选】仅当 type 为 2 且 lazyload 开启 时有效,当前相册 lazyload 懒加载的方式,默认为滚动懒加载,开启本选项后为按钮点击懒加载。
album_list
list
【必须】当前相册内图片列表
url
url
【可选】仅当 type 为 2 时有效,可以加载远程的 json 数据。
album_list.date
date
【必须】当前图片创建时间
album_list.content
string
【必须】当前图片描述内容
album_list.image
list
【必须】当前图片集,可以多张
album_list.from
string
【可选】当前图片的创建人,未填写则不显示
album_list.address
string
【必须】当前图片地址
警告
注意示例数据中的图片不保证可用性。
由于相册页面需要很多的 page,所以在写数据的时候自行写入路径path_name,示例数据中有两个path_name,所以需要再创建两个页面
注意新建的页面必须与path_name一致。
你会找到 source/dailyPhoto/index.md 和source/wordScenery/index.md两个文件,这两个为相册集详情页
然后内容为以下内容, 需在详情页加上type: "album_detail"
远程加载json示例数据
相册页的样式可以由type控制
相册页 type: 1 样式为紧密的相册 预览
相册页 type: 2 样式为相对疏松的相册 预览
朋友圈页面配置
友链朋友圈后端部署文档 项目地址: https://github.com/Rock-Candy-Tea/hexo-circle-of-friends
请注意朋友圈部署有一定难度,博主使用的为 server 部署,拉取后端代码后可将代码内的默认值改为自己的站点,theme 改为 common2,注意一定要使用common2,否则将无法拉取到自己的友链。
在 Hexo 博客根目录 [blog]下打开终端,输入
打开source\fcircle\index.md,添加一行type: "fcircle":
主题配置文件中开启menu中友链和朋友圈的注释,导航栏朋友圈,注意缩进!!!
主题配置文件中开启friends_vue.enable,自行设置朋友圈后端地址和顶部模块背景,注意缩进!!!
enable
boolean
【必须】是否启用
vue_js
url
【必须】朋友圈前端构建后的 url
apiurl
string
【必须】朋友圈后端 url
top_background
url
【可选】朋友圈顶部背景图
以下是演示站配置
其中vue_js参数,需要将https://npm.elemecdn.com/anzhiyu-theme-static@1.1.1/friends/index.4f887d95.js下载下来
然后全局搜索 friends.anzhiy.cn替换为您的部署的后端 url 然后使用
前端项目地址:hexo-circle-of-friends-front,也可以自行下载项目后,修改代码中的 url 变量路径friends.anzhiy.cn为你自己的,然后执行npm run build构建使用,
主题配置文件中开启menu中友链和朋友圈的注释,注意缩进!!!
音乐馆页配置
前往你的 Hexo 博客的根目录
在 Hexo 博客根目录
[blog]下打开终端,输入你会找到
source/music/index.md这个文件修改这个文件: 记得添加
type: "music"新建
source/json/music.json,此 json 为切换歌单按钮的歌单数据。hexo 配置文件
_config.yml中添加以下配置,注意不是主题配置文件主题配置文件中开启
menu中我的和音乐馆的注释,注意缩进!!!
将menu中音乐馆的路径修改为以下格式即可/music/?id=1708664797&server=tencent,支持id和server参数。
404 页面
主题内置了一个简单的 404 页面,可在设置中开启
追番页面
在博客根目录执行
在 hexo 配置文件_config.yml中加入以下配置,注意不是主题配置文件,更多配置请参考hexo-bilibili-bangumi
留言板页面
在博客根目录执行
在站点配置文件_config.yml中添加以下内容配置,更多配置请查看信笺样式留言板
我的装备页面
前往你的 Hexo 博客的根目录
在 Hexo 博客根目录
[blog]下打开终端,输入你会找到
source/equipment/index.md这个文件修改这个文件: 记得添加
type: "equipment"添加数据,新建文件
source\_data\equipment.yml,没有_data文件夹的话也请自己新建。以下是默认格式示例,打开source\_data\equipment.yml,输入:
主题配置文件中开启menu中关于和我的装备的注释,导航栏我的装备,注意缩进!!!
示例数据中的图片不保证可用性,请自行更换为您自己的图床链接。图床相关知识=>我的图床方案
Last updated