Butterfly 更新日誌

4.9.0 之後的更新日誌將會單獨文章發佈，請查看更新日誌

你可以通過右下角的簡按鈕切換為簡體顯示

4.9.0 (2023/06/06)

Feature

適配 mermaid v10
大於 2000px 時，顯示區域增大

可配置 header 和 footer 是否添加黑色半透遮罩

+# Add mask to header or footer (為 header 或 footer 添加黑色半透遮罩)
+mask:
+  header: true
+  footer: true

artalk 最新評論改為 api 直接調用
waline 最新評論和評論數改為 api 直接調用
再次點擊右下角聊天按鈕，可關閉聊天
適配新版 artalk
支持隨機友鏈順序

Fix

修復行內 mathjax 出現滾動條的 bug
修復當 top_img 為顏色時，閲讀模式的頂部依舊顯示顏色的 bug
修復配置 subtitle 的 sub 沒有生效的 bug

Improvement

更新 hexo-renderer-stylus
hr 的美化優化，避免影響第三方插件佈局
優化 mediumZoom
首頁微調
當配置了最新評論時，沒有配置評論時，不會再報錯
tidio,crisp,daovoice,messenger 和 chatra 代碼優化

4.8.5 (2023/05/09)

Feature

artalk 支持點擊打開大圖
設置了隨系統而切換淺色和深色模式後，評論和 mermaind 也會跟隨切換顏色
artalk 最新評論，從 artalk 配置讀取頭像 CDN 和默認頭像

Fix

修復 Artalk 無法獲取最新評論的 bug
修復代碼塊在未展開時，點擊複製按鈕，無法複製的 bug

Improvement

代碼和性能優化
artalk 獲取評論數，由 LoadCountWidget 改為 loadCountWidget

4.8.1 (2023/04/10)

Fix

修復 CDN 的 internal_provider 設為 jsdelivr 時，主題的 js 無法加載的 bug

4.8.0 (2023/04/10)

Breaking Change

移除 gitter

-# gitter
-# https://gitter.im/
-gitter:
-  enable: false
-  room:

CDN option 部分參數名字修改

CDN:  
  option:
-    # algolia_search_v4:
-    # instantsearch_v4: 
-    # fancybox_css_v4:
-    # fancybox_v4:  
-    # fontawesomeV6:

+    # algolia_search:
+    # instantsearch: 
+    # fancybox_css:
+    # fancybox:  
+    # fontawesome:

Feature

social 可配置顏色

支持 abcjs 樂譜渲染

+# abcjs (樂譜渲染)
+# See https://github.com/paulrosen/abcjs
+# ---------------
+abcjs:
+  enable: false
+  per_page: true

適配 typed.js 新版本
Algolia 搜索，點擊文章內容也會跳轉到相應頁面

重構本地搜索

# Local search
local_search:
  enable: false
  # Preload the search data when the page loads.
  preload: false
+  # Show top n results per article, show all results by setting to -1
+  top_n_per_article: 1
+  # Unescape html strings to the readable one.
+  unescape: false
  CDN:

升級 fancybox 到 v5
更新 facebook js 版本
CDN 配置了 version 為 true, 本地鏈接也會加上版本號
支持自定義 giscus 評論系統的 JS 地址
1
2
3
CDN:
option:
+ giscus: xxxxx

新增自定義深淺模式切換時間

# dark mode
darkmode:
+  # Set the light mode time. The value is between 0 and 24. If not set, the default value is 6 and 18
+  start: # 8
+  end: # 22

Fix

修復 safari 下，搜索內容被系統搜索框遮擋的 bug
修復 fullpage loading 顯示滾動條的 bug
修復 card_tags.color: true 時遇到 limit 失效問題
修復設置圖片時，圖片後綴大寫而導致識別錯誤的 bug
修復開啟 archor 後， pace.js 會隨着 archor 添加而觸發的問題

Improvement

