butterfly 配置

1.网站资料

1
2
3
4
5
6
7
8
title: 蓝涴
subtitle: '可可爱爱,没有脑袋'
description: '爱好蓝色desu'
keywords: '渗透,hack'
author: Lanyuan
language: zh-CN
timezone: ''
email:

2.导航栏设置

2-1 参数设置:

1
2
3
4
nav:
logo: #image 网站logo图片,
display_title: true #是否显示网站标题
fixed: false # fixed navigation bar 是否固定状态栏

2-2 菜单目录:

1
2
3
4
5
6
7
8
9
10
11
12
13
menu:
Home: / || fas fa-home
追番: /bangumis/index.html || fas fa-home
留言板: /comments/ || fas fa-envelope
# Archives: /archives/ || fas fa-archive
# Tags: /tags/ || fas fa-tags
# Categories: /categories/ || fas fa-folder-open
# List||fas fa-list ||hide:
# Music: /music/ || fas fa-music
# Movie: /movies/ || fas fa-video
# Link: /link/ || fas fa-link
# About: /about/ || fas fa-heart

必須是 /xxx/,後面||分開,然後寫圖標名。

如果不希望顯示圖標,圖標名可不寫。

默認子目錄是展開的,如果想要隱藏,在子目錄裏添加 hide 。导航前面的名字可以自己更改的

3.代码高亮主题

总共有六种darker、pale night、light、ocean、mac、mac light

1
2
3
4
5
6
highlight_theme: mac #  darker / pale night / light / ocean / mac / mac light / false
highlight_copy: true # 代码复制功能
highlight_lang: true # show the code language
highlight_shrink: false # true: shrink the code blocks / false: expand the code blocks | none: expand code blocks and hide the button
highlight_height_limit: false # unit: px
code_word_wrap: true #设置代码自动换行,还需要到hexo config文件渲染那里设置line_number为true

4.社交图标

没有设置呢 以后可能会设置一下。

5.头像

1
2
3
4
5
6
7
# Favicon(網站圖標)
favicon: /img/web/weblg.png
# Avatar (頭像)
avatar:
img: /img/web/head.png
effect: false #这个设置为true的话会一直转圈圈~


插叙:设置了一下默认显示的代码块语言,可以搜索code language然后再设置以下代码:

1
code language")+"'></span>",n.childNodes[0].textContent=t||"yaml"

6.顶部图


又是插叙,忽然发现上传失败,搜索解决问题。

1
2
3
4
5
6
##修改
deploy:
type: git
repo: https://github.com/yourname/yourname.github.io.git -->git@github.com:a956551943/weixiaohui.github.io.git
branch: main

更改后又能上传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_imgtag 子頁面 的 默認 top_img
tag_per_imgtag 子頁面的 top_img,可配置每個 tag 的 top_img
category_imgcategory 子頁面 的 默認 top_img
category_per_imgcategory 子頁面的 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
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
# Disable all banner image
disable_top_img: false

# The banner image of home page
index_img:

# If the banner of page not setting, it will show the top_img
default_top_img:

# The banner image of archive page
archive_img:

# If the banner of tag page not setting, it will show the top_img
# note: tag page, not tags page (子標籤頁面的 top_img)
tag_img:

# The banner image of tag page
# format:
# - tag name: xxxxx
tag_per_img:

# If the banner of category page not setting, it will show the top_img
# note: category page, not categories page (子分類頁面的 top_img)
category_img:

# The banner image of category page
# format:
# - category name: xxxxx
category_per_img:

7.文章封面

1
2
3
4
5
6
7
8
9
10
11
12

cover:
# display the cover or not (是否顯示文章封面)
index_enable: true #主页
aside_enable: true #侧栏
archives_enable: true #归档页面
# the position of cover in home page (封面顯示的位置)
# left/right/both
position: both #left 全部显示在左边 right 你懂得 both 一左一右显示
# When cover is not set, the default cover is displayed (當沒有設置cover時,默認的封面顯示)
default_cover: /img/web/default.png
# - https://i.loli.net/2020/05/01/gkihqEjXxJ5UZ1C.jpg

配置多项cover时,会随机选择一个,示例写法:

1
2
3
4
default_cover:
- https://jsd.012700.xyz/gh/jerryc127/CDN@latest/cover/default_bg.png
- https://jsd.012700.xyz/gh/jerryc127/CDN@latest/cover/default_bg2.png
- https://jsd.012700.xyz/gh/jerryc127/CDN@latest/cover/default_bg3.png

8.页面meta显示

显示文章的相关信息

1
2
3
4
5
6
7
8
9
10
11
12
13
14
post_meta:
page: # Home Page
date_type: created # created or updated or both 主頁文章日期是創建日或者更新日或都顯示
date_format: date # date/relative 顯示日期還是相對日期
categories: true # true or false 主頁是否顯示分類
tags: false # true or false 主頁是否顯示標籤
label: true # true or false 顯示描述性文字
post:
date_type: both # created or updated or both 文章頁日期是創建日或者更新日或都顯示
date_format: date # date/relative 顯示日期還是相對日期
categories: true # true or false 文章頁是否顯示分類
tags: true # true or false 文章頁是否顯示標籤
label: true # true or false 顯示描述性文字

