github jerryc127/hexo-theme-butterfly 3.0.0-rc1
3.0.0 RC 1

latest releases: 4.13, 4.12, 4.11...
3 years ago

Breaking Change

  1. 從3.0開始,不再對IE瀏覽器進行適配

  2. 強制使用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
  3. _config.yml 內容修改

    1. 精簡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
    2. 修改runtimeshow 的start_date 為publish_date

      runtimeshow:
        enable: true
      -  start_date: 6/7/2018 00:00:00
      +  publish_date: 6/7/2018 00:00:00
    3. laibili 改名為 LiveRe

      -laibili:
      +livere:
        enable: false
        uid:
    4. 改hr為hr_icon 可設置取消icon

      # 水平分隔綫
      -hr:
      +hr_icon:
        enable: true
        icon: #fontawesome上圖標的Unicode
        icon-top:
    5. 更改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 #加載動畫
    6. pangu 的field配置只能配置site/post

      pangu:
        enable: true
      -  field: page # page/post
      +  field: site # site/post
    7. 整合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
    8. 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:
    9. 刪除部分配置

      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/'
    10. 刪除twitter_meta配置

      -# twitter分享自動帶上樣式
      -# -https://i.loli.net/2019/09/08/qm3RfvUCKbct1Wz.png
      -twitter_meta: true

Feature

  1. table寬度佔滿顯示

  2. 增加系統Darkmode切換監控,當系統切換Darkmode時,主題會立刻切換

  3. card_description 支持html書寫

  4. Dark Mode和Light Mode 切換按鈕icon更換

  5. 適配hexo自帶標簽 Pullquote

  6. 百度推送鏈接增加dns-prefetch

  7. canonical 設為默認生成 不再提供配置

    -# 避免重複網址分散seo
    -canonical: true
  8. instantpage js 加載增加defer

  9. fireworks 增加z-index配置

    fireworks:
      enable: false
    +  zIndex: 9999 # -1 or 9999
  10. 新的Tag Plugins - button

  11. 新的Tag Plugins - tabs

  12. 可配置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
  13. 新設計404頁面

  14. 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
  15. 增加在綫聊天 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:
  16. 可配置rightside按鈕與底部的距

    +# 右下角按鈕距離底部的距離(默認單位為px)
    +rightside-bottom:
  17. 更換lazyload服務商

    CDN:
    -	lazyload: https://cdn.jsdelivr.net/npm/lozad/dist/lozad.min.js
    +	lazyload: https://cdn.jsdelivr.net/npm/vanilla-lazyload/dist/lazyload.iife.min.js
  18. card-categories增加收縮/展開按鈕

    aside:
      card_categories:
        enable: true
        limit: 8 # if set 0 will show all
    +    expand: none # none/true/false
  19. 更改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
    
  20. 可在post裏單獨設置 auto_open: false關掉sidebar自動打開 #232

  21. 友情鏈接界面代碼優化/增加分類描述/分類名字和描述可以不寫/友情鏈接yml寫法更改(舊的寫法依舊有效,沒影響)

  22. 文章/頁面font-matter 可設置highlight_shrink (true or false)

  23. 代碼框優化

    1. 調整部分代碼顔色
    2. 增加一款代碼主題 mac
    3. 代碼框主題支持自定義
  24. 閲讀模式下去掉代碼高亮

  25. 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
  26. 打賞增加鏈接配置 /打賞寫法更改(舊寫法依然有用)#240

    # 打賞按鈕
    reward:
      enable: true
      QR_code:
    -    - itemlist:
    -        img: /img/wechat.jpg
    -        text: 微信
    -    - itemlist:
    -        img: /img/alipay.jpg
    -        text: 支付寶
    +    - img: /image/wechat.jpg
    +      link:
    +      text: 微信
    +    - img: /image/alipay.jpg
    +      link:
    +      text: 支付寶
  27. 移除JS-COOKIES

    CDN:
    -  js_cookies: https://cdn.jsdelivr.net/npm/js-cookie/dist/js.cookie.min.js
  28. 可為文章配置是否顯示TOC,即使配置中已把toc設為false

Fix

  1. 修正側邊欄目錄收縮、展開圖標不對齊的bugs
  2. 修改部分用語(zh-CN/zh-TW/en)
  3. 修復card-categories和card-archives 邊緣點擊沒有跳轉的bugs
  4. 修復網站是子目錄時,社交網站為相對地址時,地址生成錯誤的bugs
  5. 修復最後一篇文章的Pagination沒有佔據全寬度的Bug
  6. 修復推薦文章佈局在microsoft edge(舊版)顯示的Bug
  7. 修復閲讀模式下 黑色代碼框下字體顯示不清楚 #223
  8. 修復當blog_title_font不是設置google字體時,加載了preconnect //fonts.googleapis.com 的bugs
  9. 修復設置copy為false時,會導致代碼複製也無法複製的bugs
  10. 閲讀模式調整
  11. 修復部分壓縮軟件壓縮html報錯的bugs

Don't miss a new hexo-theme-butterfly release

NewReleases is sending notifications on new releases.