當瀏覽器寬度大於2000px時，卡片寬度由 1500px 改為 1700px
當沒有開啟 beautify 時， hr 顯示默認的樣式
手機 safari 橫屏時，網頁全屏幕顯示
社交圖標的 hover 旋轉180度
優化 viewport seo
代碼優化

4.7.0 (2023/02/20)

Feature

card_tags 可配置 orderby 和 order

aside:
  card_tags:
    enable: true
    limit: 40 # if set 0 will show all
    color: false
+    orderby: random # Order of tags, random/name/length
+    order: 1 # Sort of order. 1, asc for ascending; -1, desc for descending
    sort_order: # Don't modify the setting unless you know how it works

標籤頁支持配置 orderby 和 order 參數

添加 docsearch

+# Docsearch
+# https://docsearch.algolia.com/
+docsearch:
+  enable: false
+  appId:
+  apiKey:
+  indexName:
+  option:

本地搜索，點擊文章內容也會跳轉到相應頁面
gallery 標籤外掛增加 json 獲取

Fix

修復 card_author 和 card_announcement 設為 false 後，aside 卡片沒有間距的 bug
artalk 最新評論無法加載
修復 waline 在 pjax 模式下 css 沒有加載的 bug
修復本地搜索,部分符號無法搜索的 bug

Improvement

getCSS 重構
滾動條變小

4.6.1 (2023/01/18)

hideToggle 4.6.1 (2023/01/18)

Breaking Change

可配置 typed.js 的參數

subtitle:
-  # Effect Speed Options (打字效果速度參數)
-  startDelay: 300 # time before typing starts in milliseconds
-  typeSpeed: 150 # type speed in milliseconds
-  backSpeed: 50 # backspacing speed in milliseconds
-  # loop (循環打字)
-  loop: true
+  # Customize typed.js (配置typed.js)
+  # https://github.com/mattboldt/typed.js/#customization
+  typed_option:

Fix

修復 typeJSFn 重複賦值的 bug
修復固定狀態欄後，標題有陰影的 bug
修復 gallery 標籤將圖片鏈接截斷導致404無法加載圖片的 bug
修復開啟導航欄固定後，點擊部分滾動向上的按鈕，滾動的目標部分被導航欄遮擋的 bug
修復固定導航欄後，toc 被遮擋的 bug

Improvement

切換簡繁時，會改變 html 的 lang 屬性

4.6.0 (2023/01/15)

Breaking Change

cover 的顯示優化 #1101
當 cover 設置為 false，或者沒有獲取到 cover 的值時，文章頁相關推薦和分頁按鈕背景顯示為主題色

Feature

toc可設置是否顯示預覽進度
1
2
toc:
+ scroll_percent: true

右下角按鈕增加預覽進度顯示

1 2	+# show scroll percent in scroll-to-top button +rightside_scroll_percent: true

cover 可設置顏色/漸變色等配置
default_cover 可配置顏色
導航欄設置：隱藏博客名字 / 設置 logo / 設置固定導航欄 # 1150 #1104
1
2
3
4
+nav:
+ logo: # image
+ display_title: true
+ fixed: false # fixed navigation bar
不蒜子可配置 CDN #1132
gallery 標簽外掛增加圖片懶加載，增加 lazyload rowHeight 和 limit 屬性配置
更新 plugins.yml

Fix

修復 hexo-log 讀取不到的 bug #1102
修復使用本地搜索時，輸入特殊符號沒有顯示結果的 bug
修復頂部圖和 footer 配置帶有/的顏色參數時，無法顯示顏色的 bug
修復閲讀模式下，代碼塊的背景顏色仍顯示彩色背景的 bug (自定義代碼塊) #1139
修復開啟懶加載後，再使用 flink_url 的方式引入友鏈數據，友鏈頭像有可能不顯示的 bug #1146
修復 pjax 下， waline js 會重複加載的 bug

Improvement

