你可以通過右下角的 簡 按鈕切換為簡體顯示
Front-matter
Front-matter 是 markdown 文件最上方以 --- 分隔的區域，用於指定個別檔案的變數。
- Page Front-matter 用於
頁面配置 - Post Front-matter 用於
文章頁配置
如果標注可選的參數，可根據自己需要添加，不用全部都寫在 markdown 裏
Page Front-matter
1 | --- |
| 參數 | 解釋 |
|---|---|
| title | 【必需】頁面標題 |
| date | 【必需】頁面創建日期 |
| type | 【必需】標籤、分類和友情鏈接三個頁面需要配置 |
| updated | 【可選】頁面更新日期 |
| description | 【可選】頁面描述 |
| keywords | 【可選】頁面關鍵字 |
| comments | 【可選】顯示頁面評論模塊 (默認 true) |
| top_img | 【可選】頁面頂部圖片 |
| mathjax | 【可選】顯示 mathjax (當設置 mathjax 的 per_page: false 時，才需要配置，默認 false) |
| katex | 【可選】顯示 katex (當設置 katex 的 per_page: false 時，才需要配置，默認 false) |
| aside | 【可選】顯示側邊欄 (默認 true) |
| aplayer | 【可選】在需要的頁面加載 aplayer 的 js 和 css,請參考文章下面的音樂 配置 |
| highlight_shrink | 【可選】配置代碼框是否展開 (true/false) (默認為設置中 highlight_shrink 的配置) |
| random | 【可選】配置友情鏈接是否隨機排序（默認為 false） |
| limit | 【可選】配置説説顯示數量 |
| limit.type | 【可選】配置説説顯示數量的類型 （date 或者 num） |
| limit.value | 【可選】配置説説顯示數量的值 |
Post Front-matter
1 | --- |
| 寫法 | 解釋 |
|---|---|
| title | 【必需】文章標題 |
| date | 【必需】文章創建日期 |
| updated | 【可選】文章更新日期 |
| tags | 【可選】文章標籤 |
| categories | 【可選】文章分類 |
| keywords | 【可選】文章關鍵字 |
| description | 【可選】文章描述 |
| top_img | 【可選】文章頂部圖片 |
| cover | 【可選】文章縮略圖(如果沒有設置 top_img,文章頁頂部將顯示縮略圖，可設為 false/圖片地址/留空) |
| comments | 【可選】顯示文章評論模塊(默認 true) |
| toc | 【可選】顯示文章 TOC(默認為設置中 toc 的 enable 配置) |
| toc_number | 【可選】顯示 toc_number(默認為設置中 toc 的 number 配置) |
| toc_style_simple | 【可選】顯示 toc 簡潔模式 |
| copyright | 【可選】顯示文章版權模塊(默認為設置中 post_copyright 的 enable 配置) |
| copyright_author | 【可選】文章版權模塊的文章作者 |
| copyright_author_href | 【可選】文章版權模塊的文章作者鏈接 |
| copyright_url | 【可選】文章版權模塊的文章連結鏈接 |
| copyright_info | 【可選】文章版權模塊的版權聲明文字 |
| mathjax | 【可選】顯示 mathjax(當設置 mathjax 的 per_page: false 時，才需要配置，默認 false ) |
| katex | 【可選】顯示 katex (當設置 katex 的 per_page: false 時，才需要配置，默認 false ) |
| aplayer | 【可選】在需要的頁面加載 aplayer 的 js 和 css,請參考文章下面的音樂 配置 |
| highlight_shrink | 【可選】配置代碼框是否展開(true/false)(默認為設置中 highlight_shrink 的配置) |
| aside | 【可選】顯示側邊欄 (默認 true) |
| abcjs | 【可選】加載 abcjs (當設置 abcjs 的 per_page: false 時，才需要配置，默認 false ) |
| noticeOutdate | 【可選】文章過期提醒 (默認為設置中 noticeOutdate 的 enable 配置) |
標籤頁
標籤頁文件名不一定是 tags, 例子中的 tags 只是一個示例
記得添加 type: "tags"
前往你的 Hexo 的根目錄
輸入
hexo new page tags你會找到
source/tags/index.md這個文件修改這個文件：
1 | --- |
| 參數 | 解釋 |
|---|---|
| type | 【必須】頁面類型，必須為 tags |
| orderby | 【可選】排序方式 ： random - 隨機排序 / name - 標簽名字排序 / length - 標簽數量排序 |
| order | 【可選】排序次序： 1（升序），-1（降序） |
分類頁
分類頁文件名不一定是 categories, 例子中的 categories 只是一個示例
記得添加 type: "categories"
前往你的 Hexo 的根目錄
輸入
hexo new page categories你會找到
source/categories/index.md這個文件修改這個文件：
1 | --- |
友情鏈接
為你的博客創建一個友情鏈接！
創建友情鏈接頁面
友情鏈接頁文件名不一定是 link, 例子中的 link 只是一個示例
記得添加 type: "link"
前往你的 Hexo 的根目錄
輸入
hexo new page link你會找到
source/link/index.md這個文件修改這個文件：
1 | --- |
數據來源
在 Hexo 根目錄中的 source/_data（如果沒有 _data 文件夾，請自行創建），創建一個文件 link.yml
1 | - class_name: 友情鏈接 |
class_name 和 class_desc 支持 html 格式書寫，如不需要，也可以留空。
從 4.0.0 開始，支持從遠程加載友情鏈接，遠程拉取只支持 json。
注意： 選擇遠程加載後，本地生成的方法會無效。
在 source/link/index.md 這個文件的 front-matter 添加遠程鏈接
1 | flink_url: xxxxx |
Json 的格式
1 | [ |
友情鏈接隨機排序
主題支持友情鏈接隨機排序，只需要在頂部 front-matter 添加 random: true
友情鏈接界面設置
由 2.2.0 起，友情鏈接界面可以由用户自己自定義，只需要在友情鏈接的 Markdown 檔設置就行，以普通的 Markdown 格式書寫。
圖庫
圖庫頁面只是普通的頁面，你只需要 hexo n page xxxxx 創建你的頁面就行
然後使用標簽外掛 galleryGroup，具體用法請查看對應的內容。
1 | <div class="gallery-group-main"> |
子頁面
子頁面也是普通的頁面，你只需要 hexo n page xxxxx 創建你的頁面就行
然後使用標簽外掛 gallery，具體用法請查看對應的內容。
1 | {% gallery %} |
[{"url":"https://i.loli.net/2019/12/25/Fze9jchtnyJXMHN.jpg","alt":""},{"url":"https://i.loli.net/2019/12/25/ryLVePaqkYm4TEK.jpg","alt":""},{"url":"https://i.loli.net/2019/12/25/gEy5Zc1Ai6VuO4N.jpg","alt":""},{"url":"https://i.loli.net/2019/12/25/d6QHbytlSYO4FBG.jpg","alt":""},{"url":"https://i.loli.net/2019/12/25/6nepIJ1xTgufatZ.jpg","alt":""},{"url":"https://i.loli.net/2019/12/25/E7Jvr4eIPwUNmzq.jpg","alt":""},{"url":"https://i.loli.net/2019/12/25/mh19anwBSWIkGlH.jpg","alt":""},{"url":"https://i.loli.net/2019/12/25/2tu9JC8ewpBFagv.jpg","alt":""}]
如果你想要使用 /photo/ohmygirl 這樣的鏈接顯示你的圖片內容
你可以把創建好的 ohmygirl 整個文件夾移到 photo 文件夾裏去
404 頁面
主題內置了一個簡單的 404 頁面，可在設置中開啟
本地預覽時，訪問出錯的網站是不會跳到 404 頁面的。
如需本地預覽，請訪問 http://localhost:4000/404.html
1 | # A simple 404 page |
説説頁面
添加于 V5.0
請留意，説説界面只支持原生的 markdown 格式，不支持標簽外挂和數學公式
創建説説頁面
説説頁文件名不一定是 shuoshuo, 例子中的 shuoshuo 只是一個示例
記得添加 type: "shuoshuo"
前往你的 Hexo 的根目錄
輸入
hexo new page shuoshuo你會找到
source/shuoshuo/index.md這個文件修改這個文件：
1 | --- |
你可以隱藏一些説説，可配置的參數：
1 | limit: |
| 參數 | 解釋 |
|---|---|
| limit | 【可選】配置説説顯示數量 |
| limit.type | 【可選】配置説説顯示數量的類型 （date 或者 num） |
| limit.value | 【可選】配置説説顯示數量的值 （當 type 配置為 date 時， value 的值必須為日期。當 type 配置為 num 時， value 的值必須為數字，且大於 0 |
數據來源
在 Hexo 根目錄中的 source/_data（如果沒有 _data 文件夾，請自行創建），創建一個文件 shuoshuo.yml
author 和 avatar可省略，會自動去獲取配置文件中的 author 和 avatar
如果需要開啓評論，必須配置 key，否則不會顯示評論按鈕
1 | - author: Butterfly |
| 參數 | 解釋 |
|---|---|
| author | 【可選】作者名稱 |
| avatar | 【可選】作者頭像 |
| date | 【必需】日期 |
| content | 【必需】內容（ Markdown 格式或者 Html 格式 |
| key | 【可選】評論的唯一標識, 開啓評論必須配置 |
| tags | 【可選】標籤 |
注意： 選擇遠程加載後，本地生成的方法會無效。
遠程拉取只支持 json
在説説頁面 Markdown 裏的 front-matter 添加遠程鏈接
1 | shuoshuo_url: xxxxx |
Json 的格式：
author 和 avatar可省略，會自動去獲取配置文件中的 author 和 avatar
1 | [ |
| 參數 | 解釋 |
|---|---|
| author | 【可選】作者名稱 |
| avatar | 【可選】作者頭像 |
| date | 【必需】日期 |
| content | 【必需】內容（ Markdown 格式或者 Html 格式 |
| key | 【可選】評論的唯一標識, 開啓評論必須配置 |
| tags | 【可選】標籤 |
除特別聲明外，本博客所有文章均採用CC BY-NC-SA 4.0 授權協議。轉載請註明出處：Butterfly。
- 微信
- 支付寶
- Stripe
相關文章
2020-05-28
Butterfly 文檔(一) 快速開始
📚 文檔目錄 🚀 快速開始 - 📑 主題頁面 - 📌 主題配置 - ⚔️ 標簽外挂 - ❓ 主題問答 - ⚡️ 進階教程 你可以通過右下角的 簡 按鈕切換為簡體顯示 hexo-theme-butterfly 是基於 hexo-theme-melody 的基礎上進行開發的主题。 安裝Git 安裝npm 安裝如果你身處中國大陸，且訪問 Github 不穩定，你可以用 Gitee 安裝穩定版【建議】 在你的 Hexo 根目錄下 1git clone -b master https://gitee.com/immyw/hexo-theme-butterfly.git themes/butterfly 測試版 測試版可能存在 Bugs，追求穩定的請安裝穩定版 如果想要安裝比較新的 dev 分支，可以 1git clone -b dev https://gitee.com/immyw/hexo-theme-butterfly.git themes/butterfly 升級方法：在主題目錄下，運行 git pull 穩定版【建議】 在你的 Hexo...
2020-05-28
Butterfly 文檔(五) 主題問答
📚 文檔目錄 🚀 快速開始 - 📑 主題頁面 - 📌 主題配置 - ⚔️ 標簽外掛 - ❓ 主題問答 - ⚡️ 進階教程 你可以通過右下角的 簡 按鈕切換為簡體顯示 以下是一些網友在安裝的過程中出現的問題。在提問題之前，先看有沒有解決方法。 運行後網頁顯示代碼頁面只顯示 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 hexo-renderer-pug hexo-renderer-stylus --save or yarn add hexo-renderer-pug...
2020-05-28
Butterfly 文檔(六) 進階教程
📚 文檔目錄 🚀 快速開始 - 📑 主題頁面 - 📌 主題配置 - ⚔️ 標簽外掛 - ❓ 主題問答 - ⚡️ 進階教程 你可以通過右下角的 簡 按鈕切換為簡體顯示 建議 不要把個人需要的文件/圖片放在主題source文件夾裏，因為在升級主題的過程中，可能會把文件覆蓋刪除了。在 Hexo 根目錄的source文件夾裏，創建一個文件夾來放置個人文件/圖片。引用文件直接為/文件夾名稱/文件名 音樂音樂界面使用了插件 hexo-tag-aplayer使用方法請參考插件文檔 音樂頁面只是普通的 page 頁，按普通頁面操作生成就行。 以下內容可供選擇配置 注意： 仍需要安裝插件hexo-tag-aplayer 插件會在每一個文件都插入 js 和 css，為了避免這一情況，3.0 版本內置了 aplayer 需要的 css 和 js。 首先在 Hexo 根目錄 _config 裏配置 asset_inject 為 false 12aplayer: asset_inject: false 然後在你需要使用 aplayer 的頁面...
2020-05-28
Butterfly 文檔(三) 主題配置
📚 文檔目錄 🚀 快速開始 - 📑 主題頁面 - 📌 主題配置 - ⚔️ 標簽外掛 - ❓ 主題問答 - ⚡️ 進階教程 你可以通過右下角的 簡...
2020-05-28
Butterfly 更新日誌
4.9.0 之後的更新日誌將會單獨文章發佈，請查看 更新日誌 你可以通過右下角的 簡 按鈕切換為簡體顯示 4.9.0 (2023/06/06)4.9.0 (2023/06/06)Feature 適配 mermaid v10 大於 2000px 時，顯示區域增大 可配置 header 和 footer 是否添加黑色半透遮罩 1234+# Add mask to header or footer (為 header 或 footer 添加黑色半透遮罩)+mask:+ header: true+ footer: true artalk 最新評論改為 api 直接調用 waline 最新評論和評論數改為 api 直接調用 再次點擊右下角聊天按鈕，可關閉聊天 適配新版 artalk 支持隨機友鏈順序 Fix 修復 行內 mathjax 出現滾動條的 bug 修復當 top_img 為顏色時， 閲讀模式的頂部依舊顯示顏色的 bug 修復配置 subtitle 的 sub 沒有生效的 bug Improvement 更新...
2020-05-28
Butterfly 文檔(四) 標簽外挂
📚 文檔目錄 🚀 快速開始 - 📑 主題頁面 - 📌 主題配置 - ⚔️ 標簽外挂 - ❓ 主題問答 - ⚡️ 進階教程 你可以通過右下角的 簡 按鈕切換為簡體顯示 標籤外掛是 Hexo 獨有的功能，並不是標準的 Markdown 格式。 以下的寫法，只適用於 Butterfly 主題，用在其它主題上不會有效果，甚至可能會報錯。使用前請留意 標籤外掛雖然能為主題帶來一些額外的功能和 UI 方面的強化，但是，標籤外掛也有明顯的限制，使用時請留意。 Note (Bootstrap Callout)通用設置用法 1用法 2（自定義 icon）移植於 next 主題，並進行修改。 123456789101112note: # Note tag style values: # - simple bs-callout old alert style. Default. # - modern bs-callout new (v2-v3) alert style. # - flat flat callout style with...