Butterfly 安裝文檔(一) 快速開始
📖 本教程更新於 2021 年 03 月 30 日,教程的內容針對最新穩定版而更新(如果你是舊版,教程會有些出入,請留意)
🦋 Butterfly 已經更新到 3.7.1
📚 文檔目錄
Post not found: Butterfly-安裝文檔-一-快速開始 🚀 快速開始 - Post not found: Butterfly-安裝文檔-二-主題頁面 📑 主題頁面 - Post not found: Butterfly-安裝文檔-三-主題配置-1 🛠 主題配置-1 - Post not found: Butterfly-安裝文檔-四-主題配置-2 ⚔️ 主題配置-2 - Post not found: Butterfly-安裝文檔-五-主題問答 ❓ 主題問答 - Post not found: Butterfly-安裝文檔-六-進階教程 ⚡️ 進階教程 - Post not found: Butterfly-安裝文檔-七-更新日誌 ✨ 更新日誌 - Post not found: Butterfly-打賞 🤞 打賞
如果有安裝這兩個插件的,請卸載掉,會導致主題報錯。
hexo-inject 和 hexo-neat
hexo-theme-butterfly
是基於Molunerfinn的hexo-theme-melody的基礎上進行開發的。
文檔也是在hexo-theme-melody的文檔基礎上修改。因為一些配置變更導致與原主題配置上有部分區別。故如果安裝hexo-theme-butterfly
主題,請參考這篇文檔。
安裝
穩定版【建議】
在你的博客根目錄裏
1 | git clone -b master https://github.com/jerryc127/hexo-theme-butterfly.git themes/butterfly |
測試版
測試版可能存在Bugs,追求穩定的請安裝穩定版
如果想要安裝比較新的dev分支,可以
1 | git clone -b dev https://github.com/jerryc127/hexo-theme-butterfly.git themes/butterfly |
升級方法:在主題目錄下,運行git pull
穩定版【建議】
在你的博客根目錄裏
1 | git clone -b master https://gitee.com/iamjerryw/hexo-theme-butterfly.git themes/butterfly |
測試版
測試版可能存在Bugs,追求穩定的請安裝穩定版
如果想要安裝比較新的dev分支,可以
1 | git clone -b dev https://gitee.com/iamjerryw/hexo-theme-butterfly.git themes/butterfly |
升級方法:在主題目錄下,運行git pull
此方法只支持Hexo 5.0.0以上版本
在你的博客根目錄裏
1 | npm i hexo-theme-butterfly |
升級方法:在博客根目錄下,運行 npm update hexo-theme-butterfly
應用主題
修改站點配置文件_config.yml
,把主題改為butterfly
1 | theme: butterfly |
安裝插件
如果你沒有 pug 以及 stylus 的渲染器,請下載安裝:
1 | npm install hexo-renderer-pug hexo-renderer-stylus --save |
升級建議
為了減少升級主題後帶來的不便,請使用以下方法(建議,可以不做)。
此方法只支持 Hexo 5.0.0 以上版本,建議使用。
如果已經在
source/_data/
創建了butterfly.yml
,請記得刪除掉。
把主題文件夾中的 _config.yml
複製到 Hexo 根目錄裏,同時重新命名為 _config.butterfly.yml
。
以後只需要在 _config.butterfly.yml
進行配置就行。
Hexo會自動合併主題中的_config.yml
和 _config.butterfly.yml
裏的配置,如果存在同名配置,會使用_config.butterfly.yml
的配置,其優先度較高。
從 3.3.0 開始,這種方法不再支持
為了減少升級主題後帶來的不便, Butterfly
使用了 data files 特性。
推薦把主題默認的配置文件_config.yml
複製到 Hexo 根目錄下的source/_data/
目錄下,然後將文件名改為 butterfly.yml
(如果source/_data/
的目錄不存在就創建一個)。
注意,如果你創建了不是合併而是替換butterfly.yml
, 它將會替換主題默認配置文件_config.yml
裏的配置項 (,3.1.0開始將會是合併)
採用butterfly.yml
的目的是,因為升級主題的時候,有可能會覆蓋到配置文件,以至於每次更新的時候都需要重新配置文件。如果使用butterfly.yml
,就算主題目錄下的_config.yml
被覆蓋,主題只會去butterfly.yml
讀取配置。
由於主題在添加功能或者修復Bugs的情況下,可能會涉及到配置文件的修改。這時候,如果升級主題,需要把新增加的配置添加到butterfly.yml
去,不然很大機會會出現報錯。( 3.1.0 之後,應該不會出現這種情況)