hexo 使用

记录 hexo 相关内容

tag：关键词 categories:

软件工具：介绍新发现的好用工具
折腾：做的一件事
网络：路由器，openwrt，软路由

开始教程 (start guide)¶

安装¶

TODO

基本命令¶

命令列表

hexo new [layout] <title>

hexo server -p 5000
hexo server -i 192.168.1.1 # 默认绑定0.0.0.0

hexo generate
hexo generate --deploy  #或者 hexo deploy --generate

hexo deploy

创建新文档¶

hexo new [layout] <title>

layout 可以理解为模板，创建时使用scaffolds目录下对应名称 md 文件创建新文档。
默认有三种 layout：post, draft, page
默认 layout 为post，文件名格式在 config 文件中new_post_name指定

书写¶

头部元数据¶

front-matter 为文本头部元素据，使用 yaml 或 json 格式。

常用设置：

title
date: 文件创建日期
updated: 文件更新日期
tags, categories: 对于page无效
- 多个 tag 表示方法

tags:
- openwrt
- vlan
- 软路由

其它¶

如何提供静态资源¶

可以将图片、css、代码文件等静态资源放在source/目录下。如：一种显示图片方式为，将图片放在source/images目录，然后通过![](../../images/image.jpg)显示（注意需要根路径）。
也可以开启post_asset_folder: true，每次创建 post 时，会自动创建一个对应 asset 目录。不过我图片使用图床，因此基本用不上。

如何引用其它 post¶

由于 hexo 支持 markdown, jsp 等多种文档格式。为了支持统一的特性，引入了 Tag plugin（非 post tag 含义），支持常见的排版格式，如块引用、代码块、Youtube 视频等。

链接到其它文章格式如下：

{% post_path filename %}  
{% post_link filename [title] [escape] %}

tag 和 categories¶

开启¶

创建 page 使用如下命令，hexo 会创建source/tags和source/categories两个目录
```
hexo new page categories  
hexo new page tags
```
修改其中 index.md 文件，比如对于 tag
```
---
title: 标签  
date: 2018-10-10 12:21:48  
type: "tags"  
---
```
设置_config.yaml中目录
```
tag_dir: tags
category_dir: categories
```
设置主题_config.yaml中设置

yaml menu: home: / || home #about: /about/ || user tags: [/tags/ || tags] categories: /categories/ || th

多个 tag¶

tags: [ ]
- PS5
- Switch
- Xbox S

多个 category¶

hexo 默认同级 category 只能有一个

如果您有过使用 WordPress 的经验，就很容易误解 Hexo 的分类方式。WordPress 支持对一篇文章设置多个分类，而且这些分类可以是同级的，也可以是父子分类。但是 Hexo 不支持指定多个同级分类

如下设置会导致 Life 位于 Diary 级别下面

categories:  
  - Diary  
  - Life

需要如下设置

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

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