没什么好改的 以后再看看~

9.主页文章节选

只支持自动节选和文章页description

[!NOTE]

  1. description: 只顯示description
  2. both: 優先選擇description,如果沒有配置description,則顯示自動節選的內容
  3. auto_excerpt:只顯示自動節選
  4. false: 不顯示文章內容

无视无视。

10.页面锚点

关闭

11.图片描述

关闭

12.复制相关配置

配置复制内容是否加版权信息

1
2
3
4
5
6
7
8
# copy settings
# copyright: Add the copyright information after copied content (複製的內容後面加上版權信息)
copy:
enable: true #是否開啟網站複製權限
copyright: #複製的內容後面加上版權信息
enable: false #是否開啟複製版權信息添加
limit_count: 50 #字數限制,當複製文字大於這個字數限制時,將在複製的內容後面加上版權信息

以后可以设置一下 现在就算了w

13.文章页相关配置

13.1.文章版权

1
2
3
4
5
6
post_copyright: #為你的博客文章展示文章版權和許可協議。
enable: true
decode: false #中文网址会被默认解码,此处可设置 true
author_href:
license: CC BY-NC-SA 4.0
license_url: https://creativecommons.org/licenses/by-nc-sa/4.0/

從3.0.0開始,支持對單獨文章設置版權信息,可以在文章Front-matter單獨設置

1
2
3
4
copyright_author: xxxx
copyright_author_href: https://xxxxxx.com
copyright_url: https://xxxxxx.com
copyright_info: 此文章版權歸xxxxx所有,如有轉載,請註明來自原作者

13.2 文章打赏

无视。

13.3 TOC

在文章頁,會有一個目錄,用於顯示TOC。

属性解释
post文章頁是否顯示 TOC
page普通頁面是否顯示 TOC
number是否顯示章節數
expand是否展開 TOC
style_simple簡潔模式(側邊欄只顯示 TOC, 只對文章頁有效 )
scroll_percent是否顯示滾動進度百分比
1
2
3
4
5
6
7
8
9
# toc (目錄)
toc:
post: true
page: false
number: true
expand: false
style_simple: false # for post
scroll_percent: true

[!NOTE]

為特定的文章配置
在你的文章md文件的頭部,加入toc_number和toc,並配置true或者false即可。

主題會優先判斷文章Markdown的Front-matter是否有配置,如有,則以Front-matter的配置為準。否則,以主題配置文件中的配置為準

13.4 相关文章

相關文章推薦的原理是根據文章tags的比重來推薦

1
2
3
4
5
# Related Articles
related_post:
enable: true
limit: 6 # Number of posts displayed
date_type: created # or created or updated 文章日期顯示創建日或者更新日

13.5 文章过期提醒

可設置是否顯示文章過期提醒,以更新時間為基準。

1
2
3
4
5
6
7
8
noticeOutdate:
enable: false
style: flat # style: simple/flat
limit_day: 500 # 距离更新时间多少天
position: top # position: top/bottom
message_prev: It has been #天数之前的文字
message_next: days since the last update, the content of the article may be outdated.
#天数之后的文字

13.6 文章编辑按钮

在文章標題旁邊顯示一個編輯按鈕,點擊會跳轉到對應的鏈接去。也就是所谓的在线编辑?没有什么必要吧w

13.7 文章分页按钮

可以设置分页的逻辑,也可以关闭分页显示

1
2
3
4
5
6
# post_pagination (分頁)
# value: 1 || 2 || false
# 1: The 'next post' will link to old post
# 2: The 'next post' will link to new post
# false: disable pagination
post_pagination: 1

14.footer设置

展示站点起始时间的选项,位于页面的最底部

1
2
3
4
5
6
7
8
9
# Footer Settings
# --------------------------------------
footer:
owner:
enable: true
since: 2024.5 #博客起点时间
custom_text: #可在这里写ICP<a href="icp鏈接"><img class="icp-icon" src="icp圖片"><span>備案號:xxxxxx</span></a>
copyright: true # Copyright of theme and framework

15. 侧边栏设置