日期設置相對日期時，文章的日期格式和最新評論的日期格式統一為年月日
修復使用本地搜索時，輸入特殊符號沒有顯示結果的 bug
鼠標移動到分頁時，文章分頁按鈕增加説明文字
文章頁的頂部圖顯示次序為 top_img > cover > default_top_img
修改配置文件註釋
優化搜索結果顯示滾動條位置
搜索結果換行時不會拆分單詞顯示
canonical 的鏈接根據配置生成

Remove

移除 cnzz 分析

1
2
3

-# CNZZ Analytics
-# https://www.umeng.com/
-cnzz_analytics:

4.5.1 (2022/10/31)

Fix

修復 mathjax 行內公式導致行距過密的 bug
修復更新 mathjax 新版本後，mathjax 會溢出屏幕而不是顯示滾動條的 bug

Improvement

避免沒更新主題文件而導致 anchor 配置報錯的問題
更新 plugins.yml

4.5.0 (2022/10/21)

Breaking Change

Open_Graph_meta 設置更改，可配置其它參數

-Open_Graph_meta: true
+Open_Graph_meta:
+  enable: true
+  option:

preloader 設置更改，增加 pace.js 加載動畫條

-preloader: false
+preloader:
+  enable: false
+  # source
+  # 1. fullpage-loading
+  # 2. pace (progress bar)
+  source: 1
+  # pace theme (see https://codebyzach.github.io/pace/)
+  pace_css_url:

anchor 設置更改，可單獨設置按鈕和自動更新 anchor 是否開啟，可設置 button 圖標，可設置 button 總是顯示

-anchor: false
+anchor:
+  button:
+    enable: false
+    always_show: false
+    icon: # the unicode value of Font Awesome icon, such as '\3423'
+  auto_update: false # when you scroll in post, the URL will update according to header id.

Feature

更新 Facebook sdk 到 v15

Fix

修正 throttle 函數調用方式 #1075
修復控制枱報 loadFBComment error 的 bug #1066
修復屏幕寬度為 768px 時的佈局混用問題 #1032

Improvement

簡繁轉換增加部分字 #1076
本地預覽，友情鏈接頁面刷新，內容不會重複顯示
更新 plugins.yml

Remove

移除 meta keywords

4.4.0 (2022/08/18)

Feature

在綫聊天新增 facebook 洽談外掛程式 messenger

+messenger:
+  enable: false
+  pageID:
+  lang: zh_TW # Language en_US/zh_CN/zh_TW and so on

添加 artalk 評論功能

+artalk:
+  server:
+  site:
+  visitor: false
+  option:

首頁打字效果增加參數配置

subtitle:
...
+  # Effect Speed Options (打字效果速度參數)
+  startDelay: 300 # time before typing starts in milliseconds
+  typeSpeed: 150 # type speed in milliseconds
+  backSpeed: 50 # backspacing speed in milliseconds
...

Fix

修復開啟 archor 後， facebook 評論加載不正確的 bug
修復 facebook 評論數無法加載的 bug
修復子目錄 hover 沒有圓角的 bug #965

4.3.1 (2022/06/27)

Fix

當設置 comments 為 false 時，如果設置了顯示評論提供的閲讀數，閲讀數無法顯示的 bug
findArchivesTitle bug

4.3.0 (2022/06/24)

Breaking Change

archives 隱藏aside 設置更改

aside:
-  archive: true
+  display:
+    archive: true

適配 disqusjs 3.0

Feature

子歸檔頁面顯示的文章數量不再顯示總文章數量，而是對應的子歸檔文章數量
為一些數據加載增加 loading 顯示

tag 和 category 頁面可設置隱藏 aside

aside:
+  display:
+    tag: true
+    category: true

點擊歸檔日期跳轉到頁面，標題顯示日期而不是‘歸檔’二字
適配 katex 升級，移除 katex copy-tex.css
CDN 可一鍵配置 cdnjs
CDN 可一鍵配置為 unpkg
cdn可設置 version 和 custom format（自定義格式）
1
2
3
CDN:
+ version: false
+ custom_format:

添加Remark42評論系統支持

