hexo基本使用指南

Posted on Edited on

关于hexo，我曾在第一篇写过一些基本命令。

打算在这一篇写一些基本用法，其实基本上都可以在官方文档找到。在这里写下只是为了记录一下不断摸索的过程，其中参考了很多其他优秀的博客。

少女摸索中……会不断更新。

基础使用

增加categories分类

hexo n "title" 新建的默认的页面抬头是这样的：

1
2
3
title:
date:
tags:

可以编辑标题、日期、标签和内容，但是没有分类的选项。可以打开scaffolds/post.md文件，在tages:上面加入categories:。

保存后，重新执行hexo n "title"命令，会发现新建的页面里有categories:项了。

scaffolds目录下，是新建页面的模板，执行新建命令时，是根据这里的模板页来完成的，所以可以在这里根据你自己的需求添加一些默认值。

设置Categories

在我们编辑文章的时候，直接在categories:项填写属于哪个分类，但如果分类是中文的时候，路径也会包含中文。
比如分类我们设置的是：

categories: 编程

那在生成页面后，分类列表就会出现编程这个选项，他的访问路径是：

*/categories/编程

如果我们想要把路径名和分类名分别设置，需要怎么办呢？

打开根目录下的配置文件_config.yml，找到如下位置做更改：

1
2
3
4
5
6
7
# Category & Tag
default_category: uncategorized
category_map:
	编程: programming
	生活: life
	其他: other
tag_map:

在这里category_map:是设置分类的地方，每行一个分类，冒号前面是分类名称，后面是访问路径。

可以提前在这里设置好一些分类，当编辑的文章填写了对应的分类名时，就会自动的按照对应的路径来访问。

给文章加标签

在编辑文章的时候，tags:后面是设置标签的地方，如果有多个标签的话，可以用下面两种办法来设置：

1
2
3
4
5
6
7
tages: [标签1,标签2,...标签n]

 tages: 
- 标签1
- 标签2
...
- 标签n

文章保存为草稿

来自于这里

作者是：novnan

  1. 传统建立文章方式

一般我们都会使用 hexo new <title> 来建立文章，这种建立方法会将新文章建立在 source/_posts 目录下。当使用 hexo generate 编译 markdown 文件时，会将其 HTML 结果编译在 public 目录下，之后 hexo deploy 将会把 public 目录下所有文章部署到 GitHub，这是我们熟悉的 Hexo 流程。

这种建立文章方式的缺点是：若我们同时编辑多篇文章，只要其中一篇文章尚未编辑完成，也会随着 hexo deploy 一起部署到 GitHub，也就是 GitHub 可能会看到我们尚未完成的文章。

  1. 建立文章草稿
1
hexo new draft <title>

Hexo 另外提供 draft 机制，它的原理是新文章将建立在 source/_drafts 目录下，因此 hexo generate 并不会将其编译到 public 目录下，所以 hexo deploy 也不会将其部署到 GitHub。

  1. 本机预览草稿
1
hexo S --draft

虽然 hexo generate 不会编译 source/_drafts 目录下的文章，但 Hexo 的 Hexo server 另外提供 --draft 参数，这让我们只要搭配 hexo-browsersync plugins，就可以达到一边编辑 markdown 文章，一边使用浏览器预览的目的。

  1. 将草稿发布为正式文章
1
hexo P <filename>

其中 <filename> 为不包含 md 后缀的文章名称。它的原理只是将文章从 source/_drafts 移动到 source/_posts 而已。

之后的 hexo generate 与 hexo deploy 的用法就完全一样了。

  1. 将文章转为草稿

若日后想将正式文章转为为草稿，只需手动将文章从 source/_posts 目录移动到 source/_drafts 目录即可。

插入图片

  1. 安装插件

cd到你hexo根目录里用cmd执行以下代码

1
npm install hexo-asset-image --save
  1. 打开hexo的配置文件_config.yml，找到 post_asset_folder，把这个选项从false改成true。这样新建文章时，会自动生成和文章名相同的文件夹，这个文件夹专门用于存放文章图片。

更换Hexo博客网页图标

看这里

深入一点

Hexo文件框架

1
2
3
4
5
6
7
8
9
10
.
├── node_modules：#依赖包-安装插件及所需nodejs模块。
├── public  #最终网页信息。即存放被解析markdown、html文件。
├── scaffolds #模板文件夹。即当您新建文章时，根据scaffold生成文件。
├── source  #资源文件夹。即存放用户资源。
|   └── _posts #博客文章目录。
└── themes #存放主题。Hexo根据主题生成静态页面。
├── _config.yml   #网站的配置信息。标题、网站名称等。
├── db.json：#source解析所得到的缓存文件。
├── package.json  # 应用程序信息。即配置Hexo运行需要js包。

Hexo原理

Hexo是一个模板渲染引擎，可以将本地写好的markdown文本渲染为HTML、CSS等前端模板样式，然后推送到GitHub Pages，就可以访问了。