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 显示描述性文字
YML related_post: enable: true limit: 6 # 显示推荐文章数目 date_type: created # or created or updated 文章日期显示创建日或者更新日
9.6 文章锚点
开启文章锚点后，当你在文章页进行滚动时，文章链接会根据标题ID进行替换。
注意: 每替换一次，会留下一个歷史记录。所以如果一篇文章有很多锚点的话，网页的歷史记录会很多。
修改主题配置文件_config.butterfly.yml。
1 2 3 4
YML # anchor # when you scroll in post , the url will update according to header id. anchor: true
9.7 文章过期提醒
可设置是否显示文章过期提醒，以更新时间为基准。
1 2 3 4 5 6 7 8 9
YML # Displays outdated notice for a post (文章过期提醒) noticeOutdate: enable: true style: flat # style: simple/flat limit_day: 365 # 距离更新时间多少天才显示文章过期提醒 position: top # position: top/bottom message_prev: It has been # 天数之前的文字 message_next: days since the last update, the content of the article may be outdated. # 天数之后的文字
9.8 文章分页按钮
修改主题配置文件_config.butterfly.yml
1 2 3 4 5 6 7
YML # post_pagination (分页) # value: 1 || 2 || false # false:为关闭分页按钮；1:下一篇显示的是旧文章；2:下一篇显示的是新文章 # 1: The 'next post' will link to old post # 2: The 'next post' will link to new post # false: disable pagination post_pagination: false
YML custom_text: I wish you to become your own sun, no need to rely on who's light.<p><a target="_blank" href="https://hexo.io/"><img src="https://img.shields.io/badge/Frame-Hexo-blue?style=flat&logo=hexo" title="博客框架为Hexo"></a> <a target="_blank" href="https://butterfly.js.org/"><img src="https://img.shields.io/badge/Theme-Butterfly-6513df?style=flat&logo=bitdefender" title="主题采用butterfly"></a> <a target="_blank" href="https://www.jsdelivr.com/"><img src="https://img.shields.io/badge/CDN-jsDelivr-orange?style=flat&logo=jsDelivr" title="本站使用JsDelivr为静态资源提供CDN加速"></a> <a target="_blank" href="https://vercel.com/ "><img src="https://img.shields.io/badge/Hosted-Vervel-brightgreen?style=flat&logo=Vercel" title="本站采用双线部署，默认线路托管于Vercel"></a> <a target="_blank" href="https://vercel.com/ "><img src="https://img.shields.io/badge/Hosted-Coding-0cedbe?style=flat&logo=Codio" title="本站采用双线部署，联通线路托管于Coding"></a> <a target="_blank" href="https://github.com/"><img src="https://img.shields.io/badge/Source-Github-d021d6?style=flat&logo=GitHub" title="本站项目由Gtihub托管"></a> <a target="_blank" href="http://creativecommons.org/licenses/by-nc-sa/4.0/"><img src="https://img.shields.io/badge/Copyright-BY--NC--SA%204.0-d42328?style=flat&logo=Claris" title="本站采用知识共享署名-非商业性使用-相同方式共享4.0国际许可协议进行许可"></a></p>
translate: enable: false # 默认按钮显示文字(网站是简体，应设置为'default: 繁') default: 繁 # the language of website (1 - Traditional Chinese/ 2 - Simplified Chinese） # 网站默认语言，1: 繁体中文, 2: 简体中文 defaultEncoding: 2 # Time delay 延迟时间,若不在前, 要设定延迟翻译时间, 如100表示100ms,默认为0 translateDelay: 0 # 当文字是简体时，按钮显示的文字 msgToTraditionalChinese: '繁' # 当文字是繁体时，按钮显示的文字 msgToSimplifiedChinese: '簡'
13.2 夜间模式
修改主题配置文件_config.butterfly.yml
1 2 3 4 5 6 7 8 9 10 11 12
YML
# dark mode darkmode: enable: false # dark 和 light 两种模式切换按钮 button: true # Switch dark/light mode automatically (自動切換 dark mode和 light mode) # autoChangeMode: 1 Following System Settings, if the system doesn't support dark mode, it will switch dark mode between 6 pm to 6 am # autoChangeMode: 2 Switch dark mode between 6 pm to 6 am # autoChangeMode: false autoChangeMode: false
v2.0.0 开始增加一个选项，可开启自动切换light mode 和 dark mode。
autoChangeMode: 1 跟随系统而变化，不支持的浏览器/系统将按照时间晚上6点到早上6点之间切换为 dark mode。
autoChangeMode: 2只按照时间 晚上6点到早上6点之间切换为 dark mode,其余时间为light mode。
aside: enable: true hide: false button: true mobile: true # display on mobile position: right # left or right display: archive: true tag: true category: true card_author: enable: true description: button: enable: true icon: # fab fa-github text: 🛴前往小家... link: https://github.com/fomalhaut1998 card_announcement: enable: true content: <center>主域名：<br><a href="https://www.fomal.cc"><b><font color="#5ea6e5">fomal.cc</font></b></a> | <a href="https://www.fomal.cn"><b><font color="#5ea6e5">fomal.cn</font></b></a><br>备用域名：<br><a href="https://blog.fomal.cc"><b><font color="#5ea6e5">blog.fomal.cc</font></b></a><br><a href="https://aa.fomal.cc"><b><font color="#5ea6e5">aa.fomal.cc</font></b></a><br><a href="https://bb.fomal.cc"><b><font color="#5ea6e5">bb.fomal.cc</font></b></a><br><a href="mailto:[email protected]">📬：<b><font color="#a591e0">[email protected]</font></b></a></center> card_recent_post: enable: false limit: 3 # if set 0 will show all sort: date # date or updated sort_order: # Don't modify the setting unless you know how it works card_categories: enable: false limit: 8 # if set 0 will show all expand: none # none/true/false sort_order: # Don't modify the setting unless you know how it works card_tags: enable: false limit: 20 # if set 0 will show all color: true sort_order: # Don't modify the setting unless you know how it works card_archives: enable: false type: monthly # yearly or monthly format: MMMM YYYY # eg: YYYY年MM月 order: -1 # Sort of order. 1, asc for ascending; -1, desc for descending limit: 8 # if set 0 will show all sort_order: # Don't modify the setting unless you know how it works card_webinfo: enable: true post_count: true last_push_date: true sort_order: # Don't modify the setting unless you know how it works card_weibo: enable: true
YML # Time difference between publish date and now (網頁運行時間) # Formal: Month/Day/Year Time or Year/Month/Day Time runtimeshow: enable: false publish_date: 8/9/2022 00:00:00 ##网页开通时间 #格式: 月/日/年 时间 #也可以写成 年/月/日 时间
14.4 最新评论
v3.1.0 以上支持。如果未配置任何评论，前先不要开启该功能。
最新评论只会在刷新时才会去读取，并不会实时变化。 由于 API 有 访问次数限制，为了避免调用太多，主题默认存取期限为 10 分鐘。也就是説，调用后资料会存在 localStorage 里，10分鐘内刷新网站只会去 localStorage 读取资料。 10 分鐘期限一过，刷新页面时才会去调取 API 读取新的数据。（3.6.0 新增了 storage 配置，可自行配置缓存时间）。
修改主题配置文件_config.butterfly.yml
1 2 3 4 5 6 7 8
YML # Aside widget - Newest Comments newest_comments: enable: true sort_order: # Don't modify the setting unless you know how it works limit: 6 # 显示的数量 storage: 10 # 设置缓存时间，单位 分钟 avatar: true # 是否显示头像
YML # Font settings for the site title and site subtitle # https://fonts.googleapis.com/css?family=Titillium+Web&display=swap # Titillium Web, 'PingFang SC' , 'Hiragino Sans GB' , 'Microsoft JhengHei' , 'Microsoft YaHei' , sans-serif # 左上角網站名字 主頁居中網站名字 blog_title_font: font_link: font-family: var(--global-font)
