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分类多层级
- 父子分类
categories:
- Diary
- Life
会使分类Life成为Diary的子分类,而不是并列分类
- 并列+子分类
为文章添加多个分类,尝试一下list的方法
categories:
- [Diary, PlayStation]
- [Diary, Games]
- [Life]
此时这篇文章同时包括三个分类: PlayStation 和 Games 分别都是父分类 Diary 的子分类,同时 Life 是一个没有子分类的分类
Hexo常用操作命令
Hexo+Obsidian高可用搭建说明
图片保存
图片保存在Obsidian有自己的语法,要实现既可以在Ob上预览又可以在博客上显示出来需要一系列的设置
-
Ob上安装插件
-
配置Ob相关设置
-
安装插件hexo-asset–image
npm install hexo-asset-image --save
- 修改_config.yml
修改下列属性为true
post_asset_folder: true
以上步骤完成之后便可以正常使用
每次在Ob中保存图片便会生成如下格式路径
编辑器使用转型经验
- Obsidian
适合编辑文本,编辑体验比vscode好
缺点是不适合插入图片,无法设置子分类,无法自动生成时间
使用简介,各种键入反应快捷
- Vscode,
可以插入图片,可以设置子分类
缺点是编辑体验不如Obsidian好,预览显示有卡顿
压缩插件
①Hexo-all-minifier
Fluid主题
Tag插件
{% note success %}
文字 或者 `markdown` 均可
{% endnote %}
可选标签:
{% note primary %}
primary
{% endnote %}
{% note secondary %}
secondary
{% endnote %}
{% note success %}
success
{% endnote %}
{% note danger %}
danger
{% endnote %}
{% note warning %}
warning
{% endnote %}
{% note info %}
info
{% endnote %}
{% note light %}
light
{% endnote %}
行内标签
{% label primary @text %}
可选标签:
{% label primary @text %}
{% label default @text %}
{% label info @text %}
{% label success @text %}
{% label warning @text %}
{% label danger @text %}
折叠块
使用折叠块,可以折叠代码、图片、文字等任何内容,你可以在 markdown 中按如下格式:
{% fold info @title %}
需要折叠的一段内容,支持 markdown
{% endfold %}
info: 和行内标签类似的可选参数 title: 折叠块上的标题
按钮
{% btn url, text, title %}
url:跳转链接
text:显示的文字
title:鼠标悬停时显示的文字(可选)
{% btn url, text, title %}
组图
{% gi total n1-n2-... %}
![](url)
![](url)
![](url)
![](url)
![](url)
{% endgi %}
total:图片总数量,对应中间包含的图片 url 数量
n1-n2-…:每行的图片数量,可以省略,默认单行最多 3 张图,求和必须相等于 total,否则按默认样式
如{% gi 5 3-2 %}
示例,代表共 5 张图,第一行 3 张图,第二行 2 张图。