环境准备

  • Windows 10
  • Git
  • NodeJs
  • Gitee 账号
  • Github 账号
  • 域名一个（可选）

本地搭建

在新建的hexo 目录下执行

1.cnpm 安装Hexo

1
2
> cnpm install -g hexo-cli
> cnpm install hexo --save

2.检查Hexo是否安装成功

1
> hexo -v

3.在hexo目录下新建目录hexo-blog，并执行命令

1
2
3
4
5
6
7
8
> hexo init

# node_modules: 依赖包
# public：存放生成的页面
# scaffolds：生成文章的一些模板
# source：用来存放你的文章
# themes：放下下载的主题
# _config.yml: 博客的核心配置文件（设置主体、标题等属性）

4.执行下面命令

1
> cnpm install

5.启动安装好的hexo

1
> hexo s -g

6.访问：http://localhost:4000

安装主题

1.挑选主题

1
> https://hexo.io/themes/

2.已A-Ayer主题为例，在hexo/hexo-blog目录下执行命令：

1
2
3
4
> git clone https://github.com/Siricee/hexo-theme-Chic.git themes/Chic

## 如果很慢的话可在末尾添加 --depth=1
## depth用于指定克隆深度，为1即表示只克隆最近一次commit.

4.修改配置文件_config.xml配置

1
> theme: Chic

5.启动hexo即可

1
> hexo s -g

托管Gitee

1.新建仓库hexo-blog
2.修改_config.yml文件，添加你创建的itee仓库地址

1
2
3
4
5
6
7
8
9
deploy:
  type: git
  repo: https://gitee.com/isspark/hexo-blog.git
  branch: master
  
deploy:
  type: git
  repo: git@github.com:isspark/isspark.github.io.git
  branch: master

3.发布

1
2
3
4
5
# 安装自动部署发布工具
> cnpm install hexo-deployer-git --save
# 发布
> 发布：hexo clean && hexo g && hexo d
# 进入Gitee在仓库，服务->Gitee Pages,采用默认配置，点击更新即可

4.如有样式问题，修改_config.yml中配置

1
2
url: http://isspark.gitee.io/hexo-blog/
root: /blog

托管Github

1.创建GitHub仓库,并命名xxxx.github.io,建议xxxx替换为你Github的账号名
2.配置_config.yml

1
2
3
4
deploy:
  type: git
  repo: git@github.com:isspark/isspark.github.io.git
  branch: master

3.发布

1
2
3
4
5
# 安装自动部署发布工具:
> cnpm install hexo-deployer-git --save
# 发布：
> hexo clean && hexo g && hexo d
# 进入Gitee在仓库，服务->Gitee Pages,采用默认配置，点击更新即可

4.自定义域名

  • 将域名指向GitHub的服务器地址， 192.30.252.153 和 192.30.252.154
  • 进入存放博客的GitHub仓库，点击settings，设置Custom domain，输入www.crazyz.cn
  • 本地博客文件source中创建一个名为CNAME文件，不要后缀。写上内容你的域名
  • 发布：hexo clean && hexo g && hexo d

基本操作

生成标签和分类

1
2
3
4
5
6
7
8
## 生成标签
> hexo new page tags
## 输出
## INFO  Created: ~/Documents/blog/source/tags/index.md
## 生成分类
> hexo new page categories
## 输出
## INFO  Created: ~/Documents/blog/source/categories/index.md

对文章进行分类和添加标签

在文章文件头部添加下列：

1
2
3
4
5
6
7
8
---
categories: 
- Git
tags:
- Git
- 表格
- 表单验证
---

新建文章

1
2
## 执行下面命令，会自动在_posts目录生成文章MD文件，编辑即可
> hexo new post [PostName]

错误

设置了tag和category，但是没有显示出来

1.设置/tags/index.md 和 /categories/index.md如下：

1
2
3
4
5
6
7
8
9
10
11
---
title: tags
type: tags
layout: tag
---

---
title: categories
type: categories
layout: category
---

2.注意，在上文的layout值需要与主题文件夹下的/layout对应的tag和category 后缀ejs文件对应

其他

config.yml配置说明

https://hexo.io/zh-cn/docs/configuration.html