自定義側邊欄
適用於 >= 3.8.0
側邊欄現在支持自定義了,可以添加自己喜歡的 widget。
可添加自己的 widget,也可以對現有的 widget 進行排序(博客資料和 公告這兩個固定,其它的能排序)
widget 排序只需要配置 sort_order就行。(使用了 Flex 佈局的 order 屬性,具體可查看 mozilla 文檔。簡單來講,就是配置數字來實現排序,如果不配置,則默認為 0。數字越小,排序越靠前。
12345678910111213141516aside: ... 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 ...
Butterfly添加全局吸底Aplayer教程
以下文章只是教程
如果部署之后,并没有出现 aplayer , 请确认是否跟足步骤操作或者更换音乐源,多试试。
如果遇到使用問題,请仔细查看插件文档,或者到插件那裏反饋。
前言如果你想使用 aplayer,很多人都會推薦安裝 hexo-tag-aplayer 這款插件。這款插件通過 Hexo 獨有的標籤外掛,我們可以很方便的寫入一些參數,插件就會幫我們生成對應的 html。如果你只是使用一些簡單的功能,其實無需使用到這個插件,只需以 html 格式書寫就行,不用插件去轉換。
例如:
如果使用插件,在 markdown 中要這樣寫
1{% meting "000PeZCQ1i4XVs" "tencent" "artist" "theme:#3F51B5" "mutex:true" "preload:auto" %}
其會被插件渲染為
1<div id="aplayer-uxAIfEUs" class="apl ...
自定義代碼配色
在Butterfly-安裝文檔-三-主題配置中已經介紹瞭如何使用自定義代碼配色。
這篇文章是使用自定義代碼配色的實例教程。
Highlight以使用Kimbie dark主題配色為例子
配置hljs為true修改Hexo根目錄下的_config.yml
123456highlight: enable: true line_number: true auto_detect: false tab_replace: hljs: true
配置highlight_theme為false修改主題配置文件
1highlight_theme: false
下載和修改CSS文件在Github上找到這個CSS
在Hexo的根目錄source文件夾下創立一個self文件夾,在self文件夾創建一個Kimbiedark.css文件
把Github上Kimbie dark的CSS代碼複製到Kimbiedark.css去。(你也可以直接從Github上下載這個CSS)
Kimbiedark.css代碼如下
123456789101112131415161718192021222324252627282930 ...
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
更新 hexo-render ...
Butterfly 安裝文檔(六) 進階教程
📚 文檔目錄
🚀 快速開始 - 📑 主題頁面 - 📌 主題配置-1 - ⚔️ 主題配置-2 - ❓ 主題問答 - ⚡️ 進階教程
你可以通過右下角的 簡 按鈕切換為簡體顯示
建議
不要把個人需要的文件/圖片放在主題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的頁面Front-matter添加
1a ...
Butterfly 安裝文檔(五) 主題問答
📚 文檔目錄
🚀 快速開始 - 📑 主題頁面 - 📌 主題配置-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 hexo-renderer-pug hexo-renderer-stylus --save or yarn add hexo-renderer-pug hexo-renderer-stylus
配置友情鏈接報錯配置友情鏈接頁面時出現報錯
123456789101112131 ...
Butterfly 安裝文檔(四) 主題配置-2
📚 文檔目錄
🚀 快速開始 - 📑 主題頁面 - 📌 主題配置-1 - ⚔️ 主題配置-2 - ❓ 主題問答 - ⚡️ 進階教程
你可以通過右下角的 簡 按鈕切換為簡體顯示
Math 數學MathJaxKaTeX不要在標題裏使用 mathjax 語法,toc 目錄不一定能正確顯示 mathjax,可能顯示 mathjax 代碼
建議使用 KaTex 獲得更好的效果,下文有介紹!
修改 主題配置文件:
12345mathjax: enable: true # true 表示每一頁都加載mathjax.js # false 需要時加載,須在使用的Markdown Front-matter 加上 mathjax: true per_page: false
如果 per_page 設為 true,則每一頁都會加載 Mathjax 服務。設為 false,則需要在文章 Front-matter 添加 mathjax: true,對應的文章才會加載 Mathjax 服務。
然後你需要修改一下默認的 markdown 渲染引擎來實現 MathJax 的效 ...
Butterfly 安裝文檔(三) 主題配置-1
📚 文檔目錄
🚀 快速開始 - 📑 主題頁面 - 📌 主題配置-1 - ⚔️ 主題配置-2 - ❓ 主題問答 - ⚡️ 進階教程
你可以通過右下角的 簡 按鈕切換為簡體顯示
語言修改站點配置文件 _config.yml
默認語言是 en
主題支持三種語言
default(en)
zh-CN (簡體中文)
zh-TW (繁體中文)
網站資料修改網站各種資料,例如標題、副標題和郵箱等個人資料,請修改博客根目錄的_config.yml
導航欄設置 (Navigation bar settings)參數設置主題配置文件中
1234nav: logo: #image display_title: true fixed: false # fixed navigation bar
參數
解釋
logo
網站的 logo,支持圖片,直接填入圖片鏈接
display_title
是否顯示網站標題,填寫 true 或者 false
fixed
是否固定狀態欄,填寫 true 或者 false
菜單/目錄修改 主題配置文件
123456 ...
Butterfly 安裝文檔(二) 主題頁面
📚 文檔目錄
🚀 快速開始 - 📑 主題頁面 - 📌 主題配置-1 - ⚔️ 主題配置-2 - ❓ 主題問答 - ⚡️ 進階教程
你可以通過右下角的 簡 按鈕切換為簡體顯示
Front-matterFront-matter 是 markdown 文件最上方以 --- 分隔的區域,用於指定個別檔案的變數。
Page Front-matter 用於頁面配置
Post Front-matter 用於文章頁配置
如果標注可選的參數,可根據自己需要添加,不用全部都寫在 markdown 裏
Page Front-matter12345678910111213141516---title:date:updated:type:comments:description:keywords:top_img:mathjax:katex:aside:aplayer:highlight_shrink:random:---
寫法
解釋
title
【必需】頁面標題
date
【必需】頁面創建日期
type
【必需】標籤、分類和友情鏈接三個頁面需要配置
up ...
Butterfly 安裝文檔(一) 快速開始
📚 文檔目錄
🚀 快速開始 - 📑 主題頁面 - 📌 主題配置-1 - ⚔️ 主題配置-2 - ❓ 主題問答 - ⚡️ 進階教程
你可以通過右下角的 簡 按鈕切換為簡體顯示
hexo-theme-butterfly 是基於 hexo-theme-melody 的基礎上進行開發的。
安裝Git安裝 (Github)Git安裝 (Gitee)npm安裝穩定版【建議】
在你的 Hexo 根目錄裏
1git clone -b master https://github.com/jerryc127/hexo-theme-butterfly.git themes/butterfly
測試版
測試版可能存在 bug,追求穩定的請安裝穩定版
如果想要安裝比較新的 dev 分支,可以
1git clone -b dev https://github.com/jerryc127/hexo-theme-butterfly.git themes/butterfly
升級方法:在主題目錄下,運行 git pull
穩定版【建議】
在你的 Hexo 根目錄裏
1git clone ...