Butterfly 安裝文檔(七) 更新日誌
📖 本教程更新於 2022 年 02 月 13 日，教程的內容針對最新穩定版而更新（如果你是舊版，教程會有些出入，請留意）
🦋 Butterfly 已經更新到 4.1.0
📚 文檔目錄
Post not found: Butterfly-安裝文檔-一-快速開始 🚀 快速開始 - Post not found: Butterfly-安裝文檔-二-主題頁面 📑 主題頁面 - Post not found: Butterfly-安裝文檔-三-主題配置-1 🛠 主題配置-1 - Post not found: Butterfly-安裝文檔-四-主題配置-2 ⚔️ 主題配置-2 - Post not found: Butterfly-安裝文檔-五-主題問答 ❓ 主題問答 - Post not found: Butterfly-安裝文檔-六-進階教程 ⚡️ 進階教程 - Post not found: Butterfly-安裝文檔-七-更新日誌 ✨ 更新日誌 - Post not found: Butterfly-打賞 🤞 打賞
你可以通過右下角的 簡 按鈕切換為簡體顯示
4.1.0 (2022/02/13)
4.1.0 (2022/02/13)
Breaking Change
升級 fontawesome 到 v6 #689
CDN: - fontawesome: + fontawesomeV6:
Feature
- snackbar 增加圓角
- 增加 flink 標籤外掛
Fix
- 修復點擊 toc 外圍,控制檯報錯的 bug
- Facebook Comments 無法使用 #787
- chat_btn 聊天按鈕翻譯缺失 #791
- local search 的 content 設爲 false, 搜索無法運行的 bug #764
- Mermaid 圖表渲染後元素高度過大 #773
- 文章頁分享按鈕另開一行時， 導航頁寬度沒有 100% 的 bug #765
Improvement
- 語義化 toggle 標籤外掛
- darkmode 下 toc 背景顏色更改
4.0.1 (2022/01/16)
4.0.0 (2022/01/15)
4.0.0 (2022/01/15)
Breaking Change
精簡各評論的配置
disqusjs: - apikey: - api: - nocomment: # display when a blog post or an article has no comment attached - admin: - adminLabel: + option: gitalk: - language: en # en, zh-CN, zh-TW, es-ES, fr, ru - perPage: 10 # Pagination size, with maximum 100. - distractionFreeMode: false # Facebook-like distraction free mode. - pagerDirection: last # Comment sorting direction, available values are last and first. - createIssueManually: false # Gitalk will create a corresponding github issue for your every single page automatically valine: - pageSize: 10 # comment list page size - lang: en # i18n: zh-CN/zh-TW/en/ja - placeholder: Please leave your footprints # valine comment input placeholder (like: Please leave your footprints) - guest_info: nick,mail,link # valine comment header info (nick/mail/link) - recordIP: false # Record reviewer IP - bg: # valine background - emojiCDN: # emoji CDN - enableQQ: false # enable the Nickname box to automatically get QQ Nickname and QQ Avatar - requiredFields: nick,mail # required fields (nick/mail) waline: - avatar: monsterid # gravatar style https://zh-tw.gravatar.com/site/implement/images/#default-image - avatarCDN: # Gravatar CDN baseURL頁面支持 toc #636
toc: - enable: true + post: true + page: false刪除 hide_sidebar_menu_child 配置，改爲直接在 menu 配置 #640
-# Hide the child menu items in mobile sidebar -hide_sidebar_menu_child: false完全移除 jquery
CDN: - jquery: https://cdn.jsdelivr.net/npm/jquery@latest/dist/jquery.min.js移除騰訊分析
-# Tencent Analytics ID -# https://mta.qq.com -tencent_analytics:photofigcaption 和 fancybox 的 figcaption 優先顯示 圖片的title屬性，然後是 alt 屬性 #683
支持新的評論名寫法，主題會處理評論名字大小寫，舊的會兼容
移除博天api，注意順序改變
# source: 1 調用一言網的一句話（簡體） https://hitokoto.cn/ # source: 2 調用一句網（簡體） http://yijuzhan.com/ # source: 3 調用今日詩詞（簡體） https://www.jinrishici.com/移除 html 的 font-size 改爲瀏覽器默認大小
Feature
更新 fancybox 到 4
CDN: - fancybox_css: https://cdn.jsdelivr.net/npm/@fancyapps/fancybox@latest/dist/jquery.fancybox.min.css - fancybox: https://cdn.jsdelivr.net/npm/@fancyapps/fancybox@latest/dist/jquery.fancybox.min.js + fancybox_css_v4: + fancybox_v4:右下角按鈕自定義順序 #680
+rightside_item_order: + enable: false + hide: # readmode,translate,darkmode,hideAside + show: # toc,chat,comment網站資料顯示，當標籤和分類爲0時，數量顯示爲 0，而不是隱藏
代碼框設置高度限制，展開後按鈕不會消失，可點擊再次摺疊 #637
圖片選擇性禁用 lightbox #636
Twikoo 評論圖片添加 lightbox
升級 facebook comment js 到 version 11
爲文章單獨設置 TOC simple_style 顯示 #631
page 頁頂部圖增加黑色遮罩 #671
首頁 pagination更新 UI
主題 css 使用的 rem 改爲 em 或 px
移除 右下角字體調整按鈕
-# Change font size -change_font_size: false新增標籤外掛 timeline #644
清除 配置文件 的CDN，默認CDN 不再顯示在 config
替換 Justified Gallery 爲 flickr-justified-gallery
CDN: - justifiedGallery_js: https://cdn.jsdelivr.net/npm/justifiedGallery/dist/js/jquery.justifiedGallery.min.js - justifiedGallery_css: https://cdn.jsdelivr.net/npm/justifiedGallery/dist/css/justifiedGallery.min.css + flickr_justified_gallery_js: + flickr_justified_gallery_css:切換夜間模式後，mermaid 也會切換夜間主題
mermaid: enable: true # built-in themes: default/forest/dark/neutral - theme: default + theme: + light: default + dark: dark壓縮html代碼後，mermaid 顯示正常
mermaid 可以在 隱藏屬性的標籤外掛 裏使用
本地搜索可處理 json #684
右下角按鈕 UI 微調
更改文章美化後,列表的顯示效果 #693 #686
algolia 升級至 v4
CDN: - algolia_search: https://cdn.jsdelivr.net/npm/instantsearch.js@2.10.5/dist/instantsearch.min.js - algolia_search_css: https://cdn.jsdelivr.net/npm/instantsearch.js@2.10.5/dist/instantsearch.min.css + algolia_search_v4: + instantsearch_v4:本地搜索增加數據庫加載中和搜索中 loading 顯示
anchor 不再限制 post 頁開啓，可以在任何頁面開啓
文章標題支持點擊跳轉到此標題開始閱讀 #653
toc 可以設置全部展開 #709
toc: + expand: false增加 新的評論系統 giscus
+# Giscus +# https://giscus.app/ +giscus: + repo: + repo_id: + category_id: + theme: + light: light + dark: dark + option: CDN: + giscus:友情鏈接列表增加 fetch url 獲取
toc 間隔調整, 直接子元素增加豎線辨識 closed #723
可配置scrollbar顏色
theme_color: + scrollbar_color: "#49b1f5"美化 firefox 瀏覽器滾動條
CDN 增加 blueimp_md5 配置
CDN: + blueimp_md5:
Fix
- 修復 開啓 lazyload 時， fancybox 的縮略圖顯示 lazyload 加載圖片的 bug
- 修復 字體過大/過小而導致 部分 ui 偏移的 bug
- 修復 自建頁面圖片沒有 blur 效果
- 修復窗口大小改變時，導航欄的 ui 可能會錯亂的 bug
- 修復 pjax下 ，twikoo 評論獲取是上一篇評論的 bug #678
- 修復 rightside 遮擋內容，導致內容無法點擊的 bug
- 修復 mermaid 在某些頁面（有元素 id 爲 mermaid 時） 會無法加載的 bug
- 修復 搜索框不會自動 focus 的 bug
- 修復沒有配置 comments 的 use 時，會報錯的 bug
- 修復 toc 在小設備上顯示出屏幕外的 bug
- 修復在打賞按鈕周圍也會觸發打賞彈窗的 bug
- 修復 Waline 最近評論的時間只顯示 “剛剛” 的問題 (以docker的方式執行) #730
- 修復 utterances 的 issue_term 設爲 url，og:title時，評論顯示錯誤的 bug
- 修復評論配置爲 Livere 和 Facebook Comments 時，最新評論模塊仍然顯示的 bug
Improvement
- subtitle 代碼優化，當 source 設爲 false，同時 sub 也沒有配置，將會讀取 hexo 配置文件的 subtitle, 無須使用轉義字符
- 禁止 ios 點擊搜索框，頁面放大的問題
- sidebar menu 點擊展開不再限制只能點擊按鈕 #640
- 修改沒有頂部圖下，文章頁的標題大小
- 優化 404 頁面 UI
- lazyload 默認佔位圖改爲透明圖片
- 優化 css
- 優化 lazyload blur 出現特效
- 手機端更改閱讀模式退出按鈕到右下角
- ui 微調
- 禁止一些瀏覽器會出現點擊左下角按鈕出現放大網頁的行爲
- 鼠標移到最新評論內容，增加 title 顯示
- 移除 button 的 hover 效果
3.8.4 (2021/09/18)
3.8.1 (2021/07/10)
3.8.0 (2021/07/04)
3.8.0 (2021/07/04)
Breaking Change
archives 的 標題 在 menu 配置中獲取
移除最新評論的評論服務商選擇，默認為配置的第一個評論服務商
newest_comments: enable: false sort_order: # Don't modify the setting unless you know how it works limit: 6 storage: 10 # unit: mins, save data to localStorage avatar: true - # You can only choose one, or neither - valine: false - github_issues: - enable: false - repo: - disqus: - enable: false - forum: - api_key: - twikoo: false - waline: falsewidget 寫法更改/可添加非 sticky 區域 widget
Feature
修改最新評論 icon
waline 顔色適配主題色
增加 waline avatarCDN 配置（最新評論也會更新）
waline: ... + avatarCDN： # Gravatar CDN baseURL升級 facebook comment js 到 v10
Fix
- 修復友情鏈接和aside 頭像在 lazyload blur下的顯示 bug
- 修復設置 highlight_shrink: true 後，部分代碼框依舊展開的 bug #602
- 修復 mathjax 在列表下，導致 列表沒有樣式的 bug #586
- 修復文章頁 mathjax 因字體小導致顯示重疊的 bug #587
- 修復當內容過少時，footer 沒有底部靠攏的 bug
Improvement
- UI 優化
- waline 字體大小，頭像特效調整
- pjax 優化
- 減少卡頓，apple 裝置首頁背景 background-attachment 設為 scroll
- 404 頁面不再顯示 rightside
3.7.8 (2021/06/05)
3.7.5 (2021/05/05)
3.7.5 (2021/05/05)
Breaking Change
site_verification 優化，需自行配置
-# Google Webmaster tools verification setting -# See: https://www.google.com/webmasters/ -google_site_verification: -# Bing Webmaster tools verification setting -# See: https://www.bing.com/webmaster/ -bing_site_verification: -# Baidu Webmaster tools verification setting -# See: https://ziyuan.baidu.com/site/ -baidu_site_verification: -# 360 Webmaster tools verification setting -# see http://zhanzhang.so.com/ -qihu_site_verification: -# Yandex Webmaster tools verification setting -# see https://webmaster.yandex.com/ -yandex_site_verification: +site_verification:lazyload 優化 (增加高斯模糊過度特效，增加配置 lazyload 範圍，佔位圖應用到全站)
lazyload: enable: false - post: /img/loading.gif + field: site # site/post + placeholder: /img/loading.gif + blur: false
Feature
- 增加 tags 標簽外掛 - label
Fix
- 修復開啟anchor後，文章頁跳轉回主頁，主頁網址的hash添加上文章頁最後一個標題的 bug
- 修復開啟anchor後,瀏覽器上一頁/下一頁 跳轉會 404 的bug (文章頁的url hash 在pjax下變成 undefined)
- 修復 lazyload 報 undefined 的 bug close #532
Improvement
- 優化 pjax 下 404 頁面
- 優化 button tags 標簽外掛
3.7.1 (2021/03/30)
3.7.0 (2021/03/18)
3.7.0 (2021/03/18)
Breaking Change
更改子目錄的寫法，與父目錄一致
移除 artitalk （如需要，請安裝 hexo-butterfly-artitalk)
-# Artitalk -# see https://artitalk.js.org/ -artitalk: - appId: - appKey: - option: CDN: - artitalk: https://cdn.jsdelivr.net/npm/artitalkkatex_copytex 的js 和 css cdn 更換
-katex_copytex: https://cdn.jsdelivr.net/npm/katex-copytex@latest/dist/katex-copytex.min.js -katex_copytex_css: https://cdn.jsdelivr.net/npm/katex-copytex@latest/dist/katex-copytex.min.css +katex_copytex: https://cdn.jsdelivr.net/npm/katex@latest/dist/contrib/copy-tex.min.js +katex_copytex_css: https://cdn.jsdelivr.net/npm/katex@latest/dist/contrib/copy-tex.css
Feature
新增設置代碼高度限制，顯示展開按鈕
+highlight_height_limit: false # unit: pxprismjs 也可以配置 code_word_wrap
增加 kbd 樣式 #507
添加waline,valine 和twikoo 提供的文章閲讀數配置 #502
valine: + visitor: false waline: + visitor: false twikoo: + visitor: false增加 HexoPlusPlus_Talk（需要安裝 hexo-butterfly-hpptalk)
增加 tags 標簽外掛 inlineImg
gitalk 增加 option 配置
gitalk: createIssueManually: false # Gitalk will create a corresponding github issue for your every single page automatically + option:
Fix
- 修復prismjs 在 ios safari 下自動換行的bug
- 修復默認代碼大小不會隨着字體放大/放小而改變的bug
- 修復prismjs 無法識別的語言 顯示 null 而不是顯示 code 的 bug
- 在完全沒有配置的情況下，運行時控制枱報null 的問題
Improvement
- 主頁分頁會定位到文章區域 #519
- css 優化，簡化自定義代碼色的 css 配置
- 搜索 hover 效果與其它目錄一致
- 百度統計適配 pjax #516
- 當文章頁cover 和 cover 的 default_img都沒有配置時，會去讀取default_top_img的參數
- 一句API 改為 https
- pug代碼優化
3.6.1 (2021/02/01)
3.6.0 (2021/01/30)
3.6.0 (2021/01/30)
Feature
增加首頁評論數顯示
comments: ... count: false # Display comment count in post's top_img + card_post_count: false # Display comment count in Home Page最新評論更新
<a>標簽將會顯示[鏈接]<img>標簽將會顯示[圖片]<pre><code>標簽將顯示[代碼]- github-issues 獲取到的 url 改為對應文章地址，而不是issues地址
- 時間 time 增加 datetime屬性
- waline 獲取到頭像會先匹配 waline數據庫是否有qq頭像屬性
- 部分評論顯示的時間改為更新時間
aside ‘查看更多’按鈕 改為 圖標顯示在右上角
可配置最新評論的緩存時間
newest_comments: enable: false sort_order: # Don't modify the setting unless you know how it works limit: 6 + storage: 10 # unit: mins, save data to localStorage增加 post_pagination 配置(可關閉/配置分頁展示邏輯)
+# post_pagination (分頁) +# value: 1 || 2 || false +# 1: The 'next post' will link to old post +# 2: The 'next post' will link to new post +# false: disable pagination +post_pagination: 1文章版權右上角改為 版權icon
增加配置 disable_top_img，禁用所有的top_img
+# Disable all banner image +disable_top_img: false增加 文章編輯
+# Post edit +# Easily browse and edit blog source code online. +post_edit: + enable: false + # url: https://github.com/user-name/repo-name/edit/branch-name/subdirectory-name/ + # For example: https://github.com/jerryc127/butterfly.js.org/edit/main/source/ + url:
Fix
- 修復 文章頁面上滑子菜單圖標文字無法顯示的 bug #481
- 修復在 chrome上，進入頁面時，頁面元素會出現模糊到清晰 的 bug #479
- 修復夜間模式下，閲讀模式代碼塊背景顔色的顯示bug
- 修復打賞按鈕字數過多導致Hover異常的bug #473
- 修復評論裏 行內元素（表情/圖片）變成塊級元素（換行）的bug
- 修復點擊toc後，滾動完toc的highlight在點擊的上一個元素
- 修復子目錄下，打賞圖片跳轉鏈接會錯誤的bug
- 修復文字點擊關閉random無效的bug
- 修復手持設備橫向翻轉時，menu 沒有進行判斷,而導致樣式錯亂的bug
- 修復pjax下不會跳轉404頁面的bug
- 修復twikoo 評論數獲取會因為地域問題報錯的bug
- 修復 background-image 遇到鏈接有括號時會無法顯示的bug
Improvement
- meta description 限制在150字以內 #480
- pug優化和結構調整
- pug 判斷優化
- 友情鏈接界面增加title顯示（top_img設為false時）
- 升級facebook comment sdk版本
- 優化toc顯示，當向上滾動時，導航欄不會遮擋 toc #472
- pangu 改為全站渲染
- 最新評論js優化
- 調整 Readmode 標題邊距
- 卡片 hover box-shadow 微調
- 404頁面卡片增加hover
- 刪除部分多餘的代碼
Remove
移除百度推送（百度已棄用）和百度轉碼
-# Disable Baidu transformation on mobile devices (禁止百度轉碼) -disable_baidu_transformation: true -# Baidu Push (百度推送) -baidu_push: false移除 fragment_cache 配置（默認開啟）
-# Caches the contents in a fragment, speed up the generation (開啟hexo自帶的緩存,加快生成速度) -fragment_cache: true
3.5.1 (2020/12/31)
3.5.0 (2020/12/30)
3.5.0 (2020/12/30)
Feature
aside 個人資料widget可關閉button
aside: ... card_author: enable: true description: button: + enable: true icon: fab fa-github text: 主題 GitHub link: https://github.com/jerryc127/hexo-theme-butterfly新增 Cloudflare Analytics
+# Cloudflare Analytics +# https://www.cloudflare.com/zh-tw/web-analytics/ +cloudflare_analytics:新增 Microsoft Clarity
+# Microsoft Clarity +# https://clarity.microsoft.com/ +microsoft_clarity:readmode 優化
aside 增加自定義 widget
aside widget 增加排序（只對page頁和sticky內的有效）
aside: ... card_recent_post: + sort_order: # Don't modify the setting unless you know how it works card_categories: + sort_order: # Don't modify the setting unless you know how it works card_tags: + sort_order: # Don't modify the setting unless you know how it works card_archives: + sort_order: # Don't modify the setting unless you know how it works card_webinfo: + sort_order: # Don't modify the setting unless you know how it works newest_comments: enable: true + sort_order: # Don't modify the setting unless you know how it workstwikoo 增加 option 配置
# Twikoo # https://github.com/imaegoo/twikoo -twikoo: +twikoo: + envId: + option:增加waline評論
+# waline - A simple comment system with backend support fork from Valine +# https://waline.js.org/ +waline: + serverURL: # Waline server address url + avatar: monsterid # gravatar style https://zh-tw.gravatar.com/site/implement/images/#default-image + emojiCDN: # emoji CDN + bg: /img/comment_bg.png # waline background + option:增加waline評論數顯示
增加waline最新評論模塊
newest_comments: enable: true ... + waline: false
Improvement
最新評論url 增加描點
html結構優化
修改newest_comments的leancloud為valine，並刪除其配置，改為讀取valine配置
# Aside widget - Newest Comments newest_comments: ... - leancloud: - enable: false - appId: # leancloud application app id - appKey: # leancloud application app key - serverURL: # This configuration is suitable for domestic custom domain name users, overseas version will be automatically detected (no need to manually fill in) - default_avatar: # mp/identicon/monsterid/wavatar/retro/robohash/blank + valine: false
3.4.2 (2020/12/27)
3.4.0 (2020/12/13)
3.4.0 (2020/12/13)
Breaking Change
- 去除 jQuery
Feature
可配置是否添加css前綴
+# Add the vendor prefixes to ensure compatibility +css_prefix: true點擊文字特效增加隨機配置
ClickShowText: enable: false text: - I - LOVEeeeeeeeeeeeee - YOU fontSize: 15px + random: true mobile: false右下角增加字體調整按鈕
+# Change font size +change_font_size: true增加twikoo 最新評論
newest_comments: enable: true .... + twikoo: true增加twikoo評論數顯示
增加toc簡潔模式
toc: enable: true number: true + style_simple: false
Fix
- 修復子目錄下，配置justifiedGallery CDN（相對鏈接）後，連接會無法訪問的bugs
- 修復沒有滾動條時，右下角按鈕顯示問題 #439
- 修復 pangu 配置post 後，仍在全站生效的bugs
- 修復resize 時，toc 的位置問題
Improvement
- 最新評論頭像增加lazyload
- 最新評論優化，當沒有評論時顯示’沒有評論‘
- toc點擊時改用document.getElementById獲取，預防有些字符導致無法跳轉 #426
- 若瀏覽器支持。scroll將採用原生瀏覽器支持的滾動方法
- 搜索優化
- html格式優化
- 當屏幕沒有滾動條時，rightside會直接顯示
- 手機端toc邊距微調
- fontawesome和google字體增加異步加載
- 夜間模式下，廣告降低亮度
- 當設置aside mobile為false時，toc仍然能顯示
Remove
- 刪除ICP配置， 如需要，請使用custom_text配置
- 刪除不必要的語言文件
3.3.0 (2020/10/28)
3.3.0 (2020/10/28)
Breaking Change
- 只支持 hexo 5.0.0 及以上版本
- 不再支持 butterfly.yml 寫法
Feature
Valine 增加 option 設置
valine: + option:toc改為aside顯示,去掉sidebar
手機toc ui 修改
去掉 toc auto_open 配置
toc: enable: true number: true - auto_open: true # auto open the sidebar優化手機toc 的特效和按鈕出現的時機
aside狀態存localStorage
文章標題改為居中
aside 可配置隱藏/增加按鈕可展開或收縮aside
aside: enable: true + hide: false + button: true mobile: true # display on mobile增加Twikoo評論
+twikoo:
Improvements
- 完善note標籤在readmode上的顯示
- 精簡css 和 js
- pjax 優化
- 文章頁標題改為h1(seo)
- canonical 改為hexo提供的函數生成
- ICP SEO優化 #393
- 調大sidebar的寬度
- html結構調整，mobile-sidebar改為sidebar/search調整
- 滾動到評論按鈕只要用評論的頁面就出現
Fix
- 修復網站壓縮後，mermaid 會無法生成顯示的Bugs
- 修復當文章頁top_img設為false時，閲讀模式下文章內容不顯示的bugs
- 修復valine背景圖片再次出現時，由左到右移動的bugs
- 修復disqusjs沒有設置api時，沒有反代的bugs
Remove
- 刪除搜索不必要的配置
- 移除豆瓣配置,如需配置，請使用 hexo-butterfly-douban
- 刪除多餘的css和pug
3.2.0 (2020/09/28)
3.2.0 (2020/09/28)
Breaking Change
更改canvas_ribbon_piao 為 canvas_fluttering_ribbon
-canvas_ribbon_piao: +canvas_fluttering_ribbon: enable: false mobile: false刪除特效js,改為cdn引入
CDN: # background effect - canvas_ribbon: /js/third-party/canvas-ribbon.js - canvas_ribbon_piao: /js/third-party/piao.js - canvas_nest: /js/third-party/canvas-nest.js + canvas_ribbon: https://cdn.jsdelivr.net/npm/butterfly-extsrc@1/dist/canvas-ribbon.min.js + canvas_fluttering_ribbon: https://cdn.jsdelivr.net/npm/butterfly-extsrc@1/dist/canvas-fluttering-ribbon.min.js + canvas_nest: https://cdn.jsdelivr.net/npm/butterfly-extsrc@1/dist/canvas-nest.min.js # effect - activate_power_mode: /js/third-party/activate-power-mode.js - fireworks: /js/third-party/fireworks.js - click_heart: /js/third-party/click_heart.js - ClickShowText: /js/third-party/ClickShowText.js + activate_power_mode: https://cdn.jsdelivr.net/npm/butterfly-extsrc@1/dist/activate-power-mode.min.js + fireworks: https://cdn.jsdelivr.net/npm/butterfly-extsrc@1/dist/fireworks.min.js + click_heart: https://cdn.jsdelivr.net/npm/butterfly-extsrc@1/dist/click-heart.min.js + ClickShowText: https://cdn.jsdelivr.net/npm/butterfly-extsrc@1/dist/click-show-text.min.js
Feature
可設置首頁文章不顯示內容/description
# Display the article introduction on homepage # 1: description # 2: both (if the description exists, it will show description, or show the auto_excerpt) # 3: auto_excerpt (default) +# false: do not show the article introduction index_post_content: method: 3 length: 500 # if you set method to 2 or 3, the length need to config主頁文章時間和文章頁文章時間可以配置顯示日期還是相對時間
post_meta: page: # Home Page + date_format: relative # date/relative 顯示日期還是相對日期 post: + date_format: relative # date/relative 顯示日期還是相對日期top_img 可配置 （留空（默認色）/顏色（HEX值/RGB值/顔色單詞/漸變色)/圖片鏈接/ false（不顯示top_img））
footer可配置背景 [留空/false(默認色)/顏色（HEX值/RGB值/顔色單詞/漸變色)/圖片鏈接/true(跟top_img一樣)]
網站背景可配置 （顏色（HEX值/RGB值/顔色單詞/漸變色)/漸變色/圖片鏈接）
增加 tag_per_img 配置（可為各個tag 單獨配置top_img）
+tag_per_img:增加 category_per_img 配置（可為各個category單獨配置top_img）
+category_per_img:note 標籤優化(可自定義icon圖標/可覆蓋配置中的style)
夜間模式下，背景顔色/top-img/footer-bg 設置為顔色時，不再強制顯示黑色，而是改為遮罩降低亮度
增加部分特效 Mobile設置（activate_power_mode/fireworks/click_heart/ClickShowText)
activate_power_mode: ... + mobile: false fireworks: ... + mobile: true -click_heart: false +click_heart: + enable: false + mobile: false ClickShowText: enable: false ... + mobile: false添加 artitalk 説説插件
+# Artitalk +# see https://artitalk.js.org/ +artitalk: + appId: + appKey: + option: CDN: + artitalk: https://cdn.jsdelivr.net/npm/artitalk網頁進入動畫效果可關閉
+# Enter transitions (開啟網頁進入效果) +enter_transitions: true
Improvements
- preloader 在 pjax 下 每個頁面都會加載
- 修改判斷，避免用戶設置2個lightbox 而導致報錯（只能設置一個）
- 精確時間顯示 （剛剛/幾分鐘前/幾小時前/幾天前/幾個月前）
- 刪除不必要的語言文件和css
- Open_Graph 改為 hexo 內置 生成
- 當隱藏部分沒配置時，左下角設置按鈕會消失 #353
- aside 分類 收縮/展開 增加slide效果
- darkmode 字體顔色加深
- 優化nav的進入，應該修復一些用戶在本地測試中無法顯示nav的bugs
- 最新評論 leancloud呼叫由js sdk 改為 rest api 呼叫。應用可以不與valine同一個
- 最新評論增加錯誤輸出
- tags 設定彩色顯示後，字型大小將根據tag的文章數量而變化 close #365
- 調整tags頁和categories頁在寬度小於768時的字體大小
- 主題文件分類調正
- 當點擊評論框時，valine背景圖片隱藏
Fix
- 修復當hexo的_config沒有設置description時，會導致pjax在頁面與文章間切換會無效 #381
- 修復鼠標點擊文字特效，文字過長導致頁面有滾動條的bugs
- 修復本地搜索文章鏈接無法跳轉bugs
Remove
移除anime js， 集成在fireworks的js裏
CDN: - anime: https://cdn.jsdelivr.net/npm/animejs@latest/anime.min.js刪除不必要的語言檔案
chore
- update hexo-renderer-stylus to 2.0.1
3.1.1 (2020/09/06)
3.1.0 (2020/08/31)
3.1.0 (2020/08/31)
Breaking Change
- 只支持 hexo 4.2.0 以上版本
- butterfly.yml 採用deepMerge, 與_config文件進行合併而不是替換
Feature
適配 hexo 5.0.0 的 prismjs, 代碼主題和各項功能
適配hexo 5.1.0 prismjs caption
可隱藏 Mobile sidebar 子菜單
+# Hide the child menu items in mobile sidebar +hide_sidebar_menu_child: false當寬度小於1024時，點擊toc滾動，增加滾動效果
可配置font-size/更改配置中 code-font 為 code-font-family
font: + global-font-size: + code-font-size: font-family: - code-font: + code-font-family:部分css由’px’改為’em’，適應font-size值改變而改變
pjax增加exclude配置
-pjax: false +pjax: + enable: false + exclude:新增 cnzz_analytics
# Analysis # -------------------------------------- # Baidu Analytics # https://tongji.baidu.com/web/welcome/login baidu_analytics: # Google Analytics # https://analytics.google.com/analytics/web/ google_analytics: # Tencent Analytics # https://mta.qq.com/ tencent_analytics: #500727214 +# CNZZ Analytics +# https://www.umeng.com/ +cnzz_analytics:騰訊分析改為騰訊移動分析，並適配pjax
aside增加position sticky
更改addtoany item的寫法
addtoany: enable: false - item: - - facebook - - twitter - - wechat - - sina_weibo - - facebook_messenger - - email - - copy_link + item: facebook,twitter,wechat,sina_weibo,facebook_messenger,email,copy_link增加最後更新時間顯示/增加post count 配置
aside: - card_webinfo: true + card_webinfo: + enable: true + post_count: true + last_push_date: true增加 aside 最新評論部件
+newest_comments: + enable: false + limit: 6 + avatar: true + leancloud: + enable: false ++ appId: # leancloud application app id + appKey: # leancloud application app key + serverURL: # This configuration is suitable for domestic custom domain name users, overseas version will be automatically detected (no need to manually fill in) + default_avatar: mp # mp/identicon/monsterid/wavatar/retro/robohash/blank + github_issues: + enable: false + repo: + disqus: + enable: false + forum: + api_key:
Improvements
- archives和card-post 改為flex佈局
- 點擊滾動，如果滾動是向上時，將會偏移60px， 避免導航欄遮擋 close #317
- 改cookies為localStorage存儲
- 設置中的theme_color可單獨配置幾個，而不需要全部開啟 close #314
- 調整webinfo 寬度小時的顯示
- aside 內容邊距調整
- Pjax下，刷新頁面時，會滾動到上次瀏覽的位置
- 修復mathjax溢出屏幕的Bugs # 321
- 部分css調整和html優化
- 刪除pwa中的theme-color配置，默認生成meta theme-color #340
- 補全card-categories和card-archives的 ‘查看更多‘鏈接 #337
- 代碼名字全大寫
Fix
- 修復canvas_nest 配置沒有生效的Bugs
- 修復rightsize-bottom配置無效的bug
- 修復夜間模式下代碼塊有背景的bugs（沒開啟渲染的情況下）
- 修復 prismjs 在 tags-toggle 外掛標簽裏，代碼塊顯示一行的bugs
- 修復當關閉代碼渲染後，標簽外掛裏的代碼塊會被壓縮到一行的bugs
- 修復在modern樣式下，note 標簽外掛沒有使用tags名時，沒有背景色和夜間模式文字顯示不清楚的bugs
- 修復主頁文章cover在深色模式下，邊角有小白邊的bugs #278
- 修復note標簽外掛下，代碼塊顯示背景色的bugs close #339
- 修復toc 滾動百分比不準的Bugs
- 修復comments沒設置時，報Unexpected token ‘)’的bugs #344
- 修復網站子目錄下，相關文章cover無法顯示的bugs #334
Remove
- 去除字體放大、縮小按鈕
- 移除 代碼default主題
3.0.1 (2020/08/11)
3.0.0-RC2 (2020/08/01)
3.0.0-RC2 (2020/08/01)
Breaking Change
支持雙評論系統配置/評論配置整理/評論增加lazyload
+comments: + # Up to two comments system, the first will be shown as default + # Choose: Disqus/Disqusjs/Livere/Gitalk/Valine/Utterances/Facebook Comments + use: + # - Valine + # - Disqus + text: true # Display the comment name next to the button + # lazyload: The comment system will be load when comment element enters the browser's viewport. + # If you set it to false, the comment count will be invalid + lazyload: false + count: false # Display comment count in top_img disqus: - enable: false - count: false # dispaly comment count in top_img disqusjs: - enable: false - count: false # dispaly comment count in top_img livere: - enable: false gitalk: - enable: false - count: false # dispaly comment count in top_img valine: - enable: false # if you want use valine,please set this value is true - count: false # dispaly comment count in top_img utterances: - enable: false facebook_comments: - enable: false - count: falsefooter配置整理，修改部分用語 #279
-since: 2020 -footer_custom_text: -footer_copyright: true -ICP: - enable: false - url: - text: - icon: /img/icp.png +footer: + owner: + enable: true + since: 2020 + custom_text: + copyright: true # Copyright of theme and framework + ICP: # Chinese ICP License + enable: false + url: + text: + icon: /img/icp.png移除‘添加書籤’功能，可執行配置按鈕
aside: card_author: enable: true description: + button: + icon: fab fa-github + text: Follow Me + link: https://github.com/xxxxxxcopy的copyright增加字數限制配置，可配置多少字以上才添加版權信息
copy: enable: true - copyright: false + copyright: + enable: false + limit_count: 50aside recent post可設置按發表時間或者更新時間排序
aside: card_recent_post: enable: true limit: 5 # if set 0 will show all + sort: date # date or updated更換typed.js/meting CDN
-typed: https://cdn.jsdelivr.net/npm/typed.js -meting_js: https://cdn.jsdelivr.net/npm/meting@1.2.0/dist/Meting.min.js +typed: https://cdn.jsdelivr.net/npm/typed.js/lib/typed.min.js +meting_js: https://cdn.jsdelivr.net/gh/metowolf/MetingJS@1.2/dist/Meting.min.js
Feature
增加文章過期提醒
+# Displays outdated notice for a post (文章過期提醒) +noticeOutdate: + enable: false + style: flat # style: simple/flat + limit_day: 500 # When will it be shown + 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.增加mac light 代碼框配色
文章copyright 可單獨配置
card-category 中category名稱和數字限制一行顯示
簡繁轉換優化，placeholder也會被轉換
引入css變數，減少css體積
新增 Pjax #234
+# Pjax [Beta] +# It may contain bugs and unstable, give feedback when you find the bugs. +# https://github.com/MoOx/pjax +pjax: false添加第三方chat服務 crisp
+# crisp +# https://crisp.chat/en/ +crisp: + enable: false + website_id:谷歌廣告增加自動廣告配置，減少不必要的js加載
google_adsense: enable: false + auto_ads: true js: https://pagead2.googlesyndication.com/pagead/js/adsbygoogle.js client: enable_page_level_ads: true當post_asset_folder為true時，post的top_img和cover可直接引用同名文件夾下的圖片，只需要寫圖片名字和後綴就行 #270
增加Yandex Webmaster tools verification配置
+# Yandex Webmaster tools verification setting +# see https://webmaster.yandex.com/ +yandex_site_verification:post-meta可以配置是否顯示文字
post_meta: page: # Home Page date_type: created # created or updated or both 主頁文章日期是創建日或者更新日或都顯示 categories: true # true or false 主頁是否顯示分類 tags: false # true or false 主頁是否顯示標籤 + label: true # true or false 顯示描述性文字 post: date_type: both # created or updated or both 文章頁日期是創建日或者更新日或都顯示 categories: true # true or false 文章頁是否顯示分類 tags: true # true or false 文章頁是否顯示標籤 + label: true # true or false 顯示描述性文字手機端post-meta調整顯示/支持顯示分類
代碼框滾動條顔色隨代碼主題變化
頭像/打賞圖片 增加lazyload
提升highlight-tool的加載速度
disqus/disqusjs/facebook comments 可隨夜間模式按鈕切換而轉換主題
mathjax升級到3 #216
pangu.js 只會渲染 body-wrap 區域
放大字體和縮小字體 限制在 10px~20px
更新谷歌分析代碼（gtag）
移除blueimp_md5 js
-blueimp_md5: https://cdn.jsdelivr.net/npm/blueimp-md5/js/md5.min.js夜間模式和閲讀模式微調
Fix
- 修復右下角按鈕被button標籤外掛遮擋的bugs
- 修復開啟photofigcaption後，圖庫會出現界面錯亂的Bugs
- 修復tabs外掛標簽與aplayer插件衝突而異常的bugs
- aplayer的間距調整
- 修復文章front-matter的highlight_shrink和toc為空時，會出現js報錯的bugs
- 修復BUTTON標籤嵌套使用在其他標籤時，生成多了br標籤而導致樣式不同的bugs
- 修復部分設備遇到mobile-sidebar無法滾動的bugs
- 修復文章頁部分元素內文字溢出的Bugs
- 調整當card-category有收縮按鈕時的顯示佈局
- 修復配置PWA參數時，如果網站是子目錄時，會出現加載不到文件的bugs
- 修復hexo douban插件 點擊上/下一頁出現圖片變為null的bugs
- 適配hexo 5.0.0 修復toc點擊不會跳轉的bugs
- 適配hexo 5.0.0 修復toc不會隨著文章而滾動的bugs
- 修復Valine 的requiredFields設置為空 無效的bugs
- 調整手機界面下ol ul li的邊距 #267
- 修復facebook comments 在手機下寬度不是100%的bugs
- 修復share.js 分享的文章圖片都顯示同一張的bugs
- 去除note標籤外掛設為modern時，a標籤的下劃線
- 修正一些不正確的html結構
- 修復fancybox的alt會顯示undefined的bugs
- 修復footer藍色背景下，icp 文字hover 文字變藍看不清的Bug
3.0.0-RC1 (2020/06/16)
3.0.0-RC1 (2020/06/16)
Breaking Change
從3.0開始，不再對IE瀏覽器進行適配
強制使用fontawesome v5（會對一些自定義icon產生影響，請替換為V5圖標）
-# fontawesome圖標 -# 默認使用的是 fontawesome v4版本的圖標 -fontawesome_v5: - enable: false CDN: - # fontawesome - fontawesome_v4: https://cdn.jsdelivr.net/npm/font-awesome@latest/css/font-awesome.min.css - fontawesome_v5: https://cdn.jsdelivr.net/npm/@fortawesome/fontawesome-free/css/all.min.css + fontawesome: https://cdn.jsdelivr.net/npm/@fortawesome/fontawesome-free/css/all.min.css_config.yml 內容修改
精簡baidu_push/instantpage/click_heart/readmode/footer_copyright/medium_zoom/fancybox配置
-baidu_push: - enable: false -instantpage: - enable: true -click_heart: - enable: false -readmode: - enable: true -footer_copyright: - enable: true -medium_zoom: - enable: false -fancybox: - enable: true +baidu_push: false +instantpage: true +click_heart: false +readmode: true +footer_copyright: true +medium_zoom: false +fancybox: true修改runtimeshow 的start_date 為publish_date
runtimeshow: enable: true - start_date: 6/7/2018 00:00:00 + publish_date: 6/7/2018 00:00:00laibili 改名為 LiveRe
-laibili: +livere: enable: false uid:改hr為hr_icon 可設置取消icon
# 水平分隔綫 -hr: +hr_icon: enable: true icon: #fontawesome上圖標的Unicode icon-top:更改loading_bg為error_img，post-loading移到lazyload去
-lodding_bg: +error_img: flink: /img/friend_404.gif #404後圖片 post_page: /img/404.jpg #404後圖片 - post: /img/loading.gif #加載動畫 lazyload: enable: true + post: /img/loading.gif #加載動畫pangu 的field配置只能配置site/post
pangu: enable: true - field: page # page/post + field: site # site/post整合auto_open_sidebar到toc去
toc: enable: true number: true + auto_open: true # auto open the sidebar -# auto open the sidebar in 'post' -auto_open_sidebar: - enable: truefont去除enable配置
# 全局字體 font: - enable: false - font-family: Lato, Helvetica Neue For Number, -apple-system, BlinkMacSystemFont, Segoe UI, Roboto, PingFang SC, Hiragino Sans GB, MicrMicrosoft YaHei", Helvetica Neue, Helvetica, Arial, sans-serif - code-font: consolas, Menlo, "PingFang SC", "Microsoft YaHei", monospace, Helvetica Neue For Number + font-family: + code-font:刪除部分配置
valine: - notify: false # valine mail notify (true/false) Deprecated in v1.4.0+ - verify: false # valine verify code (true/false) Deprecated in v1.4.0+ translate: - #博客網址 - cookieDomain: 'https://xxx/'刪除twitter_meta配置
-# twitter分享自動帶上樣式 -# -https://i.loli.net/2019/09/08/qm3RfvUCKbct1Wz.png -twitter_meta: true
Feature
table寬度佔滿顯示
增加系統Darkmode切換監控，當系統切換Darkmode時，主題會立刻切換
card_description 支持html書寫
Dark Mode和Light Mode 切換按鈕icon更換
適配hexo自帶標簽 Pullquote
百度推送鏈接增加dns-prefetch
canonical 設為默認生成 不再提供配置
-# 避免重複網址分散seo -canonical: trueinstantpage js 加載增加defer
fireworks 增加z-index配置
fireworks: enable: false + zIndex: 9999 # -1 or 9999新的Tag Plugins - button
新的Tag Plugins - tabs
可配置justifiedGallery CDN
CDN: + # justifiedGallery + justifiedGallery_js: https://cdn.jsdelivr.net/npm/justifiedGallery/dist/js/jquery.justifiedGallery.min.js + justifiedGallery_css: https://cdn.jsdelivr.net/npm/justifiedGallery/dist/css/justifiedGallery.min.css新設計404頁面
aplayer js /css 可配置，在文章front-matter中設置aplayer. 防止aplayer在每個頁面都插入代碼
CDN: + # aplayer + aplayer_css: https://cdn.jsdelivr.net/npm/aplayer/dist/APlayer.min.css + aplayer_js: https://cdn.jsdelivr.net/npm/aplayer/dist/APlayer.min.js + meting_js: https://cdn.jsdelivr.net/npm/meting@1.2.0/dist/Meting.min.js增加在綫聊天 Chat Services (chatra/tidio/daovoice/gitter), 可配置主題chat按鈕替換原在綫聊天按鈕
+# Chat Button [recommend] +# It will create a button in the bottom right corner of website, and hide the origin button +chat_btn: false +# The origin chat button is displayed when scrolling up, and the button is hidden when scrolling down +chat_hide_show: false +# chatra +# https://chatra.io/ +chatra: + enable: false + id: +# tidio +# https://www.tidio.com/ +tidio: + enable: false + public_key: +# daovoice +# http://daovoice.io/ +daovoice: + enable: false + app_id: +# gitter +# https://gitter.im/ +gitter: + enable: false + room:可配置rightside按鈕與底部的距
+# 右下角按鈕距離底部的距離(默認單位為px) +rightside-bottom:更換lazyload服務商
CDN: - lazyload: https://cdn.jsdelivr.net/npm/lozad/dist/lozad.min.js + lazyload: https://cdn.jsdelivr.net/npm/vanilla-lazyload/dist/lazyload.iife.min.jscard-categories增加收縮/展開按鈕
aside: card_categories: enable: true limit: 8 # if set 0 will show all + expand: none # none/true/false更改auto_excerpt為index_post_content，並擁有三種方法可選
-# 自動節選 -auto_excerpt: - enable: true - length: 150 +# Display the article introduction on homepage +# 1: description +# 2: both (if the description exists, it will show description. or show the auto_excerpt) +# 3: auto_excerpt (default) +index_post_content: + method: 3 + length: 500 # if you set method to 2 or 3, the length need to config可在post裏單獨設置 auto_open: false關掉sidebar自動打開 #232
友情鏈接界面代碼優化/增加分類描述/分類名字和描述可以不寫/友情鏈接yml寫法更改（舊的寫法依舊有效，沒影響）
文章/頁面font-matter 可設置highlight_shrink (true or false)
代碼框優化
- 調整部分代碼顔色
- 增加一款代碼主題 mac
- 代碼框主題支持自定義
閲讀模式下去掉代碼高亮
disqusjs更新js/css版本，增加nocomment配置
disqusjs: enable: false shortname: siteName: apikey: - api: https://disqus.skk.moe/disqus/ #一般情況下無需修改 API 地址 + api: + nocomment: # display when a blog post or an article has no comment attached admin: adminLabel: count: false # dispaly comment count in top_img CDN: - disqusjs: https://cdn.jsdelivr.net/npm/disqusjs@1.2/dist/disqus.js - disqusjs_css: https://cdn.jsdelivr.net/npm/disqusjs@1.2/dist/disqusjs.css + disqusjs: https://cdn.jsdelivr.net/npm/disqusjs@1/dist/disqus.js + disqusjs_css: https://cdn.jsdelivr.net/npm/disqusjs@1/dist/disqusjs.css打賞增加鏈接配置 /打賞寫法更改（舊寫法依然有用）#240
# 打賞按鈕 reward: enable: true QR_code: - - itemlist: - img: /img/wechat.jpg - text: 微信 - - itemlist: - img: /img/alipay.jpg - text: 支付寶 + - img: /img/wechat.jpg + link: + text: 微信 + - img: /img/alipay.jpg + link: + text: 支付寶移除JS-COOKIES
CDN: - js_cookies: https://cdn.jsdelivr.net/npm/js-cookie/dist/js.cookie.min.js可為文章配置是否顯示TOC,即使配置中已把toc設為false
Fix
- 修正側邊欄目錄收縮、展開圖標不對齊的bugs
- 修改部分用語(zh-CN/zh-TW/en)
- 修復card-categories和card-archives 邊緣點擊沒有跳轉的bugs
- 修復網站是子目錄時，社交網站為相對地址時，地址生成錯誤的bugs
- 修復最後一篇文章的Pagination沒有佔據全寬度的Bug
- 修復推薦文章佈局在microsoft edge(舊版)顯示的Bug
- 修復閲讀模式下 黑色代碼框下字體顯示不清楚 #223
- 修復當blog_title_font不是設置google字體時，加載了preconnect //fonts.googleapis.com 的bugs
- 修復設置copy為false時，會導致代碼複製也無法複製的bugs
- 閲讀模式調整
- 修復部分壓縮軟件壓縮html報錯的bugs
2.3.5(2020/05/01)
2.3.5 (2020/05/01)
Feature
beautify 可配置生效於全站還是post頁 #218
beautify: enable: true + field: post # site/post title-prefix-icon: '\f0c1' title-prefix-icon-color: '#F47466'更換lazyload js
-lazyload: - enable: true +lazyload: true CDN: - lazyload: https://cdn.jsdelivr.net/npm/lazysizes@latest/lazysizes.min.js + lazyload: https://cdn.jsdelivr.net/npm/lozad/dist/lozad.min.js增加文章anchor配置
+ # anchor + # when you scroll in post , the url will update according to header id. + anchor: false
Fix
- 修復當menu沒設置圖標時，會報Cannot read property ‘trim’ of undefined 的bug
- 修復meta description 自動生成文章前200文字時部分沒有轉義的bug
- 修復開啟lazyload後，使用 無法顯示照片的bug
- 修復tags頁標籤只顯示8個的bug
- 修復當博客root不是’/‘時,引用本地圖片會顯示不出的bug
- 修復替換url hash 導致頁面跳動的bug
2.3.0(2020/04/26)
2.3.0(2020/04/26)
Breaking Change
增加Facebook Comments
+# Facebook Comments Plugin +# https://developers.facebook.com/docs/plugins/comments/ +facebook_comments: + enable: false + app_id: + user_id: # optional + pageSize: 10 # The number of comments to show + order_by: social # social/time/reverse_time + lang: en_US # Language en_US/zh_CN/zh_TW and so on + count: false增加頁面加載動畫Preloader #193
+# 加載動畫 Loading Animation +preloader: falseaside card-tags可配置是否顯示顏色/aside subtitle可配置，優先顯示配置內容、沒有的顯示頁面subtitle #191 /aside widget 增加部分參數可配置/aside widget的Categories，Tags，post,Archives可配置limit/整合公告欄配置到aside去
aside: enable: true mobile: true # 手機頁面( 顯示寬度 < 768px )是否顯示aside內容 position: right # left or right - card_author: true - card_announcement: true - card_recent_post: true - card_categories: true - card_tags: true - card_archives: true + card_author: + enable: true + description: + card_announcement: + enable: true + content: This is my Blog + card_recent_post: + enable: true + limit: 5 # if set 0 will show all + card_categories: + enable: true + limit: 8 # if set 0 will show all + card_tags: + enable: true + limit: 40 # if set 0 will show all + color: false + card_archives: + enable: true + 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 card_webinfo: true -# 網站公告 -announcement: - content: 感謝訪問本站，若喜歡請收藏 ^_^改CDN_USE為inject,可插入代碼到head或者bottom
-# CDN -# 網站必須 -# 可根據需要自行添加js/css -CDN_USE: - css: - - /css/index.css - js: - - https://cdn.jsdelivr.net/npm/jquery@latest/dist/jquery.min.js #/js/third-party/jquery.min.js - - /js/utils.js - - /js/main.js +# inject +# 插入代碼到頭部</head>之前 和 尾部</body>之前 +inject: + head: + # - <link rel="stylesheet" href="xxxxx"> + bottom: + # - <script src="xxxx"></script> # CDN # 非必要不要修改 CDN: + # main + main_css: /css/index.css + jquery: https://cdn.jsdelivr.net/npm/jquery@latest/dist/jquery.min.js + main: /js/main.js + utils: /js/utils.js適配valine 1.4.5以上版本
valine: enable: false # if you want use valine,please set this value is true appId: # leancloud application app id appKey: # leancloud application app key notify: false # valine mail notify (true/false) Deprecated in v1.4.0+ verify: false # valine verify code (true/false) Deprecated in v1.4.0+ pageSize: 10 # comment list page size avatar: monsterid # gravatar style https://valine.js.org/#/avatar lang: en # i18n: zh-CN/zh-TW/en/ja placeholder: Please leave your footprints # valine comment input placeholder(like: Please leave your footprints ) guest_info: nick,mail,link #valine comment header info recordIP: false # Record reviewer IP serverURLs: # This configuration is suitable for domestic custom domain name users, overseas version will be automatically detected (no need to manually fill in) + emojiCDN: # emoji CDN + enableQQ: false # enable the Nickname box to automatically get QQ Nickname and QQ Avatar + requiredFields: nick,mail # required fields nick/mail/link bg: /img/comment_bg.png # valine background count: false # dispaly comment count in top_img移除對文章隱藏的支持
Feature
- 增加標籤外掛 tag-toggle
- 適配hexo-generator-indexed插件
- Dark mode和Read mode配色微調
- 增加頁面keywords設置 #191
- algolia-search highlight文字加深
- 調整子目錄的排版(向左對齊)
- 調整aside和mobile sidebar 網頁資訊佈局，當缺少一個時，寬度依舊平分
- sidebar menu 增加頭像轉圈hover
- 當沒有設置Description時，會自動讀取文章前200個文字作為meta Description
- meta增加article:published_time和article:modified_time
- subtitle修改為網頁加載完後再加載，防止API迴應過慢而阻礙網頁顯示
- 移除subtitle金山詞霸每日一句，增加搏天API的隨機語錄
- 本地搜索支持顯示文章內容和高亮keyword
- Read mode下可以切換Dark mode和Light mode
- 高分辨率下的界面適配 #163
- 修復Dark Mode下，note標籤的顯示bug
- 添加 dns_prefetch
Fixed
- 修復 articleSort 設置文章封面邏輯不一致的問題 #194
- 修正zh-TW部分用語
- 修復hide-block 配置顏色顯示出錯的bug
- 修復只能點擊子目錄文字才能跳轉的bug
- 修復搜索結果在手機端無法滾動的bug
- 修復aside categories 查看更多跳轉到tags頁面的bug #188
- 修復當flink.yml內容為空時，報錯的bug
- 修復Dark mode下 aside 查看更多文字顏色太淺的bug
- 修復POST-META關閉閲讀分鐘和訪問量後,評論量前有分割線的bug
- 修復canvas_ribbon透明度變為1再變回預設值bug
- 修復當default_cover沒設置時，會出現無圖片的bug
- 修復文章頁替換url hash值而導致歷史記錄過多的問題
- 修復DarkMode下，note標籤的顯示bug
2.2.5(2020/03/28)
2.2.5(2020/03/28)
Breaking Change
增加自動廣告位置
+ad: + index: + aside: + post:增加圖片Figcaption顯示
+ photofigcaption: false增加全站總字數顯示，可配置是否關閉wordcout閲讀時間/字數統計/全站總字數
wordcount: enable: false + post_wordcount: true + min2read: true + total_wordcount: true
Feature
- 文章頁上滑出現的頂欄顯示目錄
- 全站post-meta增加提示文本(Tooltip Text)
- 調整文章頁post-meta和主頁post-meta的間距
- 文章頁，當設置只顯示一個日期時，增加文字顯示
Fixed
- 修復lazyload中，img標籤的class在src後面時，導致替換出錯的bug
- 修復複製版權信息url為undefined的bug
- 修復aside 的 “查看更多” 不居中的bug
- 修復highlight_shrink設為false時,js報錯的bug
- 修復highlight_shrink設為true,點擊無反應，沒有打開代碼框的bug
- Darkmode下，出現切換按鈕icon沒有改變的bug
- 修復簡繁轉換無效的bug
- 修復首頁文章日期顯示錯誤的bug
- 修復因註釋掉豆瓣設置導致報Cannot read property ‘meta’ of undefined的bug
- 修復Gitalk報Error: Cannot read property ‘repository’ of undefined 的bug
- 修復評論utterances 在display_mode設置為dark時，仍顯示light主題的bug
- 修復display_mode設置dark沒有效果的bug
- 評論增加夜間模式、文章頁判斷,減少不必要的js加載
2.2.0 (2020/03/17)
2.2.0 (2020/03/17)
Breaking Change
不再支持hexo 4.0.0以下版本
添加hexo fragment_cache,加快生成速度
+ fragment_cache: true完善V5圖標顯示，不再需要同時加載V4和v5圖標
+ fontawesome_v5: + enable: false CDN_USE: css: - /css/index.css - - https://cdn.jsdelivr.net/npm/font-awesome@latest/css/font-awesome.min.css - - https://cdn.jsdelivr.net/npm/@fortawesome/fontawesome-free/css/all.min.css #fontawesomeV5_css CDN: + # fontawesome + fontawesome_v4: https://cdn.jsdelivr.net/npm/font-awesome@latest/css/font-awesome.min.css + fontawesome_v5: https://cdn.jsdelivr.net/npm/@fortawesome/fontawesome-free/css/all.min.css去除cheerio依賴
整合豆瓣配置，增加配置遊戲，圖書頁面top_img,可設置是否設置meta,解決部分瀏覽器無法顯示圖片問題
- # 如果你有使用hexo-douban去生成movie界面，可配置這個 - movies_img: https://cdn.jsdelivr.net/gh/jerryc127/butterfly_cdn@2.1.0/top_img/movie.jpg + douban: + meta: false + movies_img: + books_img: + games_img:友情鏈接除列表外可自定義內容
可設置主頁標題距離頂部距離
# 主頁設置 # 默認top_img全屏，site_info在中間 # 使用默認, 都無需填寫(建議默認) +index_site_info_top: # 主頁標題距離頂部距離 例如 300px/300em/300rem/10% index_top_img_height: # 主頁top_img高度 例如 300px/300em/300rem 不能使用百分比側邊欄可隱藏,可設置手機頁面是否隱藏
-aside_mobile: true aside: + enable: true + mobile: true # 手機頁面( 顯示寬度 < 768px )是否顯示aside內容 position: right # left or right card_author: true增加disqusjs和utterances 兩個評論
+disqusjs: + enable: false #開啟改為 true + shortname: + siteName: + apikey: + api: https://disqus.skk.moe/disqus/ #一般情況下無需修改 API 地址 + admin: + adminLabel: + count: true # top_img顯示評論數 + utterances: + enable: false + repo: jerryc127/jerryc127.github.io # 可選 pathname/url/title/og:title + issue_term: pathname # 可選 github-light/github-dark/github-dark-orange/icy-dark/dark-blue/photon-dark + light_theme: github-light + dark_theme: photon-dark首頁subtitle可關閉打字效果，可設置打字效果顯示一次或loop
subtitle: enable: true + # 打字效果 + effect: true + # 循環或者只打字一次 + loop: false # source調用第三方服務 # source: false 關閉調用 # source: 1 調用金山詞霸的每日一句(簡體) # source: 2 調用一言網的一句話(簡體) #https://hitokoto.cn/ # source: 3 調用一句網(簡體) http://yijuzhan.com/ # source: 4 調用今日詩詞(簡體) https://www.jinrishici.com/ # subtitle 會先顯示 source , 再顯示 sub 的內容 source: 2 # (如果有英文逗號' , '，請使用轉義字符 ,) # 如果關閉打字效果，subtitle只會顯示sub的第一行文字 sub: - 今日事,今日畢 - Never put off till tomorrow what you can do today增加valine和gitalk的配置
gitalk: enable: false client_id: client_secret: repo: owner: admin: language: zh-CN # en , zh-CN , zh-TW + perPage: 10 # Pagination size, with maximum 100. + distractionFreeMode: false # Facebook-like distraction free mode. + pagerDirection: last # Comment sorting direction, available values are last and first. + createIssueManually: false # Gitalk will create a corresponding github issue for your every single page automatically count: true # top_img顯示評論數 valine: enable: false # if you want use valine,please set this value is true appId: # leancloud application app id appKey: # leancloud application app key notify: false # valine mail notify (true/false) https://github.com/xCss/Valine/wiki verify: false # valine verify code (true/false) pageSize: 10 # comment list page size avatar: monsterid # gravatar style https://valine.js.org/#/avatar lang: en # i18n: zh-cn/en placeholder: 記得留下你的暱稱和郵箱....可以快速收到回覆 # valine comment input placeholder(like: Please leave your footprints ) guest_info: nick,mail,link #valine comment header info + recordIP: false # Record reviewer IP + serverURLs: # This configuration is suitable for domestic custom domain name users, overseas version will be automatically detected (no need to manually fill in) bg: /img/comment_bg.png # valine background count: true # top_img顯示評論數darkmode配置整理
- # 夜間模式 - darkmode: - enable: true -# 自動切換 dark mode和 light mode -# autoChangeMode: 1 跟隨系統而變化，不支持的瀏覽器/系統將按照時間晚上6點到早上6點之間切換為 dark mode -# autoChangeMode: 2 只按照時間晚上6點到早上6點之間切換為 dark mode -# autoChangeMode: false 取消自動切換 -autoChangeMode: false + darkmode: + enable: true + # dark mode和 light mode切換按鈕 + button: true + # 自動切換 dark mode和 light mode + # autoChangeMode: 1 跟隨系統而變化，不支持的瀏覽器/系統將按照時間晚上6點到早上6點之間切換為 dark mode + # autoChangeMode: 2 只按照時間晚上6點到早上6點之間切換為 dark mode + # autoChangeMode: false 取消自動切換 + autoChangeMode: false增加404頁面
+# A simple 404 page +error_404: + enable: true + subtitle: "頁面沒有找到" + background:post_beautify改為beautify，頁面美化不再只限於post頁，page頁也一樣
-post_beautify: +beautify: enable: true title-prefix-icon: '\f0c1' title-prefix-icon-color: "#F47466"可設置是否顯示cover，可設置各位置的cover顯示
-# the default cover of the post -default_cover: https://cdn.jsdelivr.net/gh/jerryc127/butterfly_cdn@2.1.0/top_img/default.png -index_post_cover: both +cover: + # 是否顯示文章封面 + index_enable: true + aside_enable: true + archives_enable: true + # 封面顯示的位置 + # 三個值可配置 left , right , both + position: both + # 當沒有設置cover時，默認的封面顯示 + default_cover:增加mermaid,可畫流程圖、狀態圖、時序圖、甘特圖等等
+# https://github.com/knsv/mermaid +mermaid: + enable: true + # built-in themes: default/forest/dark/neutral + theme: default增加pangu配置，中英文之間添加空格
+# https://github.com/vinta/pangu.js +# 中英文之間添加空格 +pangu: + enable: true + field: page # page/post整合部分配置
-avatar_effect: false +avatar: + img: /img/avatar.png + effect: true # 頭像會一直轉圈post-copyright增加decode網址 (可以顯示中文)
post_copyright: enable: true + decode: false license: CC BY-NC-SA 4.0 license_url: https://creativecommons.org/licenses/by-nc-sa/4.0/增加部分顏色配置
theme_color: enable: true main: "#49B1F5" paginator: "#00c4b6" button_hover: "#FF7242" text_selection: "#00c4b6" link_color: "#99a9bf" meta_color: '#858585' hr_color: "#A4D8FA" - read-mode-bg_color: '#FAF9DE' - inline-code-color: '#F47466' + code_foreground: "#F47466" + code_background: "rgba(27, 31, 35, .05)" + toc_color: "#00c4b6" + blockquote_padding_color: "#49b1f5" + blockquote_background_color: "#49b1f5"主頁文章增加tags和更新日期顯示，可以配置post_meta
post_meta: - date_type: both # or created or updated 文章日期是創建日或者更新日或都顯示 - categories: true # or false 是否顯示分類 - tags: true # or false 是否顯示標籤 + page: + date_type: both # created or updated or both 主頁文章日期是創建日或者更新日或都顯示 + categories: true # true or false 主頁是否顯示分類 + tags: true # true or false 主頁是否顯示標籤 + post: + date_type: both # created or updated or both 文章頁日期是創建日或者更新日或都顯示 + categories: true # true or false 文章頁是否顯示分類 + tags: true # true or false 文章頁是否顯示標籤
Feature
- 適配IE
- 增加一個Tag Plugins: 圖庫集
- 增加一個Tag Plugins: tag-hide 功能 inline/block
- 去除page頁開頭顯示與標題一樣的內容
- aside 公告欄設置，支持html代碼
- 手機界面sidebar顯示進度條和加深對應的標題
- 主頁subtitle 的 hitokoto 顯示內容出處
- footer 的hexo鏈接改為https
- 修改手機下，menus和toc的打開效果
- 手機頁面下，搜索界面全屏顯示
- SEO優化，標題欄改為h1顯示
- 閲讀模式優化，可根據light mode 和darkmode調整背景
- 當屏蔽js時，header會出現(之前用js控制，會隱藏)
Fixed
- 修復Tencent Analytics的script加載為https #105
- 修復相關文章，日期顯示錯誤bug
- 修復gitalk報錯問題
- 修復當valine background 是絕對地址時無法顯示的bug
- 修復medium-zoom 無法使用的bug
- 修復在safari下，點擊或移動到首頁文章cover，圓角變成正方形的bug #114
- 修復在部分瀏覽器下，aside,友情鏈接頭像轉動變形的bug
- 修復在寬度限制下，表格內容溢出屏幕外而出現滾動條的bug #138
- 修復gitalk js 在一些沒有設置評論的page里加載的bug
- 修復tag plugins 的gist 在不同主題下的背景顏色問題(黑色主題下，文字不易觀看)
- 修復highlight figcaption 顯示不全的bug
- 修復disqus評論數無法獲取的bug
- 修復子目錄在觸摸屏下點擊,偶爾不出現的bug
- 修復a標籤太長(連續英文字母)不會換行的bug
- 修復toc滾動時，閲讀進度條也跟着滾動的bug
- 修復aside的圖片，可點擊顯示大圖bug
- 修復activate-power-mode設置參數無效bug
- 修復語言上的錯誤 #156
- 修復主頁在safari桌面端，首頁滾動卡頓的bug
2.1.0 (2019/12/20)
2.1.0 (2019/12/20)
Feature
- 可設置隱藏文章
- 適配 Hexo 的 Tag Plugins Code Block With marked lines 顯示
- 可配置首頁 cover 顯示的位置
- 更改深色模式下的配色
- activate_power_mode 增加關閉顏色和抖動
- 增加谷歌廣告，騰訊分析
- 相關文章增加時間顯示，調整佈局，垂直居中
- 文章頁面，top_img 增加評論數顯示
- 可以取消點擊圖片觀看大圖
- mathjax 和 kathex 可設置每頁都加載還是按需加載
- 深色模式下，滾動條顏色的適配
- 優化 gitalk 在 dark mode 下的顯示
- 文章頁，文章標題過長時，只顯示三行內容
- 深色模式下，背景圖片加上蒙板
- 優化深色/閲讀模式下，canvas 的顯示
- 優化打賞的特效和移動到二維碼不會立刻消失
- 優化 sub-menu 樣式
- 修改 aside 的 tags 顏色，在深色模式下不會出現觀看困難
- 升級 normalize.css 到最新版
- 優化手機上 toc 和 menu 的打開動畫
- 優化代碼框打開關閉的特效
- 精簡 js,部分操作改為 css 控制
- 優化主題的一些動畫，不會過於生硬
Fixed
- 修復當圖片被 a 標籤包圍時，點擊圖標沒有跳轉到對應網頁而是出現大圖觀看模式的 bug
- 修復當網址有 subdirectory 時，menu、打賞二維碼和 lodding_bg 鏈接路徑錯誤的 bug
- 修復當網址有 subdirectory 時,
- 修復 katex 的 CSS 無法讀取 bug
- 修復搜索按鈕在文章頁不顯示的 bug
- 修復 gitalk css 引用失敗的 bug
- 修復 點擊特效 煙花 無效的 bug
- 修復 gitalk 報 path.startsWith is not a function 的 bug
- 修復 閲讀模式下，背景沒有變純色的 bug
- 修復閲讀模式下，header 偶爾出現沒有靠攏頂部的 bug
- 修復 Hexo Tag Plugins Block Quote 裏的鏈接顯示出外面的 Bug
- 修復 aside 歸檔日期過長導致錯位的 bug
- 修復 toc 為空時，toc 按鈕仍存在的 bug
- 修復關閉懶加載後，頭像無法顯示的 bug
- 修復深色模式下，切換 readmode 偶爾會無效的 bug
- 修復在一些手機設備上，toc 和 menu 的按鈕顯示不對齊的 bug #72
2.0.0 (2019/11/03)
2.0.0 (2019/11/03)
Breaking change
- 手機端界面卡片化，同時，手機端也可以顯示側邊欄的內容
- 修復當menu過多時，header界面出現錯亂的bug。當menu過多時，會變為sidebar模式
- 增加medium-zoom大圖查看模式
- 增加鼠標點擊特效：文字和愛心 兩個點擊特效
- 主頁subtitle可以調用第三方api(金山詞霸每日一句、一言網的一句話、一句網、今日詩詞)
- 添加 snackbar 彈窗
- 修改nightshift為darkmode，darkmode可隨系統設置而自動切換，可設置隨時間而切換darkmode
- 修復hexo自帶的標籤外掛(Tag Plugins)顯示bug(Block Quote、Code Block With caption、Gist、Youtube、Vimeo)
- 主題所需要的css和js可根據需要配置CDN
- 更改darkmode的加載方式，網站設置dark mode後，現在進入網頁不會在’閃’一下
- 背景特效和背景圖片在手機界面也會顯示
- 增加justified-gallery圖片顯示(Tag Plugins)
Feature
- 文章頁面，字數統計、閲讀時長和閲讀量前面添加icon
- 更改懶加載js
- 升級typed.js/instantpage.js到最新版
- 搜索和右下角按鈕添加退出特效
Fixed
- 修復在 Hexo 4.0.0下，一些按鈕點擊會跳出一個空白頁的bug
- 修復在 Hexo 4.0.0下，分頁按鈕出現代碼的bug
- 修復當沒有設置評論時，右下角依舊出現’直達評論’按鈕的bug
- 優化sidebar的打開速度
- 修復文章頁標題左右邊距不平等的bug
- 修復keywords讀取的bug
- 修復當post/page 內容為空時，footer位置錯亂的bug
- 修復在手機safari，toc sidebar底部內容被遮擋的bug
- 完善Dark mode,一些界面的配色
- 修復 card-archives 查看更多 跳轉bug
Remove
- 移除Gitment
- 移除Gallery
1.2.0 (2019/09/24)
1.2.0 (2019/09/24)
Feature
- 更改手機頁面的menu和toc的顯示方式和顯示特效(ipad也能看TOC)
- 可設置禁止複製網站內容
- 可設置複製時，內容自動加上版權信息
- 可修改tag的top_img
- 可修改category的top_img
- 可修改valine的背景
- archives頁UI優化
- ICP增加icon #37
- 可設置主頁top_img的高度
- 可設置主頁site-info的位置
- category頁和tag頁的UI可以設置與主頁UI一樣 #31
- 主頁subtitle可設置多個句子(不再限制2個) #37
- 設置menu時，頭尾添加空格不受影響
- 調整post頁的佈局
- 書籤添加icon
- 公告icon效果
- 首頁歸檔模塊，可設置數量限制，會顯示’查看更多’按鈕
- 右下角按鈕調整。
Fix
- 修復文章cover隨機圖片生成，同一篇文章，不同地方的cover顯示不一樣的bug
- 修復gitalk語言設置無效的bug #35
- 修復post頁面，當沒有設置word count時，閲讀量前有’|”
- 修復sub-menu在safari的顯示問題
- 修復tags頁評論居中問題
- 修復header a hover 白色問題
- 修復夜間模式下footer的顏色bug
- 修復英文語言下，書籤英文顯示不完整的問題
1.1.5 (2019/09/08)
1.1.5 (2019/09/08)
Feature
- Feature: 可設置內聯代碼塊樣式 #26
- Feature: 可設置夜間模式作為默認樣式
- Feature: 可設置是否顯示code language名稱
- Feature: 可設置是否展開或關閉代碼框
- Feature: 可設置背景圖片/顏色
- Feature: 可設置是否顯示footer背景
- Feature: 增加 canvas-nest.js
- Feature: 頭像可設置效果(轉圈圈)
- Feature: menu可設置分組
Fix
- Fix: 優化打賞和搜索打開特效
- Fix: 優化sidebar的打開特效，避免與文章頁特效不同步
- Fix: 適配hexo-blog-encrypt，現在可以顯示toc
- Fix: 修復設置不顯示評論時，直達評論按鈕沒有消失的bug
- Fix: 修復post頁底欄，當沒有顯示評論，不顯示TOC，評論和toc都不顯示 這三種狀態下按鈕的bug
- Fix: 修復代碼框左右滑動時，代碼名字跟着滑動的bug
- Fix: 其他page頁標題的字體顯示
- Fix: 修復當設置開啟canvas_ribbons，進入網站會先顯示canvas_ribbons的bug
- Fix: 完善夜間模式下，字體顯示問題
- Fix: 修復代碼框 複製 和 代碼名 z-index bug #25
- Fix: 完善閲讀模式
1.1.0 (2019/08/29)
1.1.0 (2019/08/29)
Feature
- Feature: 手機menu界面重新設計
- Feature: 文章頁增加美化(原 melody主題功能),並增加更改標題前綴圖標和顏色
- Feature: PC端增加直達評論按鈕
- Feature: 可以對單獨文章設置是否顯示版權信息
Fix
- Fix: 修復閲讀模式下，調整字體大小對代碼無效的bug
- Fix: 調整Valine字體顯示問題
- Fix: 修正夜間模式下Valine的適配問題
- Fix: 修復Valine設置notify和verify無效的bug (thx @VincentTV )
- Fix: 修復使用hexo-asset-image,開啟懶加載後，圖片會出現無法加載問題
- Fix:修復 ‘返回頂部’箭頭無法點擊的bug
Remove
- Remove: 去掉主題”閲讀更多”按鈕
1.0.8 (2019/08/11)
1.0.7 (2019/07/29)
1.0.7 (2019/07/29)
Feature
- Feature: add the option to change the site name font-family
- Feature: add the option to close instant-page
- Feature: the sidebar can auto scroll when the toc out of the screen
Fix
- Fix: random cover of previous post and next post
- Fix: Display null when the subtitle not set
- Fix: display related post’s headline when it is not related posts
- Fix: the bugs of image display
- Fix: When the picture is loaded, the picture appears black frame
1.0.6 (2019/07/06)
1.0.5 (2019/06/28)
本博客所有文章除特别声明外，均采用 CC BY-NC-SA 4.0 许可协议。转载请注明来自 张赛东！
微信
支付宝
