记录最近常用的 hexo 指令和标签
具体详情可查阅官方文档: Hexo 、 volantis
常用指令 启动服务器
清除缓存文件 (可简写:hexo cl)
新建文章
新建生活页面
新建生活文章
1 hexo new page --path life/sing "I like singing"
创建一个 source/life/sing.md 文件,同时 Front Matter 中的 title 为 'I like singing'
常见页面配置参数 front-matter 是文件最上方以 ---
分隔的区域,用于指定个别文件的变量。 更多请见 Hexo 官方文档:#front-matter
字段
含义
值类型
默认值
layout
布局模版
String
-
title
页面标题
String
-
seo_title
网页标题
String
page.title
short_title
页面标题(在group列表中显示)
String
page.title
date
创建时间
Date
文件创建时间
updated
更新日期
Date
文件修改时间
link
外部文章网址
String
-
music
内部音乐控件
[Object]
-
robots
robots
String
-
keywords
页面关键词
String
-
description
页面描述、摘要
String
-
cover
是否显示封面
Bool
true
top_meta
是否显示文章或页面顶部的meta信息
Bool
true
bottom_meta
是否显示文章或页面底部的meta信息
Bool
true
sidebar
页面侧边栏
Bool, Array
theme.layout.*.sidebar
body
页面主体元素
Array
theme.layout.on_page.body
thumbnail
缩略图
String
false
icons
图标
Array
[]
pin
是否置顶
Bool
false
headimg
文章头图
url
-
readmore
阅读更多按钮
Bool
-
常用标签 span 标签
属性 可选值 字体 logo
, code
颜色 red
, yellow
, green
, cyan
, blue
, gray
大小 small
, h4
, h3
, h2
, h1
, large
, huge
, ultra
对齐方向 left
, center
, right
1 2 3 4 5 各种颜色的标签,包括:{% span red::红色 %}、{% span yellow::黄色 %}、{% span green::绿色 %}、{% span cyan::青色 %}、{% span blue::蓝色 %}、{% span gray::灰色 %}。 超大号文字: {% span center logo large::Volantis %} {% span center small::A Wonderful Theme for Hexo %}
各种颜色的标签,包括:红色 、黄色 、绿色 、青色 、蓝色 、灰色 。
超大号文字:
Volantis A Wonderful Theme for Hexo
p 标签
属性 可选值 字体 logo
, code
颜色 red
, yellow
, green
, cyan
, blue
, gray
大小 small
, h4
, h3
, h2
, h1
, large
, huge
, ultra
对齐方向 left
, center
, right
1 2 3 4 5 6 7 8 9 {% p red::红色 %} {% p yellow::黄色 %} {% p green::绿色 %} {% p cyan::青色 %} {% p blue::蓝色 %} {% p gray::灰色 %} {% p center logo large::Volantis %} {% p center small::A Wonderful Theme for Hexo %}
红色
黄色
绿色
青色
蓝色
灰色
Volantis
A Wonderful Theme for Hexo
note 标签
属性 可选值 颜色 clear, light, gray, red, yellow, green, cyan, blue 彩色图标 quote, info, warning, done/success, error/danger 灰色图标 radiation, bug, idea, link, paperclip, todo, message, guide, download, up, undo
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 #### 经典用法 {% note::可以在配置文件中设置默认样式,为简单的一句话提供最的简便写法。 %} {% note quote::note quote 适合引用一段话 %} {% note info::note info 默认主题色,适合中性的信息 %} {% note warning::note warning 默认黄色,适合警告性的信息 %} {% note danger::note error/danger 默认红色,适合危险性的信息 %} {% note success::note done/success 默认绿色,适合正确操作的信息 %} #### 更多图标 这些都是默认样式,可以手动加上颜色: {% note radiation::note radiation 默认样式 %} {% note radiation yellow::note radiation yellow 可以加上颜色 %} {% note bug red::note bug red 说明还存在的一些故障 %} {% note link green::note link green 可以放置一些链接 %} {% note paperclip blue::note paperclip blue 放置一些附件链接 %} {% note todo::note todo 待办事项 %} {% note guide clear::note guide clear 可以加上一段向导 %} {% note download::note download 可以放置下载链接 %} {% note message gray::note message gray 一段消息 %} {% note up::note up 可以说明如何进行更新 %} {% note undo light::note undo light 可以说明如何撤销或者回退 %}
经典用法 可以在配置文件中设置默认样式,为简单的一句话提供最的简便写法。
note warning 默认黄色,适合警告性的信息
note error/danger 默认红色,适合危险性的信息
note done/success 默认绿色,适合正确操作的信息
更多图标 这些都是默认样式,可以手动加上颜色:
note radiation yellow 可以加上颜色
note paperclip blue 放置一些附件链接
note guide clear 可以加上一段向导
note undo light 可以说明如何撤销或者回退
checkbox 标签
1 {% checkbox 样式参数(可选)::文本(支持简单md) %}
属性 可选值 样式 plus
, minus
, times
颜色 red
, yellow
, green
, cyan
, blue
状态 checked
1 2 3 4 5 6 7 8 9 10 {% checkbox 纯文本测试 %} {% checkbox checked::支持简单的 [markdown ](https://guides.github.com/features/mastering-markdown/ ) 语法 %} {% checkbox red::支持自定义颜色 %} {% checkbox green checked::绿色 + 默认选中 %} {% checkbox yellow checked::黄色 + 默认选中 %} {% checkbox cyan checked::青色 + 默认选中 %} {% checkbox blue checked::蓝色 + 默认选中 %} {% checkbox plus green checked::增加 %} {% checkbox minus yellow checked::减少 %} {% checkbox times red checked::叉 %}
radio 标签
1 {% radio 样式参数(可选)::文本(支持简单md) %}
属性 可选值 颜色 red
, yellow
, green
, cyan
, blue
状态 checked
1 2 3 4 5 6 7 {% radio 纯文本测试 %} {% radio checked::支持简单的 [markdown ](https://guides.github.com/features/mastering-markdown/ ) 语法 %} {% radio red::支持自定义颜色 %} {% radio green::绿色 %} {% radio yellow::黄色 %} {% radio cyan::青色 %} {% radio blue::蓝色 %}
timeline 标签
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 {% timeline 时间线标题(可选) %} {% timenode 时间节点(标题) %} 正文内容 {% endtimenode %} {% timenode 时间节点(标题) %} 正文内容 {% endtimenode %} {% endtimeline %}
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 {% timeline 更新日志 %} {% timenode 2020-07-24 [2.6.6 -> 3.0 ](https://github.com/volantis-x/hexo-theme-volantis/releases ) %} 1. 如果有 `hexo-lazyload-image` 插件,需要删除并重新安装最新版本,设置 `lazyload.isSPA: true` 。2. 2.x 版本的 css 和 js 不适用于 3.x 版本,如果使用了 `use_cdn: true` 则需要删除。3. 2.x 版本的 fancybox 标签在 3.x 版本中被重命名为 gallery 。4. 2.x 版本的置顶 `top: true` 改为了 `pin: true` ,并且同样适用于 `layout: page` 的页面。5. 如果使用了 `hexo-offline` 插件,建议卸载,3.0 版本默认开启了 pjax 服务。{% endtimenode %} {% timenode 2020-05-15 [2.6.3 -> 2.6.6 ](https://github.com/volantis-x/hexo-theme-volantis/releases/tag/2.6.6 ) %} 不需要额外处理。 {% endtimenode %} {% timenode 2020-04-20 [2.6.2 -> 2.6.3 ](https://github.com/volantis-x/hexo-theme-volantis/releases/tag/2.6.3 ) %} 1. 全局搜索 `seotitle` 并替换为 `seo_title` 。2. group 组件的索引规则有变,使用 group 组件的文章内,`group: group_name` 对应的组件名必须是 `group_name` 。2. group 组件的列表名优先显示文章的 `short_title` 其次是 `title` 。{% endtimenode %} {% endtimeline %}
更新日志
如果有 hexo-lazyload-image
插件,需要删除并重新安装最新版本,设置 lazyload.isSPA: true
。 2.x 版本的 css 和 js 不适用于 3.x 版本,如果使用了 use_cdn: true
则需要删除。 2.x 版本的 fancybox 标签在 3.x 版本中被重命名为 gallery 。 2.x 版本的置顶 top: true
改为了 pin: true
,并且同样适用于 layout: page
的页面。 如果使用了 hexo-offline
插件,建议卸载,3.0 版本默认开启了 pjax 服务。 全局搜索 seotitle
并替换为 seo_title
。 group 组件的索引规则有变,使用 group 组件的文章内,group: group_name
对应的组件名必须是 group_name
。 group 组件的列表名优先显示文章的 short_title
其次是 title
。
tabs 标签
1 2 3 4 5 6 7 8 {% tabs 页面内不重复的ID %} <!-- tab 栏目1 --> 内容 <!-- endtab --> <!-- tab 栏目2 --> 内容 <!-- endtab --> {% endtabs %}
1 2 3 4 5 6 7 8 {% tabs 页面内不重复的ID %} <!-- tab 栏目1 --> 栏目1的内容 <!-- endtab --> <!-- tab 栏目2 --> 栏目2的内容 <!-- endtab --> {% endtabs %}
folding 标签
1 2 3 {% folding 参数(可选)::标题 %} ![](https://gcore.jsdelivr.net/gh/volantis-x/cdn-wallpaper/abstract/41F215B9-261F-48B4-80B5-4E86E165259E.jpeg ) {% endfolding %}
属性 可选值 颜色 red
, yellow
, green
, cyan
, blue
状态 open
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 {% folding 查看图片测试 %} ![](https://gcore.jsdelivr.net/gh/volantis-x/cdn-wallpaper/abstract/41F215B9-261F-48B4-80B5-4E86E165259E.jpeg ) {% endfolding %} {% folding cyan open::查看默认打开的折叠框 %} 这是一个默认打开的折叠框。 {% endfolding %} {% folding green::查看代码测试 %} {% endfolding %} {% folding yellow::查看列表测试 %} - haha- hehe{% endfolding %} {% folding red::查看嵌套测试 %} {% folding blue::查看嵌套测试2 %} {% folding 查看嵌套测试3 %} hahaha <span > <img src ='https://gcore.jsdelivr.net/gh/volantis-x/cdn-emoji/tieba/%E6%BB%91%E7%A8%BD.png' style ='height:24px' > </span > {% endfolding %} {% endfolding %} {% endfolding %}
查看图片测试 查看默认打开的折叠框 查看代码测试 1 2 3 4 5 6 #include <iostream> int main () { std::cout << "Hello world!" << std::endl; return 0 ; }
查看列表测试 查看嵌套测试 查看嵌套测试2 查看嵌套测试3 hahaha
gallery 标签
1 2 3 4 {% gallery 参数::列数::分组 %} ![图片描述 ](https://gcore.jsdelivr.net/gh/volantis-x/cdn-wallpaper/abstract/B18FCBB3-67FD-48CC-B4F3-457BA145F17A.jpeg ) ![](https://gcore.jsdelivr.net/gh/volantis-x/cdn-wallpaper/abstract/67239FBB-E15D-4F4F-8EE8-0F1C9F3C4E7C.jpeg ) {% endgallery %}
属性 可选值 对齐方向 left
, center
, right
缩放 stretch
列数 ::后面直接写列数,支持 2 ~ 8 列。设定列数之后就是「多行多图」布局,此时图片默认左对齐。为了避免图片大小不一,建议搭配 stretch 来时图片放大填充
分组 相同内容的会被归档在一个分组中
一行一个图片
example.md: 1 2 3 {% gallery %} ![图片描述 ](https://gcore.jsdelivr.net/gh/volantis-x/cdn-wallpaper/abstract/41F215B9-261F-48B4-80B5-4E86E165259E.jpeg ) {% endgallery %}
一行多个图片(不换行)
example.md: 1 2 3 4 5 {% gallery::::one %} ![图片描述 ](https://gcore.jsdelivr.net/gh/volantis-x/cdn-wallpaper/abstract/B18FCBB3-67FD-48CC-B4F3-457BA145F17A.jpeg ) ![图片描述 ](https://gcore.jsdelivr.net/gh/volantis-x/cdn-wallpaper/abstract/67239FBB-E15D-4F4F-8EE8-0F1C9F3C4E7C.jpeg ) ![图片描述 ](https://gcore.jsdelivr.net/gh/volantis-x/cdn-wallpaper/abstract/00E0F0ED-9F1C-407A-9AA6-545649D919F4.jpeg ) {% endgallery %}
多行多个图片(每行2~8个图片)
example.md: 1 2 3 4 5 6 7 8 9 10 11 12 13 14 {% gallery stretch::6::two %} ![](https://gcore.jsdelivr.net/gh/volantis-x/cdn-wallpaper-minimalist/2020/007.jpg ) ![](https://gcore.jsdelivr.net/gh/volantis-x/cdn-wallpaper-minimalist/2020/008.jpg ) ![](https://gcore.jsdelivr.net/gh/volantis-x/cdn-wallpaper-minimalist/2020/009.jpg ) ![](https://gcore.jsdelivr.net/gh/volantis-x/cdn-wallpaper-minimalist/2020/010.jpg ) ![](https://gcore.jsdelivr.net/gh/volantis-x/cdn-wallpaper-minimalist/2020/011.jpg ) ![](https://gcore.jsdelivr.net/gh/volantis-x/cdn-wallpaper-minimalist/2020/012.jpg ) ![](https://gcore.jsdelivr.net/gh/volantis-x/cdn-wallpaper-minimalist/2020/013.jpg ) ![](https://gcore.jsdelivr.net/gh/volantis-x/cdn-wallpaper-minimalist/2020/014.jpg ) ![](https://gcore.jsdelivr.net/gh/volantis-x/cdn-wallpaper-minimalist/2020/015.jpg ) ![](https://gcore.jsdelivr.net/gh/volantis-x/cdn-wallpaper-minimalist/2020/016.jpg ) ![](https://gcore.jsdelivr.net/gh/volantis-x/cdn-wallpaper-minimalist/2020/017.jpg ) ![](https://gcore.jsdelivr.net/gh/volantis-x/cdn-wallpaper-minimalist/2020/018.jpg ) {% endgallery %}
图片描述 一行多个图片(不换行)
多行多个图片(每行2~8个图片)
记录博客常用命令和标签
转载或引用本文时请遵守许可协议,注明出处、不得用于商业用途!