主題

適用於 >= 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 sett...

以下文章只是教程 如果部署之后，并没有出现 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="...

在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代碼如下 12345678910111213141516171819...

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-rend...

📚 文檔目錄 🚀 快速開始 - 📑 主題頁面 - 📌 主題配置 - ⚔️ 標簽外掛 - ❓ 主題問答 - ⚡️ 進階教程 你可以通過右下角的 簡 按鈕切換為簡體顯示 建議 不要把個人需要的文件/圖片放在主題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-m...

📚 文檔目錄 🚀 快速開始 - 📑 主題頁面 - 📌 主題配置 - ⚔️ 標簽外掛 - ❓ 主題問答 - ⚡️ 進階教程 你可以通過右下角的 簡 按鈕切換為簡體顯示 以下是一些網友在安裝的過程中出現的問題。在提問題之前，先看有沒有解決方法。 運行後網頁顯示代碼頁面只顯示 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 配置友情鏈接報錯配置友情鏈接頁面時出現報錯 1234567891011121314151...

📚 文檔目錄 🚀 快速開始 - 📑 主題頁面 - 📌 主題配置 - ⚔️ 標簽外挂 - ❓ 主題問答 - ⚡️ 進階教程 你可以通過右下角的 簡 按鈕切換為簡體顯示 標籤外掛是 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 ba...

📚 文檔目錄 🚀 快速開始 - 📑 主題頁面 - 📌 主題配置 - ⚔️ 標簽外掛 - ❓ 主題問答 - ⚡️ 進階教程 你可以通過右下角的 簡 按鈕切換為簡體顯示 配置文件速讀你可以快速瞭解到所有配置的註解，讓你配置文件更加方便。如果遇到不太清楚的配置，可以在這篇文章找到更加詳細的資訊。 123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150...

📚 文檔目錄 🚀 快速開始 - 📑 主題頁面 - 📌 主題配置 - ⚔️ 標簽外掛 - ❓ 主題問答 - ⚡️ 進階教程 你可以通過右下角的 簡 按鈕切換為簡體顯示 Front-matterFront-matter 是 markdown 文件最上方以 --- 分隔的區域，用於指定個別檔案的變數。 Page Front-matter 用於 頁面 配置 Post Front-matter 用於 文章頁 配置 如果標注可選的參數，可根據自己需要添加，不用全部都寫在 markdown 裏 Page Front-matter12345678910111213141516171819---title:date:updated:type:comments:description:keywords:top_img:mathjax:katex:aside:aplayer:highlight_shrink:random:limit: type: value:--- 參數 解釋 title 【必需】頁面標題 date 【必需】頁面創建日期 type ...

📚 文檔目錄 🚀 快速開始 - 📑 主題頁面 - 📌 主題配置 - ⚔️ 標簽外挂 - ❓ 主題問答 - ⚡️ 進階教程 你可以通過右下角的 簡 按鈕切換為簡體顯示 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 根目錄裏 1g...