网页添加水波纹
1.在\themes\butterfly\source\js目录下创建一个ripples.js文件，并将如下代码写入该文件：
$(document).ready(function () { try { $("#page-header").ripples({ resolution: 512, dropRadius: 10, //px perturbance: 0.04, }); } catch (e) { $(".error").show().text(e); }});
加载配置文件
开启 pjax
inject: head: bottom: - <script defer src="https://rmt.dogedoge.com/fetch/~/source/jsdelivr/npm/jquery@latest/dist/jquery.min.js& ...
Docs文檔
未读📖 本教程更新於 2022 年 10 月 31
日，教程的內容針對最新穩定版而更新（如果你是舊版，教程會有些出入，請留意）
🦋 Butterfly 已經更新到 4.5.1
📚 文檔目錄
🚀
快速開始 -
📑
主題頁面 -
🛠
主題配置-1 -
⚔️
主題配置-2 -
❓
主題問答 -
⚡️
進階教程 -
✨
更新日誌 - 🤞
打賞
你可以通過右下角的 簡 按鈕切換為簡體顯示
4.5.1 (2022/10/31)Fix
修復 mathjax 行內公式 導致行距過密的 bug
修復更新 mathjax 新版本後，mathjax 會溢出屏幕而不是顯示滾動條的
bug
Improvement:
避免沒更新主題文件而導致 anchor 配置報錯的問題
更新 plugins.yml
4.5.0 (2022/10/21)4.5.0 (2022/10/21)
Breaking Change
Open_Graph_meta 設置更改，可配置其它參數
-Open_Graph_m ...
Docs文檔
未读📖 本教程更新於 2022 年 10 月 31
日，教程的內容針對最新穩定版而更新（如果你是舊版，教程會有些出入，請留意）
🦋 Butterfly 已經更新到 4.5.1
📚 文檔目錄
🚀
快速開始 -
📑
主題頁面 -
🛠
主題配置-1 -
⚔️
主題配置-2 -
❓
主題問答 -
⚡️
進階教程 -
✨
更新日誌 - 🤞
打賞
你可以通過右下角的 簡 按鈕切換為簡體顯示
建議
不要把個人需要的文件/圖片放在主題source文件夾裏，因為在升級主題的過程中，可能會把文件覆蓋刪除了。
在Hexo根目錄的source文件夾裏，創建一個文件夾來放置個人文件/圖片。
引用文件直接為/文件夾名稱/文件名
音樂
音樂界面使用了插件 hexo-tag-aplayer 使用方法請參考插件文檔
音樂頁面只是普通的page頁，按普通頁面操作生成就行。
以下內容可供選擇配置
注意： 仍需要安裝插件hexo-tag-aplayer
插件會在每一個文件都插入 js 和 css，為了避免這一情況， ...
Docs文檔
未读📖 本教程更新於 2022 年 10 月 31
日，教程的內容針對最新穩定版而更新（如果你是舊版，教程會有些出入，請留意）
🦋 Butterfly 已經更新到 4.5.1
📚 文檔目錄
🚀
快速開始 -
📑
主題頁面 -
🛠
主題配置-1 -
⚔️
主題配置-2 -
❓
主題問答 -
⚡️
進階教程 -
✨
更新日誌 - 🤞
打賞
你可以通過右下角的 簡 按鈕切換為簡體顯示
以下是一些網友在安裝的過程中出現的問題。在提問題之前，先看有沒有解決方法。
運行後網頁顯示代碼
頁面只顯示
extends includes/layout.pug block content #recent-posts.recent-posts include includes/recent-posts.pug include includes/pagination.pug #aside_content.aside_content include includes/aside.pug
請下載安裝：npm install h ...
📖 本教程更新於 2022 年 10 月 31
日，教程的內容針對最新穩定版而更新（如果你是舊版，教程會有些出入，請留意）
🦋 Butterfly 已經更新到 4.5.1
📚 文檔目錄
🚀
快速開始 -
📑
主題頁面 -
🛠
主題配置-1 -
⚔️
主題配置-2 -
❓
主題問答 -
⚡️
進階教程 -
✨
更新日誌 - 🤞
打賞
你可以通過右下角的 簡 按鈕切換為簡體顯示
評論
通用設置DisqusDisqusjslivere（來必力）GitalkValineWalineUtterancesFacebook CommentsTwikooGiscusremark42artalk從3.0.0開始，開啟評論需要在comments-use中填寫你需要的評論。
支持雙評論顯示，只需要配置兩個評論（第一個為默認顯示）
comments: # Up to two comments system, the first will be shown as default # Choose: Disqus/Disq ...
📖 本教程更新於 2022 年 10 月 31
日，教程的內容針對最新穩定版而更新（如果你是舊版，教程會有些出入，請留意）
🦋 Butterfly 已經更新到 4.5.1
📚 文檔目錄
🚀
快速開始 -
📑
主題頁面 -
🛠
主題配置-1 -
⚔️
主題配置-2 -
❓
主題問答 -
⚡️
進階教程 -
✨
更新日誌 - 🤞
打賞
你可以通過右下角的 簡 按鈕切換為簡體顯示
語言
修改站點配置文件 _config.yml
默認語言是 en
主題支持三種語言
default(en)
zh-CN (簡體中文)
zh-TW (繁體中文)
網站資料
修改網站各種資料，例如標題、副標題和郵箱等個人資料，請修改博客根目錄的_config.yml
導航菜單
修改 主題配置文件
Home: / || fas fa-homeArchives: /archives/ || fas fa-archiveTags: /tags/ || fas fa-tagsCategories: /catego ...
Docs文檔
未读📖 本教程更新於 2022 年 10 月 31
日，教程的內容針對最新穩定版而更新（如果你是舊版，教程會有些出入，請留意）
🦋 Butterfly 已經更新到 4.5.1
📚 文檔目錄
🚀
快速開始 -
📑
主題頁面 -
🛠
主題配置-1 -
⚔️
主題配置-2 -
❓
主題問答 -
⚡️
進階教程 -
✨
更新日誌 - 🤞
打賞
你可以通過右下角的 簡 按鈕切換為簡體顯示
Front-matter
Front-matter 是 markdown 文件最上方以 ---
分隔的區域，用於指定個別檔案的變數。
Page Front-matter 用於頁面配置
Post Front-matter 用於文章頁配置
如果標注可選的參數，可根據自己需要添加，不用全部都寫在markdown裏
Page Front-matter
---title:date:updated:type:comments:description:keywords:top_img:mathjax:katex:asi ...
適用於 >= 3.8.0
側邊欄現在支持自定義了，可以添加自己喜歡的 widget。
可添加自己的 widget，也可以對現有的 widget
進行排序（博客資料和
公告這兩個固定，其它的能排序）
widget 排序
只需要配置 sort_order就行。（使用了 Flex
佈局的 order 屬性，具體可查看 mozilla
文檔。簡單來講，就是配置數字來實現排序，如果不配置，則默認為
0。數字越小，排序越靠前。
aside: ... 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 kno ...
