Butterfly 安裝文档(二) 主题页面
文档
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) |
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 ) |
標籤頁
前往你的 Hexo 博客的根目錄
輸入
hexo new page tags
你會找到
source/tags/index.md
這個文件修改這個文件:
記得添加
type: "tags"
1 | --- |
參數 | 解釋 |
---|---|
type | 【必須】頁面類型,必須為 tags |
orderby | 【可選】排序方式 :random/name/length |
order | 【可選】排序次序: 1, asc for ascending; -1, desc for descending |
分類頁
前往你的 Hexo 博客的根目錄
輸入
hexo new page categories
你會找到
source/categories/index.md
這個文件修改這個文件:
記得添加
type: "categories"
1 | --- |
友情鏈接
為你的博客創建一個友情鏈接!
創建友情鏈接頁面
前往你的 Hexo 博客的根目錄
輸入
hexo new page link
你會找到
source/link/index.md
這個文件修改這個文件:
記得添加
type: "link"
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 起,友情鏈接界面可以由用户自己自定義,只需要在友情鏈接的md檔設置就行,以普通的Markdown格式書寫。
圖庫
圖庫頁面只是普通的頁面,你只需要 hexo n page xxxxx
創建你的頁面就行
然後使用標簽外掛 galleryGroup,具體用法請查看對應的內容。
1 | <div class="gallery-group-main"> |
子頁面
子頁面也是普通的頁面,你只需要 hexo n page xxxxx
創建你的頁面就行
然後使用標簽外掛,具體用法請查看對應的內容。
1 | {% gallery %} |
[{“url”:”img/Fze9jchtnyJXMHN.jpg”,”alt”:””},{“url”:”img/ryLVePaqkYm4TEK.jpg”,”alt”:””},{“url”:”img/gEy5Zc1Ai6VuO4N.jpg”,”alt”:””},{“url”:”img/d6QHbytlSYO4FBG.jpg”,”alt”:””},{“url”:”img/6nepIJ1xTgufatZ.jpg”,”alt”:””},{“url”:”img/E7Jvr4eIPwUNmzq.jpg”,”alt”:””},{“url”:”img/mh19anwBSWIkGlH.jpg”,”alt”:””},{“url”:”img/2tu9JC8ewpBFagv.jpg”,”alt”:””}]
如果你想要使用 /photo/ohmygirl
這樣的鏈接顯示你的圖片內容
你可以把創建好的 ohmygirl
整個文件夾移到 photo
文件夾裏去
404頁面
主題內置了一個簡單的 404 頁面,可在設置中開啟
本地預覽時,訪問出錯的網站是不會跳到 404 頁面的。
如需本地預覽,請訪問 http://localhost:4000/404.html
1 | # A simple 404 page |