Docs文檔

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

📚 文檔目錄 🚀 快速開始 - 📑 主題頁面 - 📌 主題配置-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 ...

📚 文檔目錄 🚀 快速開始 - 📑 主題頁面 - 📌 主題配置-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 ...

📚 文檔目錄 🚀 快速開始 - 📑 主題頁面 - 📌 主題配置-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 的效 ...

📚 文檔目錄 🚀 快速開始 - 📑 主題頁面 - 📌 主題配置-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 ...

📚 文檔目錄 🚀 快速開始 - 📑 主題頁面 - 📌 主題配置-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 ...

📚 文檔目錄 🚀 快速開始 - 📑 主題頁面 - 📌 主題配置-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 ...