📦页面配置

🧱 Front-matter 的基本认识

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

其中又分为两种

  1. Page Front-matter 用于页面配置

  2. Post Front-matter 用于文章页配置

提示

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

---
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 的配置)

标签页

  1. 前往你的 Hexo 博客的根目录

  2. 在 Hexo 博客根目录 [blog]下打开终端,输入

  3. 你会找到 source/tags/index.md 这个文件

  4. 修改这个文件: 记得添加 type: "tags"

参数
解释

type

【必须】页面类型,必须为 tags

comments

【可选】是否显示评论

top_img

【可选】是否显示顶部图

orderby

【可选】排序方式 :random/name/length

order

【可选】排序次序: 1, asc for ascending; -1, desc for descending

分类页

  1. 前往你的 Hexo 博客的根目录

  2. 在 Hexo 博客根目录 [blog]下打开终端,输入

  3. 你会找到 source/categories/index.md 这个文件

  4. 修改这个文件: 记得添加 type: "categories"

首页即刻说说页面配置

  1. 前往你的 Hexo 博客的根目录

  2. 在 Hexo 博客根目录 [blog]下打开终端,输入\

  3. 你会找到 source/essay/index.md 这个文件

  4. 修改这个文件: 记得添加 type: "essay"

  5. 添加数据,新建文件[blog]\source\_data\essay.yml,没有_data文件夹的话也请自己新建。以下是默认格式示例,打开[blog]\source\_data\essay.yml,输入:

主题配置文件中开启menu中关于和闲言碎语的注释,导航栏闲言碎语,注意缩进!!!

即刻说说

友情链接配置

  1. 前往你的 Hexo 博客的根目录

  2. 在 Hexo 博客根目录 [blog]下打开终端,输入

  3. 你会找到 source/link/index.md 这个文件

  4. 修改这个文件: 记得添加 type: "link"

新建文件source\_data\link.yml,没有_data文件夹的话也请自己新建。以下是默认友链格式示例(自己写的教程,夹带点私货不过分吧,嘻嘻)。打开source\_data\link.yml,输入:

会根据 flink_style 产生两种效果,可选值有flexcard或者anzhiyu

主题版本小于1.4.1:

当友链数目超过 50 以后会触发,与博主共同进步板块

主题版本大于或等于1.4.1:

可在主题配置文件中配置

值得注意的是可以自行配置 hundredSuffix: "!w120",该参数可以解决共同进步板块头像质量问题,配置后共同进步板块的头像会添加该后缀。

主题版本大于1.4.1可以填写3个值

flink_styletelescopic时,新增colortag

主题版本大于或等于1.4.3:

anzhiyu || telescopic 两种支持colortag

color存在默认值#3b70fc

color存在预设值vip || speed

额外的说明:可以设置

主题配置文件中开启menu中友链和友人帐的注释,注意缩进!!!

友情链接

关于页面配置

  1. 前往你的 Hexo 博客的根目录

  2. 在 Hexo 博客根目录 [blog]下打开终端,输入

  3. 你会找到 source/about/index.md 这个文件

  4. 修改这个文件: 记得添加 type: "about"

  5. 主题配置文件中开启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 内容。

配置相册页面

  1. 前往你的 Hexo 博客的根目录

  2. 在 Hexo 博客根目录 [blog]下打开终端,输入

  3. 你会找到 source/album/index.md 这个文件

  4. 修改这个文件: 记得添加 type: "album"

    需要修改顶部图可以修改top_background字段的链接,主题版本需1.4.1或以上。

  5. 主题配置文件中开启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.mdsource/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,自行设置朋友圈后端地址和顶部模块背景,注意缩进!!!

注意后端爬取需使用common2

参数
备选值/类型
解释

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中友链和朋友圈的注释,注意缩进!!!

音乐馆页配置

  1. 前往你的 Hexo 博客的根目录

  2. 在 Hexo 博客根目录 [blog]下打开终端,输入

  3. 你会找到 source/music/index.md 这个文件

  4. 修改这个文件: 记得添加 type: "music"

  5. 新建 source/json/music.json,此 json 为切换歌单按钮的歌单数据。

  6. hexo 配置文件_config.yml中添加以下配置,注意不是主题配置文件

  7. 主题配置文件中开启menu中我的和音乐馆的注释,注意缩进!!!

如何修改默认歌单?

menu中音乐馆的路径修改为以下格式即可/music/?id=1708664797&server=tencent,支持idserver参数。

404 页面

主题内置了一个简单的 404 页面,可在设置中开启

本地预览时,访问出错的网站是不会跳到 404 页面的。 如需本地预览,请访问 http://localhost:4000/404.html

追番页面

在博客根目录执行

在 hexo 配置文件_config.yml中加入以下配置,注意不是主题配置文件,更多配置请参考hexo-bilibili-bangumi

留言板页面

在博客根目录执行

在站点配置文件_config.yml中添加以下内容配置,更多配置请查看信笺样式留言板

我的装备页面

  1. 前往你的 Hexo 博客的根目录

  2. 在 Hexo 博客根目录 [blog]下打开终端,输入

  3. 你会找到 source/equipment/index.md 这个文件

  4. 修改这个文件: 记得添加 type: "equipment"

  5. 添加数据,新建文件source\_data\equipment.yml,没有_data文件夹的话也请自己新建。以下是默认格式示例,打开source\_data\equipment.yml,输入:

主题配置文件中开启menu中关于和我的装备的注释,导航栏我的装备,注意缩进!!!

最后更新于