在Hexo使用butterfly主题时,会在_config.butterfly.yml文件里看到许多不同的选项。在此,我制作了一个帮助文档来帮助大家更好地设置自己的博客

本文档持续更新

建立博客可以参照Fomalhaut大佬的Hexo博客搭建基础教程进行搭建(无需服务器只要一个1块钱首年的域名即可)

准备:相对路径的写法

在博客中插入图片时,一般会用两种方法:

第一种是直接插入网址。先准备一个图床(百度即可),上传所需要的图片,你就会得到一个网址。将这个网址写入你所需的地方,部署后就会出现图片。

好处是简单易学,但是需要考虑图床跑路而链接失效的情况。所以,更加稳定的是第二种:相对路径的写法。

该主题下的/source/img文件夹是用来存放本地图片的,将图片改一个正常的名字,后缀自定,以xxx.jpg为例。然后在所需的地方写入/source/img/xxx.jpg这个路径,重新部署后,效果相同。

menu:菜单栏

删除注释可以展示各个标签页,可以自命名,在list一栏下可以自定义分支。在这里拿出我的供大家参考。

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:
音乐: /music/ || fas fa-music
电影: /movies/ || fas fa-video
友链: /link/ || fas fa-link
关于: /about/ || fas fa-heart

Code Blocks:代码主题配置

highlight_theme:在右边选择一个代码框风格,其中false表示无主题

highlight_copy:是否显示一键复制按钮

highlight_lang:是否显示代码语言

highlight_shrink:是否显示“缩小代码块”按钮,代码超过一定长度便不展开显示,需手动点击

highlight_height_limit:代码最大高度(单位:像素)

code_word_wrap:是否开启自动换行

copy settings:复制设置

enable:是否开启(以下不重复)

copyright:版权声明

limit_count:复制限制字数(超过这个限制复制会带上版权声明)

social settings:社交图标设置

格式- icon: link || the description

可自行参照所给图标

Local search:本地搜索

会添加一个”search”按钮,需npm指令下载插件

KaTeX和MathJax:数学公式格式设置

KateX和MathJax是两个数学公式显示引擎,类似于Markdown

enable:是否开启

per_page:false即可

hide_scrollbar:是否隐藏滚动条

Favicon:网站图标

位置在这个项目的\node_modules\hexo-theme-butterfly\source\img,是一个32*32像素的png图标,可自己修改成想要的作为自己的logo

Avatar:头像

img后面添上头像的网址作为自己的头像

Cover:文章封面

接下来三个直接写true

default_cover:封面图片,下面按照格式填图片网址或位置,系统会随机选取一张作为文章封面

error_img:无法显示的图片处理

会替换一张404的图片

error_404:404网页显示

subtitle:网页标题,一般是“页面没有找到”

background:后面加入一张图片作为主图

footer:文章底部设置

since:网站起始时间

custom_text:在页脚自定义文本的选项,可以写声明

copyright:false即可

background:背景图片

插入一张图片网页作为背景,格式:url(xxx)

subtitle:主页个签设置

sub:键入自己的签名

Loading Animation:加载动画的设置

source:选择类型(1是方框加载动画,2是进度条)

aside:名片栏

busuanzi:网站数据

开启后查看网站数据

article:文章数量

Total Count:文章中字符总数

UV:浏览人数

PV:浏览次数

以下是选项
site_uv:网站浏览人数
site_pv:网站浏览次数
page_pv:同一页面浏览次数(会在文章开头出现)

translate:简繁翻译

会出现在右下角,开启后中文可简繁翻译

readmode:阅读模式

会出现在右下角,开启后只显示文章

darkmode:黑夜模式

会出现在右下角

AutoChangeMode:自动切换模式(1是随系统切换,2是随时间切换,默认晚上6点至次日6点为黑夜模式)