+# Remark42
+# https://remark42.com/docs/configuration/frontend/
+remark42:
+  host: # Your Host URL
+  siteId: # Your Site ID
  option:

Fix

Algolia搜索沒有結果
評論系統開啟時 busuanzi 的 page_pv 不顯示
側邊欄歸檔卡片自定義排序異常

Improvement

修改 note 圖標 class 名字，避免第三方圖標覆蓋主題樣式

4.2.2 (2022/05/19)

fix: 修復首頁文章 valine 評論數只顯示第一篇的 bug
fix: 修復子目錄下，第三方插件本地資源無法加載的 bug
fix: 評論系統開啟時 busuanzi 的 page_pv 不顯示的 bug
fix: 修復 pjax 下，使用 mermaid 跳轉會重新加載的 bug
improvement: 優化twikoo評論，無評論數容器時不調用API獲取 #897

4.2.1 (2022/05/11)

Fix

CDN 配置為 local 時 mathjax 字體缺失的 bug

4.2.0 (2022/05/02)

Breaking Change

waline 適配 V2

CDN:
-    waline: 
+    waline_js:
+    waline_css:

waline 的 visitor 改為 pageview

1
2
3

waline:
-  visitor: false
+  pageview: false

cdn 可一鍵設置本地文件/可單獨配置主題文件，第三方文件的 cdn

CDN:
+  # The CDN provider of internal scripts (主題內部 js 的 cdn 配置)
+  # option: local/jsdelivr
+  # Dev version cannot choose jsdelivr (dev版的主題不能設置為 jsdelivr)
+  internal_provider: local
+  # The CDN provider of third party scripts (第三方 js 的 cdn 配置)
+  # option: local/jsdelivr
+  # when set it to local, you need to install hexo-butterfly-extjs
+  third_party_provider: jsdelivr
+  option:

移除 utterances，giscus， addtoany， busuanzi 的 cdn 配置

Feature

algolia 搜索增加文章內容顯示和高亮
搜索內容顯示區域變大

本地搜索增加 preload,cdn 配置 #859

local_search:
  enable: false
+  preload: false
+  CDN:

更新 social-share cdn 版本
歸檔頁面的側邊欄支持隱藏
1
2
aside:
+ archives: true
可配置文章版權模塊的作者超鏈接
1
2
post_copyright:
+ author_href:

Fix

mathjax 顯示不完全的 bug
標題中帶有 HTML 關鍵字時，會破壞相關推薦的渲染 #836

Improvement

搜索標題統一顯示為 ‘搜索’
algolia 搜索的 logo 改為 instantsearch 調用
algolia 第一次進入時不會自動搜索 #867
搜索內容增加 ... 縮略辨識
調整分享按鈕導致的間距問題
html/css 優化

4.1.0 (2022/02/13)

Breaking Change

升級 fontawesome 到 v6 #689
1
2
3
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)

improvement: 優化 pjax 下，右下角按鈕的動畫

fix: 修復頁面設置 aside 為 true 時，js 報錯的 bug

fix: 修復部分頁面右下角按鈕位置遮擋的 bug

fix: 修復壓縮 html 代碼,友情鏈接頁面壓縮會報錯的 bug

fix: 修復safari上滑動側邊菜單欄會收起的 bug

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

1 2	-# Hide the child menu items in mobile sidebar -hide_sidebar_menu_child: false

完全移除 jquery

1 2	CDN: - jquery: https://cdn.jsdelivr.net/npm/jquery@latest/dist/jquery.min.js

移除騰訊分析

1
2
3

-# Tencent Analytics ID
-# https://mta.qq.com
-tencent_analytics:

photofigcaption 和 fancybox 的 figcaption 優先顯示圖片的title屬性，然後是 alt 屬性 #683
支持新的評論名寫法，主題會處理評論名字大小寫，舊的會兼容

移除博天api，注意順序改變

1
2
3

# 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

移除右下角字體調整按鈕

1 2	-# 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
1
2
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顏色

