📖 本教程更新於 2022 年 06 月 24 日，教程的內容針對最新穩定版而更新（如果你是舊版，教程會有些出入，請留意）

🦋 Butterfly 已經更新到 4.3.0

📚 文檔目錄

🚀 快速開始 - 📑 主題頁面 - 🛠 主題配置-1 - ⚔️ 主題配置-2 - ❓ 主題問答 - ⚡️ 進階教程 - ✨ 更新日誌 - 🤞 打賞

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

hexo-theme-butterfly是基於 hexo-theme-melody 的基礎上進行開發的。

安裝
Git安裝 (Github)
Git安裝 (Gitee)
npm安裝
此方法只支持 Hexo 5.0.0 以上版本

通過 npm 安裝並不會在 themes 裏生成主題文件夾，而是在 node_modules 裏生成

在你的 Hexo 根目錄裏

POWERSHELL
1
npm i hexo-theme-butterfly
升級方法：在 Hexo 根目錄下，運行 npm update hexo-theme-butterfly

應用主題
修改 Hexo 根目錄下的 _config.yml，把主題改為butterfly

YAML
1
theme: butterfly
安裝插件
如果你沒有 pug 以及 stylus 的渲染器，請下載安裝：

POWERSHELL
1
npm install hexo-renderer-pug hexo-renderer-stylus –save
升級建議
升級完成後，請到 Github 的 Releases 界面 或者 文檔七 查看新版的更新內容。

裏面有標注 _config 文件的變更內容（如有），請根據實際情況更新你的配置內容。

為了減少升級主題後帶來的不便，請使用以下方法（建議，可以不做）。

在 hexo 的根目錄創建一個文件 _config.butterfly.yml，並把主題目錄的 _config.yml 內容複製到 _config.butterfly.yml 去。( 注意: 複製的是主題的 _config.yml ,而不是 hexo 的 _config.yml)

注意： 不要把主題目錄的 _config.yml 刪掉

注意： 以後只需要在 _config.butterfly.yml進行配置就行。
如果使用了 _config.butterfly.yml， 配置主題的 _config.yml 將不會有效果。

Hexo會自動合併主題中的_config.yml和 _config.butterfly.yml裏的配置，如果存在同名配置，會使用_config.butterfly.yml的配置，其優先度較高。

作者: Jerry
連結: https://butterfly.js.org/posts/21cfbf15/#%E5%8D%87%E7%B4%9A%E5%BB%BA%E8%AD%B0
來源: Butterfly
著作權歸作者所有。商業轉載請聯絡作者獲得授權，非商業轉載請註明出處。