15.1 侧边排版

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
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
aside:
enable: true
hide: false
button: true
mobile: true # display on mobile
position: right # left or right
display:
archive: true
tag: true
category: true
card_author:
enable: true
description:
button:
enable: true
icon: fab fa-github #以后有空来改一下你
text: 哔哩哔哩 (゜-゜)つロ 干杯~
link: https://space.bilibili.com/13790196?spm_id_from=333.1007.0.0
card_announcement:
enable: true
content: This is my Blog
card_recent_post:
enable: true
limit: 5 # if set 0 will show all
sort: date # date or updated
sort_order: # Don't modify the setting unless you know how it works
card_categories:
enable: true
limit: 8 # if set 0 will show all
expand: none # none/true/false
sort_order: # Don't modify the setting unless you know how it works
card_tags:
enable: true
limit: 40 # if set 0 will show all
color: false
orderby: random # Order of tags, random/name/length
order: 1 # Sort of order. 1, asc for ascending; -1, desc for descending
sort_order: # Don't modify the setting unless you know how it works
card_archives:
enable: true
type: monthly # yearly or monthly
format: MMMM YYYY # eg: YYYY年MM月
order: -1 # Sort of order. 1, asc for ascending; -1, desc for descending
limit: 8 # if set 0 will show all
sort_order: # Don't modify the setting unless you know how it works
card_webinfo:
enable: true
post_count: true
last_push_date: true
sort_order: # Don't modify the setting unless you know how it works
card_post_series:
enable: true
series_title: false # The title shows the series name
orderBy: 'date' # Order by title or date
order: -1 # Sort of order. 1, asc for ascending; -1, desc for descending

15.2. 访问人数

1
2
3
4
5
6
# busuanzi count for PV / UV in site
# 訪問人數
busuanzi:
site_uv: true
site_pv: true
page_pv: true

[!TIP]

如果需要修改 busuanzi 的 CDN 鏈接,可通過 主題配置文件 的 CDN 中的 option 進行修改

1
2
3
CDN:
option:
busuanzi: xxxxxxxxx

嗯,就在最底下 有个CDN

15.3. 运行时间

关了,有点丑(bushi

15.4. 最新评论

1
2
3
4
5
6
7
# Aside widget - Newest Comments
newest_comments:
enable: true
sort_order: # Don't modify the setting unless you know how it works
limit: 6
storage: 10 # unit: mins, save data to localStorage
avatar: true

15.5.自定义添加栏目

以后再说

16. 右下角按钮

16.1 简繁转换

1
2
3
4
5
6
7
8
9
10
11
12
translate:
enable: false
# The text of a button
default:
# the language of website (1 - Traditional Chinese/ 2 - Simplified Chinese)
defaultEncoding: 2
# Time delay
translateDelay: 0
# The text of the button when the language is Simplified Chinese
msgToTraditionalChinese: '繁'
# The text of the button when the language is Traditional Chinese
msgToSimplifiedChinese: '簡'

16.2 阅读模式

去除文章外的内容 ,开启

1
readmode: true

16.3. 夜间模式

右下角会有夜间模式按钮

1
2
3
4
5
6
7
8
9
# dark mode
darkmode:
enable: true
# dark mode和 light mode切換按鈕
button: true
autoChangeMode: false #自动切换的模式 1 跟随系统 2 按照时间切换 false取消自动切换
# Set the light mode time. The value is between 0 and 24. If not set, the default value is 6 and 18
start: # 8 开始时间
end: # 22 结束时间

16.4 滚动状态百分比

关掉,不太好看

1
rightside_scroll_percent: false

16.5 按钮顺序

没有设置还是

1
2
3
4
5
6
7
# Don't modify the following settings unless you know how they work (非必要請不要修改 )
# Choose: readmode,translate,darkmode,hideAside,toc,chat,comment
# Don't repeat 不要重複
rightside_item_order:
enable: false
hide: # readmode,translate,darkmode,hideAside
show: # toc,chat,comment

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
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
---
title:
date:
updated:
type:
comments:
description:
keywords:
top_img:
mathjax:
katex:
aside:
aplayer:
highlight_shrink:
random:
---

Post:

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
---
title:
date:
updated:
tags:
categories:
keywords:
description:
top_img:
comments:
cover:
toc:
toc_number:
toc_style_simple:
copyright:
copyright_author:
copyright_author_href:
copyright_url:
copyright_info:
mathjax:
katex:
aplayer:
highlight_shrink:
aside:
abcjs:
---

19.1 标签页

前往你的 Hexo 博客的根目錄

輸入 hexo new page tags

你會找到 source/tags/index.md 這個文件

修改這個文件:

記得添加 type: “tags”

1
2
3
4
5
6
7
---
title: 標籤
date: 2018-01-05 00:00:00
type: "tags"
orderby: random
order: 1
---

19.2 分类页

前往你的 Hexo 博客的根目錄

輸入 hexo new page categories

你會找到 source/categories/index.md 這個文件

修改這個文件:

記得添加 type: “categories”

1
2
3
4
5
---
title: 分類
date: 2018-01-05 00:00:00
type: "categories"
---

19.3. 友情链接

前往你的 Hexo 博客的根目錄

輸入 hexo new page link

你會找到 source/link/index.md 這個文件

修改這個文件:

記得添加 type: “link”

1
2
3
4
5
---
title: 友情鏈接
date: 2018-06-07 22:17:49
type: "link"
---

[!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: xxxxx

json格式

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": "社交分享平台"
}
]
}
]