butterfly主题配置日记
butterfly 配置
1.网站资料
1 | title: 蓝涴 |
2.导航栏设置
2-1 参数设置:
1 | nav: |
2-2 菜单目录:
1 | menu: |
必須是 /xxx/,後面||分開,然後寫圖標名。
如果不希望顯示圖標,圖標名可不寫。
默認子目錄是展開的,如果想要隱藏,在子目錄裏添加 hide 。导航前面的名字可以自己更改的
3.代码高亮主题
总共有六种darker、pale night、light、ocean、mac、mac light
1 | highlight_theme: mac # darker / pale night / light / ocean / mac / mac light / false |
4.社交图标
没有设置呢 以后可能会设置一下。
5.头像
1 | # Favicon(網站圖標) |
插叙:设置了一下默认显示的代码块语言,可以搜索code language然后再设置以下代码:
1 | code language")+"'></span>",n.childNodes[0].textContent=t||"yaml" |
6.顶部图
又是插叙,忽然发现上传失败,搜索解决问题。
1 | ##修改 |
更改后又能上传github
頂部圖的獲取順序,如果都沒有配置,則不顯示頂部圖。
頁面頂部圖的獲取順序:
各自配置的 top_img > 配置文件的 default_top_img
文章頁頂部圖的獲取順序:
各自配置的 top_img > cover > 配置文件的 default_top_img
配置 | 解释 |
---|---|
index_img | 主頁的 top_img |
default_top_img | 默認的 top_img,當頁面的 top_img 沒有配置時,會顯示 default_top_img |
archive_img | 歸檔頁面的 top_img |
tag_img | tag 子頁面 的 默認 top_img |
tag_per_img | tag 子頁面的 top_img,可配置每個 tag 的 top_img |
category_img | category 子頁面 的 默認 top_img |
category_per_img | category 子頁面的 top_img,可配置每個 category 的 top_img |
[!TIP]
其它頁面 (tags/categories/自建頁面)和 文章頁 的 top_img ,請到對應的 md 頁面設置front-matter中的top_img
tag_per_img 和 category_per_img 是 3.2.0 新增的內容,可對 tag 和 category 進行單獨的配置
並不推薦為每個 tag 和每個 category 都配置不同的頂部圖,因為配置太多會拖慢生成速度
顺便一提我好像是一图流 感觉也没必要设置?还是说 嗯,果然没有必要
1 | # Disable all banner image |
7.文章封面
1 |
|
配置多项cover时,会随机选择一个,示例写法:
1 | default_cover: |
8.页面meta显示
显示文章的相关信息
1 | post_meta: |
没什么好改的 以后再看看~
9.主页文章节选
只支持自动节选和文章页description
[!NOTE]
- description: 只顯示description
- both: 優先選擇description,如果沒有配置description,則顯示自動節選的內容
- auto_excerpt:只顯示自動節選
- false: 不顯示文章內容
无视无视。
10.页面锚点
关闭
11.图片描述
关闭
12.复制相关配置
配置复制内容是否加版权信息
1 | # copy settings |
以后可以设置一下 现在就算了w
13.文章页相关配置
13.1.文章版权
1 | post_copyright: #為你的博客文章展示文章版權和許可協議。 |
從3.0.0開始,支持對單獨文章設置版權信息,可以在文章Front-matter單獨設置
1 | copyright_author: xxxx |
13.2 文章打赏
无视。
13.3 TOC
在文章頁,會有一個目錄,用於顯示TOC。
属性 | 解释 |
---|---|
post | 文章頁是否顯示 TOC |
page | 普通頁面是否顯示 TOC |
number | 是否顯示章節數 |
expand | 是否展開 TOC |
style_simple | 簡潔模式(側邊欄只顯示 TOC, 只對文章頁有效 ) |
scroll_percent | 是否顯示滾動進度百分比 |
1 | # toc (目錄) |
[!NOTE]
為特定的文章配置
在你的文章md文件的頭部,加入toc_number和toc,並配置true或者false即可。主題會優先判斷文章Markdown的Front-matter是否有配置,如有,則以Front-matter的配置為準。否則,以主題配置文件中的配置為準
13.4 相关文章
相關文章推薦的原理是根據文章tags的比重來推薦
1 | # Related Articles |
13.5 文章过期提醒
可設置是否顯示文章過期提醒,以更新時間為基準。
1 | noticeOutdate: |
13.6 文章编辑按钮
在文章標題旁邊顯示一個編輯按鈕,點擊會跳轉到對應的鏈接去。也就是所谓的在线编辑?没有什么必要吧w
13.7 文章分页按钮
可以设置分页的逻辑,也可以关闭分页显示
1 | # post_pagination (分頁) |
14.footer设置
展示站点起始时间的选项,位于页面的最底部
1 | # Footer Settings |
15. 侧边栏设置
15.1 侧边排版
1 | aside: |
15.2. 访问人数
1 | # busuanzi count for PV / UV in site |
[!TIP]
如果需要修改 busuanzi 的 CDN 鏈接,可通過 主題配置文件 的 CDN 中的 option 進行修改
1
2
3 CDN:
option:
busuanzi: xxxxxxxxx嗯,就在最底下 有个CDN
15.3. 运行时间
关了,有点丑(bushi
15.4. 最新评论
1 | # Aside widget - Newest Comments |
15.5.自定义添加栏目
以后再说
16. 右下角按钮
16.1 简繁转换
1 | translate: |
16.2 阅读模式
去除文章外的内容 ,开启
1 | readmode: true |
16.3. 夜间模式
右下角会有夜间模式按钮
1 | # dark mode |
16.4 滚动状态百分比
关掉,不太好看
1 | rightside_scroll_percent: false |
16.5 按钮顺序
没有设置还是
1 | # Don't modify the following settings unless you know how they work (非必要請不要修改 ) |
17. 标签外挂
换了标签外挂plus 。放在inject上面了,也没啥用 到时候看看好了
18. 文章和页面
[!IMPORTANT]
关于front-matter
是markdown文件最上方以—-分隔的区域,用于指定个别档案的变数
Page Front-matter 用于页面配置
写法 解释 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 用於文章頁配置
寫法 | 解釋 |
---|---|
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 ) |
Page:
1 | --- |
Post:
1 | --- |
19.1 标签页
前往你的 Hexo 博客的根目錄
輸入 hexo new page tags
你會找到 source/tags/index.md 這個文件
修改這個文件:
記得添加 type: “tags”
1 |
|
19.2 分类页
前往你的 Hexo 博客的根目錄
輸入 hexo new page categories
你會找到 source/categories/index.md 這個文件
修改這個文件:
記得添加 type: “categories”
1 |
|
19.3. 友情链接
前往你的 Hexo 博客的根目錄
輸入 hexo new page link
你會找到 source/link/index.md 這個文件
修改這個文件:
記得添加 type: “link”
1 |
|
[!NOTE]
可以选择本地生成or 远程拉取
1.本地生成:
在Hexo博客目錄中的 source/_data(如果沒有 _data 文件夾,請自行創建),創建一個文件 link.yml
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23 - class_name: 友情鏈接
class_desc: 那些人,那些事
link_list:
- name: Hexo
link: https://hexo.io/zh-tw/
avatar: https://d33wubrfki0l68.cloudfront.net/6657ba50e702d84afb32fe846bed54fba1a77add/827ae/logo.svg
descr: 快速、簡單且強大的網誌框架
- class_name: 網站
class_desc: 值得推薦的網站
link_list:
- name: Youtube
link: https://www.youtube.com/
avatar: https://i.loli.net/2020/05/14/9ZkGg8v3azHJfM1.png
descr: 視頻網站
- name: Weibo
link: https://www.weibo.com/
avatar: https://i.loli.net/2020/05/14/TLJBum386vcnI1P.png
descr: 中國最大社交分享平台
- name: Twitter
link: https://twitter.com/
avatar: https://i.loli.net/2020/05/14/5VyHPQqR6LWF39a.png
descr: 社交分享平台2.远程拉取:
從 4.0.0 開始,支持從遠程加載友情鏈接,遠程拉取只支持 json。
注意: 選擇遠程加載後,本地生成的方法會無效。
在 source/link/index.md 這個文件的 front-matter 添加遠程鏈接
1 flink_url: xxxxxjson格式
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38 [
{
"class_name": "友情鏈接",
"class_desc": "那些人,那些事",
"link_list": [
{
"name": "Hexo",
"link": "https://hexo.io/zh-tw/",
"avatar": "https://d33wubrfki0l68.cloudfront.net/6657ba50e702d84afb32fe846bed54fba1a77add/827ae/logo.svg",
"descr": "快速、簡單且強大的網誌框架"
}
]
},
{
"class_name": "網站",
"class_desc": "值得推薦的網站",
"link_list": [
{
"name": "Youtube",
"link": "https://www.youtube.com/",
"avatar": "https://i.loli.net/2020/05/14/9ZkGg8v3azHJfM1.png",
"descr": "視頻網站"
},
{
"name": "Weibo",
"link": "https://www.weibo.com/",
"avatar": "https://i.loli.net/2020/05/14/TLJBum386vcnI1P.png",
"descr": "中國最大社交分享平台"
},
{
"name": "Twitter",
"link": "https://twitter.com/",
"avatar": "https://i.loli.net/2020/05/14/5VyHPQqR6LWF39a.png",
"descr": "社交分享平台"
}
]
}
]