Hexo简介

Hexo 是一个快速、简洁且高效的博客框架。Hexo 使用 Markdown（或其他渲染引擎）解析文章，在几秒内，即可利用靓丽的主题生成静态网页。

官方文档：https://hexo.io/zh-cn/docs/index.html

环境依赖

Node.js (Node.js 版本需不低于 8.10，建议使用 Node.js 10.0 及以上版本)
Git

安装

安装Git

Windows

下载Git并安装

Linux

1 2	sudo apt-get update sudo apt-get install git-core

验证安装：

1	git --version

安装 Node.js

Windows
- 下载Node.js并安装

Linux

1 2	sudo apt install nodejs sudo apt install npm

检查是否安装成功：

1 2	node -v npm -v

设置国内镜像源

1	npm config set registry https://registry.npm.taobao.org

安装Hexo

1	sudo npm install -g hexo-cli

检查是否安装成功：

hexo -v

创建博客

以后命令皆在Git Bash中运行，部分命令需访问github，因此可能因网络原因失败。

创建博客目录（其中folder是博客工程目录）：

1
2
3

hexo init folder
cd folder
sudo npm install --save

启动服务：

1 2	hexo g # 生成 hexo s # 启动

在浏览器输入localhost:4000即可看到生成的博客（若为云服务器，必须在控制台添加防火墙规则）。

创建分类页面

执行命令，创建分类页面：

1	hexo new page categories

得到以下提示：

1	INFO Created: ~/blog/source/categories/index.md

修改该index.md文件，添加type: "categories"：

---
title: categories
date: 2020-02-15 19:36:46
type: "categories"
---

打开scaffolds/post.md文件，添加categories:

---
title: {{ title }}
date: {{ date }}
categories:
tags:
---

创建标签页面

执行命令，创建分类页面：

1	hexo new page tags

得到以下提示：

1	INFO Created: ~/blog/source/tags/index.md

修改该index.md文件，添加type: "tags"：

---
title: tags
date: 2020-02-15 19:41:04
type: "tags"
---

新建文章

执行以下命令创建一篇新文章：

1	hexo new title

系统会在source/_posts/文件夹下生成一个Markdown文件：

1	INFO Created: ~/blog/source/_posts/title.md

打开该文件，内容如下：

---
title: title
date: 2020-02-15 19:20:12
categories:
tags:
---

在这之后撰写自己的文章即可，也可以将已经写好的文章添加以上字段后粘贴至source/_posts/文件夹下。

给文章添加"categories"和"tags"属性

---
title: 搭建Hexo博客
date: 2017-05-26 12:12:57
categories: 
- 环境搭建
  - Hexo
tags:
- Hexo
- 博客
---

注意：Hexo一篇文章只能属于一个分类。如果在“- 环境搭建”下方添加“- Hexo”，Hexo不会产生两个分类，而是把分类嵌套（即该文章属于 “- 环境搭建”下的 “- Hexo ”分类）。

指令

init

1	hexo init [folder]

新建一个网站。如果没有设置 folder ，Hexo 默认在目前的文件夹建立网站。

1	hexo new [layout] title

新建一篇文章。如果没有设置 layout 的话，默认使用站点配置文件 _config.yml中的 default_layout 参数代替。

如果标题包含空格，请使用引号括起来。

1	hexo new "post title with whitespace"

-p, --path 自定义新文章的路径
-r, --replace 如果存在同名文章，将其替换
-s, --slug 文章的 Slug，作为新文章的文件名和发布后的 URL

generate
1
hexo generate
生成静态文件。
- -d, --deploy 文件生成后立即部署网站
- -w, --watch 监视文件变动
- -b, --bail 生成过程中如果发生任何未处理的异常则抛出异常
- -f, --force 强制重新生成文件
- -c, --concurrency 最大同时生成文件的数量，默认无限制
该命令可以简写为
1
hexo g
publish
1
hexo publish [layout] filename
发表草稿。
server
1
hexo server
启动服务器。默认情况下，访问网址为： http://localhost:4000/。
- -p, --port 重设端口
- -s, --static 只使用静态文件
- -l, --log 启动日记记录，使用覆盖记录格式
deploy
1
hexo deploy
部署网站。
- -g, --generate 部署之前预先生成静态文件
该命令可以简写为：
1
hexo d
render
1
hexo render file1 [file2] ...
渲染文件。
- -o, --output 设置输出路径
migrate
1
hexo migrate type
从其他博客系统迁移内容。
clean
1
hexo clean
清除缓存文件 (db.json) 和已生成的静态文件 (public)。

在某些情况（尤其是更换主题后），如果发现您对站点的更改无论如何也不生效，您可能需要运行该命令。
list
1
hexo list type
列出网站资料。
version
1
hexo version
显示 Hexo 版本。
安全模式
1
hexo --safe
在安全模式下，不会载入插件和脚本。当您在安装新插件遭遇问题时，可以尝试以安全模式重新执行。
调试模式
1
h --debug
在终端中显示调试信息并记录到 debug.log。
简洁模式
1
hexo --silent
隐藏终端信息。
显示草稿
1
hexo --draft
显示 source/_drafts 文件夹中的草稿文章。