Front-matter

Page Front-matter

页面顶部的 markdown 格式

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
---
title: [必填] 页面标题
date: [必填] 页面创建日期
type: [必填] 标签、分类和友情链接三个页面需要配置
updated: 页面更新日期
comments: 显示页面评论模块(默认true)
description: 页面描述
keywords: 页面关键字
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 的配置)
---

Post Front-matter

文章顶部的 markdown 格式

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
---
title: [必填]文章标题
date: [必填]文章创建日期
updated: 文章更新日期
tags: 文章标签
categories: 文章分类
keywords: 文章关键字
description: 文章描述
top_img: 文章顶部图片
comments: 显示文章评论模块(默认true)
cover: 文章缩略图 (如果没有设置top_img,文章页顶部将显示缩略图,可设为false/图片地址/留空)
toc: 显示文章 TOC (默认为设置中 toc enable 配置)
toc_number: 显示 toc_number (默认为设置中 toc number 配置)
auto_open: 是否自动打开 TOC (默认为设置中 toc auto_open 配置)
copyright: 显示文章版权模块 (默认为设置中 post_copyright enable 配置)
mathjax: 显示 mathjax (当设置 mathjax per_page: false 时,才需要配置,默认 false)
katex: 显示 katex (当设置 katex per_page: false 时,才需要配置,默认 false)
aplayer: 在需要的页面加载 aplayer js css
highlight_shrink: 配置代码框是否展开 (true/false)(默认为设置中 highlight_shrink 的配置)
---

标签外挂

用法

1
2
3
4
5
6
7
8
{% note [class] [no-icon] %}
Any content (support inline tags too.io).
{% endnote %}

[class] : default | primary | success | info | warning | danger.
[no-icon] : Disable icon in note.

All parameters are optional.

例如

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
{% note default %}
default 提示块标籤
{% endnote %}

{% note primary no-icon %}
primary 提示块标籤
{% endnote %}

{% note success %}
success 提示块标籤
{% endnote %}

{% note info %}
info 提示块标籤
{% endnote %}

{% note warning %}
warning 提示块标籤
{% endnote %}

{% note danger %}
danger 提示块标籤
{% endnote %}

default 提示块标籤

primary 提示块标籤

success 提示块标籤

info 提示块标籤

warning 提示块标籤

danger 提示块标籤

tabs tag-hide

inline 在文本里面添加按钮隐藏内容,只限文字

( content 不能包含英文逗号,可用 ‚ )

1
{% hideInline content,display,bg,color %}
  • content: 文本内容
  • display: 按钮显示的文字
  • bg: 按钮的背景
  • color: 按钮的文字颜色

Demo

1
2
3
4
5
哪个英文字母最酷?
{% hideInline 因为西装裤(C装酷),查看答案,#FF7242,#fff %}

门里站着一个人?
{% hideInline 闪 %}

哪个英文字母最酷?
因为西装裤(C装酷)

门里站着一个人?

block 独立的 block 隐藏内容,可以隐藏图片,文字,代码块等等

( display 不能包含英文逗号,可用 ‚ )

1
2
3
{% hideBlock display,bg,color %}
content
{% endhideBlock %}
  • content: 文本内容
  • display: 按钮显示的文字
  • bg: 按钮的背景
  • color: 按钮的文字颜色

哪个英文字母最酷?
因为西装裤(C装酷)

如果你需要展示的内容太多,可以把它隐藏在收缩框里,需要时再把它展开。

( display 不能包含英文逗号,可用 ‚ )

Butterfly安装方法

在你的博客根目录里

git clone -b master https://github.com/jerryc127/hexo-theme-butterfly.git themes/Butterfly

如果想要安装比较新的dev分支,可以

git clone -b dev https://github.com/jerryc127/hexo-theme-butterfly.git themes/Butterfly