社交图标 (Social Settings)
Butterfly支持 font-awesome v6 图标.
书写格式 图标名:url || 描述性文字 || color
social: fab fa-github: https://github.com/xxxxx || Github || "#hdhfbb" fas fa-envelope: mailto:xxxxxx@gmail.com || Email || "#000000"
PC:
Mobile:
头像
avatar: img: /img/avatar.png effect: true # 头像会一直转圈
顶部图
如果不要显示顶部图,可直接配置 disable_top_img: true
顶部图的获取顺序,如果都没有配置,则不显示顶部图。
- 页面顶部图的获取顺序:
各自配置的 top_img > 配置文件的 default_top_img- 文章页顶部图的获取顺序:
各自配置的 top_img > cover > 配置文件的 default_top_img
其它页面 (tags/categories/自建页面)和 文章页 的 top_img ,请到对应的 md 页面设置front-matter中的top_img
以上所有的 top_img 可配置以下值
3.2.0 以下版本的配置只支持
- 留空,true 和 false - 显示默认的顔色
- img链接 - 显示所配置的图片
tag_per_img 和 category_per_img 是 3.2.0 新增的内容,可对 tag 和 category 进行单独的配置
并不推荐为每个 tag 和每个 category 都配置不同的顶部图,因为配置太多会拖慢生成速度
tag_per_img: aplayer: https://xxxxxx.png android: ddddddd.png category_per_img: 随想: hdhdh.png 推荐: ddjdjdjd.png
top_img: false
top_img: orange
top_img: ‘linear-gradient(20deg, #0062be, #925696, #cc426e, #fb0347)’
文章封面
文章的 markdown 文档上,在 Front-matter 添加 cover ,并填上要显示的图片地址。
如果不配置 cover,可以设置显示默认的 cover。
如果不想在首页显示 cover, 可以设置为 false。
文章封面的获取顺序 Front-matter 的 cover > 配置文件的 default_cover > false
cover: # 是否显示文章封面 index_enable: true aside_enable: true archives_enable: true # 封面显示的位置 # 三个值可配置 left , right , both position: both # 当没有设置cover时,默认的封面显示 default_cover:
当配置多张图片时,会随机选择一张作为cover.此时写法应为
default_cover: - https://file.crazywong.com/gh/jerryc127/CDN@latest/cover/default_bg.png - https://file.crazywong.com/gh/jerryc127/CDN@latest/cover/default_bg2.png - https://file.crazywong.com/gh/jerryc127/CDN@latest/cover/default_bg3.png
left
right
both
页面 meta 显示
post_meta: page: date_type: both # created or updated or both 主页文章日期是创建日或者更新日或都显示 date_format: relative # date/relative 显示日期还是相对日期 categories: true # true or false 主页是否显示分类 tags: true # true or false 主页是否显示标签 label: true # true or false 显示描述性文字 post: date_type: both # created or updated or both 文章页日期是创建日或者更新日或都显示 date_format: relative # date/relative 显示日期还是相对日期 categories: true # true or false 文章页是否显示分类 tags: true # true or false 文章页是否显示标签 label: true # true or false 显示描述性文字
主页
文章页
date_format 是 3.2.0 新增的内容,配置时间显示明确时间还是相对时间