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


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

安裝

如果你身處中國大陸,且訪問 Github 不穩定,你可以用 Gitee 安裝

穩定版【建議】

在你的 Hexo 根目錄下

1
git clone -b master https://gitee.com/immyw/hexo-theme-butterfly.git themes/butterfly

測試版

測試版可能存在 Bugs,追求穩定的請安裝穩定版

如果想要安裝比較新的 dev 分支,可以

1
git clone -b dev https://gitee.com/immyw/hexo-theme-butterfly.git themes/butterfly

升級方法:在主題目錄下,運行 git pull

穩定版【建議】

在你的 Hexo 根目錄裏

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

此方法只支持 Hexo 5.0.0 以上版本

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

在你的 Hexo 根目錄裏

1
npm install hexo-theme-butterfly

升級方法:在 Hexo 根目錄下,運行 npm update hexo-theme-butterfly

應用主題

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

1
theme: butterfly

安裝插件

如果你沒有 pug 以及 stylus 的渲染器,請下載安裝:

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 的配置,其優先度較高。

butterfly-docs-install-suggestion-1.png

📑 Butterfly 文檔(二) 主題頁面