4.9.0 之後的更新日誌將會單獨文章發佈,請查看 更新日誌
你可以通過右下角的 簡 按鈕切換為簡體顯示
4.9.0 (2023/06/06)
4.9.0 (2023/06/06)
Feature
適配 mermaid v10
大於 2000px 時,顯示區域增大
可配置 header 和 footer 是否添加黑色半透遮罩
1
2
3
4+# Add mask to header or footer (為 header 或 footer 添加黑色半透遮罩)
+mask:
+ header: true
+ footer: trueartalk 最新評論改為 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)
4.8.0 (2023/04/10)
4.8.0 (2023/04/10)
Breaking Change
移除 gitter
1
2
3
4
5-# gitter
-# https://gitter.im/
-gitter:
- enable: false
- room:CDN option 部分參數名字修改
1
2
3
4
5
6
7
8
9
10
11
12
13CDN:
option:
- # algolia_search_v4:
- # instantsearch_v4:
- # fancybox_css_v4:
- # fancybox_v4:
- # fontawesomeV6:
+ # algolia_search:
+ # instantsearch:
+ # fancybox_css:
+ # fancybox:
+ # fontawesome:
Feature
social 可配置 顏色
支持 abcjs 樂譜渲染
1
2
3
4
5
6+# abcjs (樂譜渲染)
+# See https://github.com/paulrosen/abcjs
+# ---------------
+abcjs:
+ enable: false
+ per_page: true適配 typed.js 新版本
Algolia 搜索,點擊文章內容也會跳轉到相應頁面
重構本地搜索
1
2
3
4
5
6
7
8
9
10# 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
3CDN:
option:
+ giscus: xxxxx新增自定義深淺模式切換時間
1
2
3
4
5# 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)
4.7.0 (2023/02/20)
Feature
card_tags 可配置 orderby 和 order
1
2
3
4
5
6
7
8aside:
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
1
2
3
4
5
6
7
8+# 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 的參數
1
2
3
4
5
6
7
8
9
10subtitle:
- # 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)
4.6.0 (2023/01/15)
Breaking Change
cover 的顯示優化 #1101
當 cover 設置為 false,或者沒有獲取到 cover 的值時,文章頁相關推薦和分頁按鈕背景顯示為主題色
Feature
toc可設置是否顯示預覽進度
1
2toc:
+ scroll_percent: true右下角按鈕增加預覽進度顯示
1
2+# show scroll percent in scroll-to-top button
+rightside_scroll_percent: truecover 可設置顏色/漸變色 等配置
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)
4.5.0 (2022/10/21)
4.5.0 (2022/10/21)
Breaking Change
Open_Graph_meta 設置更改,可配置其它參數
1
2
3
4-Open_Graph_meta: true
+Open_Graph_meta:
+ enable: true
+ option:preloader 設置更改,增加 pace.js 加載動畫條
1
2
3
4
5
6
7
8
9-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 總是顯示
1
2
3
4
5
6
7-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)
4.4.0 (2022/08/18)
Feature
在綫聊天新增 facebook 洽談外掛程式 messenger
1
2
3
4+messenger:
+ enable: false
+ pageID:
+ lang: zh_TW # Language en_US/zh_CN/zh_TW and so on添加 artalk 評論功能
1
2
3
4
5+artalk:
+ server:
+ site:
+ visitor: false
+ option:首頁打字效果增加參數配置
1
2
3
4
5
6
7subtitle:
...
+ # 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)
4.3.0 (2022/06/24)
4.3.0 (2022/06/24)
Breaking Change
archives 隱藏aside 設置更改
1
2
3
4aside:
- archive: true
+ display:
+ archive: true適配 disqusjs 3.0
Feature
子歸檔頁面顯示的文章數量不再顯示總文章數量,而是對應的子歸檔文章數量
為一些數據加載增加 loading 顯示
tag 和 category 頁面可設置隱藏 aside
1
2
3
4aside:
+ display:
+ tag: true
+ category: true點擊歸檔日期跳轉到頁面,標題顯示日期而不是‘歸檔’二字
適配 katex 升級, 移除 katex copy-tex.css
CDN 可一鍵配置 cdnjs
CDN 可一鍵配置為 unpkg
cdn可設置 version 和 custom format(自定義格式)
1
2
3CDN:
+ version: false
+ custom_format:添加Remark42評論系統支持
1
2
3
4
5
6+# 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)
4.2.0 (2022/05/02)
4.2.0 (2022/05/02)
Breaking Change
waline 適配 V2
1
2
3
4CDN:
- waline:
+ waline_js:
+ waline_css:waline 的 visitor 改為 pageview
1
2
3waline:
- visitor: false
+ pageview: falsecdn 可一鍵設置 本地文件/可單獨配置主題文件,第三方文件的 cdn
1
2
3
4
5
6
7
8
9
10CDN:
+ # 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
1
2
3
4local_search:
enable: false
+ preload: false
+ CDN:更新 social-share cdn 版本
歸檔頁面的側邊欄支持隱藏
1
2aside:
+ archives: true可配置文章版權模塊的作者超鏈接
1
2post_copyright:
+ author_href:
Fix
- mathjax 顯示不完全的 bug
- 標題中帶有 HTML 關鍵字時,會破壞相關推薦的渲染 #836
Improvement
- 搜索標題統一顯示為 ‘搜索’
- algolia 搜索的 logo 改為 instantsearch 調用
- algolia 第一次進入時不會自動搜索 #867
- 搜索內容增加 ... 縮略辨識
- 調整分享按鈕導致的間距問題
- html/css 優化
4.1.0 (2022/02/13)
4.1.0 (2022/02/13)
Breaking Change
升級 fontawesome 到 v6 #689
1
2
3CDN:
- 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
精簡各評論的配置
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29disqusjs:
- 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
1
2
3
4toc:
- 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
2CDN:
- 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
1
2
3
4
5CDN:
- 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
1
2
3
4+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
1
2
3
4
5CDN:
- 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 也會切換夜間主題
1
2
3
4
5
6
7mermaid:
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
1
2
3
4
5CDN:
- 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
2toc:
+ expand: false增加 新的評論系統 giscus
1
2
3
4
5
6
7
8
9
10
11
12
13+# 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
2theme_color:
+ scrollbar_color: "#49b1f5"美化 firefox 瀏覽器滾動條
CDN 增加 blueimp_md5 配置
1
2CDN:
+ 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 配置中獲取
移除最新評論的評論服務商選擇,默認為配置的第一個評論服務商
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17newest_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 配置(最新評論也會更新)
1
2
3waline:
...
+ 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 優化,需自行配置
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21-# 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 範圍,佔位圖應用到全站)
1
2
3
4
5
6lazyload:
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)
1
2
3
4
5
6
7
8
9-# Artitalk
-# see https://artitalk.js.org/
-artitalk:
- appId:
- appKey:
- option:
CDN:
- artitalk: https://cdn.jsdelivr.net/npm/artitalkkatex_copytex 的js 和 css cdn 更換
1
2
3
4
5-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
1
2
3
4
5
6valine:
+ visitor: false
waline:
+ visitor: false
twikoo:
+ visitor: false增加 HexoPlusPlus_Talk(需要安裝 hexo-butterfly-hpptalk)
增加 tags 標簽外掛 inlineImg
gitalk 增加 option 配置
1
2
3gitalk:
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
增加首頁評論數顯示
1
2
3
4comments:
...
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 ‘查看更多’按鈕 改為 圖標顯示在右上角
可配置最新評論的緩存時間
1
2
3
4
5newest_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 配置(可關閉/配置分頁展示邏輯)
1
2
3
4
5
6+# 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增加 文章編輯
1
2
3
4
5
6
7+# 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
移除百度推送(百度已棄用)和百度轉碼
1
2
3
4
5-# 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)
3.5.0 (2020/12/30)
3.5.0 (2020/12/30)
Feature
aside 個人資料widget可關閉button
1
2
3
4
5
6
7
8
9
10
11aside:
...
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內的有效)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16aside:
...
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 配置
1
2
3
4
5
6# Twikoo
# https://github.com/imaegoo/twikoo
-twikoo:
+twikoo:
+ envId:
+ option:增加waline評論
1
2
3
4
5
6
7
8+# 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最新評論模塊
1
2
3
4newest_comments:
enable: true
...
+ waline: false
Improvement
最新評論url 增加描點
html結構優化
修改newest_comments的leancloud為valine,並刪除其配置,改為讀取valine配置
1
2
3
4
5
6
7
8
9
10# 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前綴
1
2+# Add the vendor prefixes to ensure compatibility
+css_prefix: true點擊文字特效增加隨機配置
1
2
3
4
5
6
7
8
9ClickShowText:
enable: false
text:
- I
- LOVEeeeeeeeeeeeee
- YOU
fontSize: 15px
+ random: true
mobile: false右下角增加字體調整按鈕
1
2+# Change font size
+change_font_size: true增加twikoo 最新評論
1
2
3
4newest_comments:
enable: true
....
+ twikoo: true增加twikoo評論數顯示
增加toc簡潔模式
1
2
3
4toc:
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 設置
1
2valine:
+ option:toc改為aside顯示,去掉sidebar
手機toc ui 修改
去掉 toc auto_open 配置
1
2
3
4toc:
enable: true
number: true
- auto_open: true # auto open the sidebar優化手機toc 的特效和按鈕出現的時機
aside狀態存localStorage
文章標題改為居中
aside 可配置隱藏/增加按鈕可展開或收縮aside
1
2
3
4
5aside:
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)
3.2.0 (2020/09/28)
Breaking Change
更改canvas_ribbon_piao 為 canvas_fluttering_ribbon
1
2
3
4-canvas_ribbon_piao:
+canvas_fluttering_ribbon:
enable: false
mobile: false刪除特效js,改為cdn引入
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21CDN:
# 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
1
2
3
4
5
6
7
8# 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主頁文章時間和文章頁文章時間可以配置顯示日期還是相對時間
1
2
3
4
5
6post_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)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17activate_power_mode:
...
+ mobile: false
fireworks:
...
+ mobile: true
-click_heart: false
+click_heart:
+ enable: false
+ mobile: false
ClickShowText:
enable: false
...
+ mobile: false添加 artitalk 説説插件
1
2
3
4
5
6
7
8
9+# 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
2CDN:
- 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 子菜單
1
2+# Hide the child menu items in mobile sidebar
+hide_sidebar_menu_child: false當寬度小於1024時,點擊toc滾動,增加滾動效果
可配置font-size/更改配置中 code-font 為 code-font-family
1
2
3
4
5
6font:
+ global-font-size:
+ code-font-size:
font-family:
- code-font:
+ code-font-family:部分css由'px'改為'em',適應font-size值改變而改變
pjax增加exclude配置
1
2
3
4-pjax: false
+pjax:
+ enable: false
+ exclude:新增 cnzz_analytics
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18# 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的寫法
1
2
3
4
5
6
7
8
9
10
11addtoany:
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 配置
1
2
3
4
5
6aside:
- card_webinfo: true
+ card_webinfo:
+ enable: true
+ post_count: true
+ last_push_date: true增加 aside 最新評論部件
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17+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
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37+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
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20-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移除‘添加書籤’功能,可執行配置按鈕
1
2
3
4
5
6
7
8aside:
card_author:
enable: true
description:
+ button:
+ icon: fab fa-github
+ text: Follow Me
+ link: https://github.com/xxxxxxcopy的copyright增加字數限制配置,可配置多少字以上才添加版權信息
1
2
3
4
5
6copy:
enable: true
- copyright: false
+ copyright:
+ enable: false
+ limit_count: 50aside recent post可設置按發表時間或者更新時間排序
1
2
3
4
5aside:
card_recent_post:
enable: true
limit: 5 # if set 0 will show all
+ sort: date # date or updated更換typed.js/meting CDN
1
2
3
4
5-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
增加文章過期提醒
1
2
3
4
5
6
7
8+# 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
1
2
3
4+# Pjax [Beta]
+# It may contain bugs and unstable, give feedback when you find the bugs.
+# https://github.com/MoOx/pjax
+pjax: false添加第三方chat服務 crisp
1
2
3
4
5+# crisp
+# https://crisp.chat/en/
+crisp:
+ enable: false
+ website_id:谷歌廣告增加自動廣告配置,減少不必要的js加載
1
2
3
4
5
6google_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可以配置是否顯示文字
1
2
3
4
5
6
7
8
9
10
11post_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)
3.0.0-RC1 (2020/06/16)
Breaking Change
從3.0開始,不再對IE瀏覽器進行適配
強制使用fontawesome v5(會對一些自定義icon產生影響,請替換為V5圖標)
1
2
3
4
5
6
7
8
9
10-# 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配置
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28-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
1
2
3
4runtimeshow:
enable: true
- start_date: 6/7/2018 00:00:00
+ publish_date: 6/7/2018 00:00:00laibili 改名為 LiveRe
1
2
3
4-laibili:
+livere:
enable: false
uid:改hr為hr_icon 可設置取消icon
1
2
3
4
5
6# 水平分隔綫
-hr:
+hr_icon:
enable: true
icon: #fontawesome上圖標的Unicode
icon-top:更改loading_bg為error_img,post-loading移到lazyload去
1
2
3
4
5
6
7
8
9-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
1
2
3
4pangu:
enable: true
- field: page # page/post
+ field: site # site/post整合auto_open_sidebar到toc去
1
2
3
4
5
6
7
8toc:
enable: true
number: true
+ auto_open: true # auto open the sidebar
-# auto open the sidebar in 'post'
-auto_open_sidebar:
- enable: truefont去除enable配置
1
2
3
4
5
6
7
8# 全局字體
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:刪除部分配置
1
2
3
4
5
6
7valine:
- 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: trueinstantpage js 加載增加defer
fireworks 增加z-index配置
1
2
3fireworks:
enable: false
+ zIndex: 9999 # -1 or 9999新的Tag Plugins - button
新的Tag Plugins - tabs
可配置justifiedGallery CDN
1
2
3
4CDN:
+ # 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在每個頁面都插入代碼
1
2
3
4
5CDN:
+ # 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按鈕替換原在綫聊天按鈕
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30+# 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
3CDN:
- 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增加收縮/展開按鈕
1
2
3
4
5aside:
card_categories:
enable: true
limit: 8 # if set 0 will show all
+ expand: none # none/true/false更改auto_excerpt為index_post_content,並擁有三種方法可選
1
2
3
4
5
6
7
8
9
10
11
12-# 自動節選
-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配置
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17disqusjs:
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
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16# 打賞按鈕
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
2CDN:
- 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
1
2
3
4
5beautify:
enable: true
+ field: post # site/post
title-prefix-icon: '\f0c1'
title-prefix-icon-color: '#F47466'更換lazyload js
1
2
3
4
5
6
7
8
9
10-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)
2.3.0(2020/04/26)
Breaking Change
增加Facebook Comments
1
2
3
4
5
6
7
8
9
10+# 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: falseaside card-tags可配置是否顯示顏色/aside subtitle可配置,優先顯示配置內容、沒有的顯示頁面subtitle #191 /aside widget 增加部分參數可配置/aside widget的Categories,Tags,post,Archives可配置limit/整合公告欄配置到aside去
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38aside:
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
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28-# 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以上版本
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18valine:
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
增加自動廣告位置
1
2
3
4+ad:
+ index:
+ aside:
+ post:增加圖片Figcaption顯示
1
+ photofigcaption: false
增加全站總字數顯示,可配置是否關閉wordcout閲讀時間/字數統計/全站總字數
1
2
3
4
5wordcount:
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,加快生成速度
1
+ fragment_cache: true
完善V5圖標顯示,不再需要同時加載V4和v5圖標
1
2
3
4
5
6
7
8
9
10
11
12
13+ 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,解決部分瀏覽器無法顯示圖片問題
1
2
3
4
5
6
7
8- # 如果你有使用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:友情鏈接除列表外可自定義內容
可設置主頁標題距離頂部距離
1
2
3
4
5# 主頁設置
# 默認top_img全屏,site_info在中間
# 使用默認, 都無需填寫(建議默認)
+index_site_info_top: # 主頁標題距離頂部距離 例如 300px/300em/300rem/10%
index_top_img_height: # 主頁top_img高度 例如 300px/300em/300rem 不能使用百分比側邊欄可隱藏,可設置手機頁面是否隱藏
1
2
3
4
5
6
7-aside_mobile: true
aside:
+ enable: true
+ mobile: true # 手機頁面( 顯示寬度 < 768px )是否顯示aside內容
position: right # left or right
card_author: true增加disqusjs和utterances 兩個評論
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16+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
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19subtitle:
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的配置
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29gitalk:
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配置整理
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19- # 夜間模式
- 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頁面
1
2
3
4
5+# A simple 404 page
+error_404:
+ enable: true
+ subtitle: "頁面沒有找到"
+ background:post_beautify改為beautify,頁面美化不再只限於post頁,page頁也一樣
1
2
3
4
5-post_beautify:
+beautify:
enable: true
title-prefix-icon: '\f0c1'
title-prefix-icon-color: "#F47466"可設置是否顯示cover,可設置各位置的cover顯示
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15-# 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,可畫流程圖、狀態圖、時序圖、甘特圖等等
1
2
3
4
5+# https://github.com/knsv/mermaid
+mermaid:
+ enable: true
+ # built-in themes: default/forest/dark/neutral
+ theme: default增加pangu配置,中英文之間添加空格
1
2
3
4
5+# https://github.com/vinta/pangu.js
+# 中英文之間添加空格
+pangu:
+ enable: true
+ field: page # page/post整合部分配置
1
2
3
4
5-avatar_effect: false
+avatar:
+ img: /img/avatar.png
+ effect: true # 頭像會一直轉圈post-copyright增加decode網址 (可以顯示中文)
1
2
3
4
5post_copyright:
enable: true
+ decode: false
license: CC BY-NC-SA 4.0
license_url: https://creativecommons.org/licenses/by-nc-sa/4.0/增加部分顏色配置
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16theme_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
1
2
3
4
5
6
7
8
9
10
11
12post_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