快速上手

快速上手
Zhaowei Peng快速上手
追番页面配置
在博客根目录执行
1 | npm install hexo-bilibili-bangumi --save |
在 hexo 配置文件_config.yml中加入以下配置,注意不是主题配置文件,更多配置请参考hexo-bilibili-bangumi
1 | # 追番插件 |
使用方法
更新数据
在生成或部署博客之前,需要更新追番/追剧数据:
1 | # 更新追番数据 |
删除数据
1 | # 删除追番数据 |
手动添加数据
在 source/_data/ 目录下创建 extra_bangumis.json(追番)或 extra_cinemas.json(追剧):
1 | { |
页面配置 📦
关于页面配置
1.前往你的 Hexo 博客的根目录
2.在 Hexo 博客根目录 [blog]下打开终端,输入
1 | hexo new page about |
3.你会找到 source/about/index.md 这个文件
4.修改这个文件: 记得添加 type: “about”
1 | --- |
5.主题配置文件中开启menu中关于和关于本人的注释,注意缩进!!!
1 | menu: |
新建source/_data/about.yml,输入以下内容
1 | - class_name: 关于页 |
| 参数 | 备选值/类型 | 解释 |
|---|---|---|
| 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.list | list | 【可选】生涯 item |
| careers.list.desc | string | 【可选】生涯 item 描述 |
| careers.list.color | string | 【可选】生涯 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 后缀(默认元) |
音乐馆页配置 🎵
1.前往你的 Hexo 博客的根目录
2.在 Hexo 博客根目录 [blog]下打开终端,输入
1 | hexo new page music |
3.你会找到 source/music/index.md 这个文件
4.修改这个文件: 记得添加 type: “music”
1 | --- |
5.新建 source/json/music.json,此 json 为切换歌单按钮的歌单数据。
1 | [ |
6.hexo 配置文件_config.yml中添加以下配置,注意不是主题配置文件
1 | # APlayer |
7.主题配置文件中开启menu中我的和音乐馆的注释,注意缩进!!!
1 | menu: |
如何修改默认歌单?
将menu中音乐馆的路径修改为以下格式即可/music/?id=1708664797&server=tencent,支持id和server参数。
id 与 server 的填写请参考MetingJS
相册页面配置 📕
1.前往你的 Hexo 博客的根目录
2.在 Hexo 博客根目录 [blog]下打开终端,输入
1 | hexo new page album |
3.你会找到 source/album/index.md 这个文件
4.修改这个文件: 记得添加 type: “album”
1 | --- |
5.主题配置文件中开启menu中我的和相册集的注释,注意缩进!!!
1 | menu: |
新建文件[blog]\source_data\album.yml,没有_data文件夹的话也请自己新建。打开[blog]\source_data\album.yml,输入:
1 | - class_name: 世界各地夕阳与风景 |
| 参数 | 备选值/类型 | 解释 |
|---|---|---|
| class_name | string | 【必须】页面类 |
| path_name | url | 【必须】当前相册路径 |
| type | number | 【必须】当前相册页面样式类型 |
| description | string | 【必须】当前相册描述 |
| cover | url | 【必须】当前相册 cover 图片 |
| 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一致。
1 | hexo new page dailyPhoto |
你会找到 source/dailyPhoto/index.md 和source/wordScenery/index.md两个文件,这两个为相册集详情页
然后内容为以下内容, 需在详情页加上type: “album_detail”
1 | --- |
1 | --- |
远程加载json示例数据
1 | [ |
首页即刻说说页面配置
1.前往你的 Hexo 博客的根目录
2.在 Hexo 博客根目录 [blog]下打开终端,输入
1 | hexo new page essay |
3.你会找到 source/essay/index.md 这个文件
4.修改这个文件: 记得添加 type: “essay”
1 | --- |
5.新建source/_data/essay.yml,输入以下内容,具体字段不做解释,可以依葫芦画瓢。
1 | - title: 即刻短文 |
【主题版本 1.6.7 以上支持】其中 video 对于 bilibili 进行的额外的支持,视频为 player.bilibili.com 的将显示为 bilibili 视频,并且可以在链接后面拼接&autoplay=0控制不自动播放
⚠️警告
主题配置文件中开启menu中关于和闲言碎语的注释,导航栏闲言碎语,注意缩进!!!
1 | menu: |
⚠️注意
example数据中的图片不保证可用性,请自行更换为您自己的图床链接。
文章内容来自:安知鱼主题官方文档