1 2	theme_color: + scrollbar_color: "#49b1f5"

美化 firefox 瀏覽器滾動條
CDN 增加 blueimp_md5 配置
1
2
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)

Fix

修復開啟 photofigcaption 後，導致 inlineImg 標籤外掛顯示錯亂的 bug close #667
修復使用本地搜索時，搜索插件配置為不搜索文章內容會無法使用搜索的 bug close #666
修復可能導致相關文章鏈接出錯的 bug close #549

Improvement

調整代碼框滾動條顏色 close #651
當圖片沒有 figcaption 時，不會添加 figcaption 代碼

3.8.3 (2021/07/30)

Fix

修復 Waline 評論系統設置 avatarCDN 無效的 bug

3.8.2 (2021/07/20)

Fix

修復 footer 在部分瀏覽器沒有顯示在底部的 bug #616

Improvement

修改配置文件註釋 #613

3.8.1 (2021/07/10)

Fix

修復 inline mathjax 有滾動條的 bug
修復友情鏈接的頭像帶有 Medium Zoom 燈箱的 bug #607
修復友情鏈接的頭像帶有 FancyBox 燈箱的 bug #607

Dependencies

update hexo-renderer-pug

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: false

widget 寫法更改/可添加非 sticky 區域 widget

Feature

修改最新評論 icon
waline 顔色適配主題色
增加 waline avatarCDN 配置（最新評論也會更新）
1
2
3
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)

Breaking Change

移除 waline 的 emojiCDN 和 emojiMaps 配置

Fix

修復升級到 waline 1.x 而出現的 bug

3.7.7 (2021/05/11)

Improvement

3.7.6 (2021/05/09)

Fix

修復標題/博客名有 ‘ 時，pjax 會報錯的 bug

Improvement

css 調整

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)

Fix

修復 github-issues 最新評論獲取的url格式 bug
修復當標題有符號'時，disqus 和 disqusjs 無法加載的 bug

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/artitalk

katex_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

新增設置代碼高度限制，顯示展開按鈕
1
+highlight_height_limit: false # unit: px
prismjs 也可以配置 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 配置

1
2
3

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.2 (2021/02/03)

Fix

mathjax 和 katex 沒有加載js的bug

3.6.1 (2021/02/01)

Fix

非ios設備下，手機頁面下文章頁有toc的界面出現滾動條
非ios設備下，在layout標簽內的元素，如是position: fixed，其相對定位會更改 #482 #483

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

最新評論更新
1. <a> 標簽將會顯示 [鏈接]
2. <img>標簽將會顯示 [圖片]
3. <pre><code> 標簽將顯示 [代碼]
4. github-issues 獲取到的 url 改為對應文章地址，而不是issues地址
5. 時間 time 增加 datetime屬性
6. waline 獲取到頭像會先匹配 waline數據庫是否有qq頭像屬性
7. 部分評論顯示的時間改為更新時間
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
1
2
+# 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 配置（默認開啟）

1 2	-# Caches the contents in a fragment, speed up the generation (開啟hexo自帶的緩存,加快生成速度) -fragment_cache: true

3.5.1 (2020/12/31)

Feature

twikoo增加 region 配置

Fix

修復twikoo 廣州地域下，最新評論無法讀取的bugs
修復waline背景設置無效的bugs
修復twikoo 廣州地域下，page 頁進入post頁，twikoo評論報錯的bugs

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

1
2
3

+# Cloudflare Analytics
+# https://www.cloudflare.com/zh-tw/web-analytics/
+cloudflare_analytics:

新增 Microsoft Clarity

1
2
3

+# 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 works

twikoo 增加 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)

Fix

修復開啟 gitalk 評論數後與 toc 衝突的 bug #462
修復 jquery 在一些介面仍然載入問題
修復 medium zoom 報錯的 bug

3.4.1 (2020/12/15)

Fix

修復tabs 標簽外掛設為-1時，按鈕點擊沒反應的bugs

3.4.0 (2020/12/13)

Breaking Change

