Hexo的Butterfly主题配置(持续更新)
在Hexo使用butterfly主题时,会在_config.butterfly.yml文件里看到许多不同的选项。在此,我制作了一个帮助文档来帮助大家更好地设置自己的博客
本文档持续更新
建立博客可以参照Fomalhaut大佬的Hexo博客搭建基础教程进行搭建(无需服务器只要一个1块钱首年的域名即可)
准备:相对路径的写法
在博客中插入图片时,一般会用两种方法:
第一种是直接插入网址。先准备一个图床(百度即可),上传所需要的图片,你就会得到一个网址。将这个网址写入你所需的地方,部署后就会出现图片。
好处是简单易学,但是需要考虑图床跑路而链接失效的情况。所以,更加稳定的是第二种:相对路径的写法。
该主题下的/source/img文件夹是用来存放本地图片的,将图片改一个正常的名字,后缀自定,以xxx.jpg为例。然后在所需的地方写入/source/img/xxx.jpg这个路径,重新部署后,效果相同。
menu:菜单栏
删除注释可以展示各个标签页,可以自命名,在list一栏下可以自定义分支。在这里拿出我的供大家参考。
1 | menu: |
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点为黑夜模式)