Hexo使用手册

Hexo搭建教程

知乎教程

夜星梦尘

CSDN个性化搭建

---

Hexo文档

Hexo中文文档

STUM文档

---

Formatter介绍

属性名	描述	是否必需	默认值
title	页面标题	是	-
date	页面创建日期	是	-
type	标签、分类和友情链接三个页面需要配置	是	-
updated	页面更新日期	否	-
description	页面描述	否	-
keywords	页面关键字	否	-
comments	显示页面评论模块（默认为true）	否	true
top_img	页面顶部图片	否	-
mathjax	显示mathjax（当设置mathjax的per_page: false时，才需要配置）	否	false
katex	显示katex（当设置katex的per_page: false时，才需要配置）	否	false
aside	显示侧边栏（默认为true）	否	true
highlight_shrink	配置代码框是否展开（true/false）（默认为设置中highlight_shrink的配置）	否	-

tips:以上这个表格的md是这样写的

| 属性名       | 描述                                                         | 是否必需 | 默认值        |
|------------|------------------------------------------------------------|--------|-------------|
| title      | 页面标题                                                    | 是     | -           |
| date       | 页面创建日期                                                | 是     | -           |
| type       | 标签、分类和友情链接三个页面需要配置                          | 是     | -           |
| updated    | 页面更新日期                                                | 否     | -           |
| description| 页面描述                                                    | 否     | -           |
| keywords   | 页面关键字                                                  | 否     | -           |
| comments   | 显示页面评论模块（默认为true）                               | 否     | true        |
| top_img    | 页面顶部图片                                                | 否     | -           |
| mathjax    | 显示mathjax（当设置mathjax的per_page: false时，才需要配置）  | 否     | false       |
| katex      | 显示katex（当设置katex的per_page: false时，才需要配置）      | 否     | false       |
| aside      | 显示侧边栏（默认为true）                                     | 否     | true        |
| highlight_shrink | 配置代码框是否展开（true/false）（默认为设置中highlight_shrink的配置） | 否     | -           |

---

Hexo分类多层级

1. 父子分类

   categories:
   - Diary
   - Life

   会使分类Life成为Diary的子分类，而不是并列分类

2. 并列+子分类
   为文章添加多个分类，尝试一下list的方法

   categories:
   - [Diary, PlayStation]
   - [Diary, Games]
   - [Life]

   此时这篇文章同时包括三个分类： PlayStation 和 Games 分别都是父分类 Diary 的子分类，同时 Life 是一个没有子分类的分类

---

Hexo常用操作命令

---

Hexo+Obsidian高可用搭建说明

图片保存

图片保存在Obsidian有自己的语法，要实现既可以在Ob上预览又可以在博客上显示出来需要一系列的设置

1. Ob上安装插件
   
2. 配置Ob相关设置
   
   
3. 安装插件hexo-asset–image

npm install hexo-asset-image --save

4. 修改_config.yml
   修改下列属性为true

post_asset_folder: true

以上步骤完成之后便可以正常使用
每次在Ob中保存图片便会生成如下格式路径

---

编辑器使用转型经验

• Obsidian

适合编辑文本，编辑体验比vscode好
缺点是不适合插入图片，无法设置子分类，无法自动生成时间
使用简介，各种键入反应快捷

• Vscode，

可以插入图片，可以设置子分类
缺点是编辑体验不如Obsidian好，预览显示有卡顿

压缩插件

①Hexo-all-minifier

MD地址

Fluid主题

Tag插件

{% note success %}
文字 或者 `markdown` 均可
{% endnote %}

可选标签：

primary

secondary

success

danger

warning

info

light

行内标签

{% label primary @text %}

可选标签：

text text text text text text

折叠块

使用折叠块，可以折叠代码、图片、文字等任何内容，你可以在 markdown 中按如下格式：

{% fold info @title %}
需要折叠的一段内容，支持 markdown
{% endfold %}

info: 和行内标签类似的可选参数 title: 折叠块上的标题

按钮

{% btn url, text, title %}

url：跳转链接
text：显示的文字
title：鼠标悬停时显示的文字（可选）

text

组图

{% gi total n1-n2-... %}
  ![](url)
  ![](url)
  ![](url)
  ![](url)
  ![](url)
{% endgi %}

total：图片总数量，对应中间包含的图片 url 数量
n1-n2-…：每行的图片数量，可以省略，默认单行最多 3 张图，求和必须相等于 total，否则按默认样式

如{% gi 5 3-2 %} 示例，代表共 5 张图，第一行 3 张图，第二行 2 张图。

---

优秀Hexo示范（Stun）主题

Case 1 向往的博客

Case 2 stum主题作者的

Case 3 路人

Case 4 路人

Case 5 清河的博客

Case6 君匡文集

Hexo运行报错合集

AssertionError [ERR_ASSERTION]: The expression evaluated to a falsy value:

• 原因：
  
• 一开始我在网上搜索解决方法看到这句话，只有一个相关答案，我就在想有没有可能是转义错误，然后我测试了多个环节发现：
• 
• 如果我在最外层加这种反单引号会导致报AssertionError [ERR_ASSERTION]: The expression evaluated to a falsy value:的错，我如果去掉单引号就变成了上面别人说的那种转义的错误，所以我就把这一整个删了发现正常了。
• 后面我发现，好像是因为分割线紧贴了这句话导致这句话格式变了，不再是正文格式，中间多留一行就能解决
• 对于这种小错误我也是真无奈，还好从坑里爬出来了，下次注意！

Hexo配合MarkdownloadImage使用

跳转快捷键 Ctrl Shift O
配置在D盘Software MarkdownloadImage里面备份了一份