去除 jQuery

Feature

可配置是否添加css前綴

1 2	+# Add the vendor prefixes to ensure compatibility +css_prefix: true

點擊文字特效增加隨機配置

ClickShowText:
  enable: false
  text:
    - I
    - LOVEeeeeeeeeeeeee
    - YOU
  fontSize: 15px
+  random: true
  mobile: false

右下角增加字體調整按鈕

1 2	+# 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)

Breaking Change

只支持 hexo 5.0.0 及以上版本
不再支持 butterfly.yml 寫法

Feature

Valine 增加 option 設置
1
2
valine:
+ option:
toc改為aside顯示,去掉sidebar
1. 手機toc ui 修改
2. 去掉 toc auto_open 配置
  1
  2
  3
  4
  toc:
  enable: true
  number: true
  - auto_open: true # auto open the sidebar
3. 優化手機toc 的特效和按鈕出現的時機
4. aside狀態存localStorage
文章標題改為居中

aside 可配置隱藏/增加按鈕可展開或收縮aside

aside:
  enable: true
+  hide: false
+  button: true
  mobile: true # display on mobile

增加Twikoo評論
1
+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)

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）
1
+tag_per_img:
增加 category_per_img 配置（可為各個category單獨配置top_img）
1
+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

網頁進入動畫效果可關閉

1 2	+# 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裏

1 2	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)

Fix

修復關閉last push date 後，報 'hour' 找不到的bugs
修復開啟 prismjs 後，在低版本的 safari 會出現 js 報錯的 Bugs

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 子菜單

1 2	+# 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)

Fix

修復導航側邊欄沒有進入特效的Bugs
修復Hexo 5.0.0 以下版本， toc遇到中文不會滾動的bugs
修復pjax下，同時開啟Open_Graph_meta和Livere，Livere評論後台顯示的來源頁面與實際不同的bugs

3.0.0 (2020/08/05)

Fix

修復文章頁沒有lazyload的bugs
修復文章頁沒有lazyload的bugs

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: false

footer配置整理，修改部分用語 #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/xxxxxx

copy的copyright增加字數限制配置，可配置多少字以上才添加版權信息

copy:
  enable: true
-  copyright: false
+  copyright:
+    enable: false
+    limit_count: 50

aside 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配置

1
2
3

+# 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

1	-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)

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:00

laibili 改名為 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: true

font去除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配置

1
2
3

-# 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 設為默認生成不再提供配置

1 2	-# 避免重複網址分散seo -canonical: true

instantpage js 加載增加defer

fireworks 增加z-index配置

1
2
3

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按鈕與底部的距

1 2	+# 右下角按鈕距離底部的距離(默認單位為px) +rightside-bottom:

更換lazyload服務商

1
2
3

CDN:
- lazyload: https://cdn.jsdelivr.net/npm/lozad/dist/lozad.min.js
+ lazyload: https://cdn.jsdelivr.net/npm/vanilla-lazyload/dist/lazyload.iife.min.js

card-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)
代碼框優化
1. 調整部分代碼顔色
2. 增加一款代碼主題 mac
3. 代碼框主題支持自定義
閲讀模式下去掉代碼高亮

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

1 2	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配置

1
2
3

+ # 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)

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

1 2	+# 加載動畫 Loading Animation +preloader: false

aside 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)

Breaking Change

增加自動廣告位置
1
2
3
4
+ad:
+ index:
+ aside:
+ post:
增加圖片Figcaption顯示
1
+ photofigcaption: false
增加全站總字數顯示，可配置是否關閉wordcout閲讀時間/字數統計/全站總字數
1
2
3
4
5
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)

Breaking Change

不再支持hexo 4.0.0以下版本
添加hexo fragment_cache,加快生成速度
1
+ 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
  # (如果有英文逗號' , '，請使用轉義字符 &#44;)
  # 如果關閉打字效果，subtitle只會顯示sub的第一行文字
  sub:
    - 今日事&#44;今日畢
    - 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)

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)

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)