什么是Hexo?

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

本地环境搭建

Hexo 文档有对 Hexo 安装及使用的详细介绍，推荐阅读。这里我主要写自己安装的步骤、踩过的坑以及一些优化的方法。在正式安装 Hexo 之前，我们需要确认电脑中是否已安装下列应用程序:

1
2
Node.js
Git

安装Node.js

安装Git

通过命令以下三条命令检查是否安装成功。

1
2
3
node –v
npm –v
git –version


注意在git bash中应该输入git version

本地生成Hexo

所有必备的应用程序安装完成后，即可使用 npm 安装 Hexo。

Hexo就是我们的个人博客网站的框架，这里需要自己在电脑常里创建一个文件夹，可以命名为Blog，Hexo框架与以后你自己发布的网页都在这个文件夹中。创建好后，进入文件夹中，按住shift键，右击鼠标点击Git Bash Here进入git:

输入npm install -g hexo-cli，开始安装Hexo。

初始化

1
hexo init

使用终端cd到blog文件夹下，执行以下命令，安装npm：

1
npm install

接下来我们检验一下是否配置成功。接着输入：

1
hexo g

好了，现在可以试试看是否已经初始化成功，执行如下命令，开启本地 Hexo 服务器：

1
hexo s

出现下列提示

1
2
INFO Start processing
INFO Hexo is running at http://localhost:4000/. Press Ctrl+C to stop.

此时，浏览器中打开网址(默认是4000端口) http://localhost:4000 ，能看到如下页面

这目前为止，Hexo在本地配置已经全都结束了。

申请并配置Github账户

创建并配置自己的Github账户

打开Github网站:

如果还没有注册账号的按步骤注册一个账号，填写邮箱，用户名，密码提交之后，登录邮箱验证一下即可，然后进入账户。

选择Start a project

注 ： 这里创建的仓库名称必须为 username.github.io，username 替换成你的 github 用户名，每个账户有且只有一个仓库用来存放网页静态文件，这里名称是固定的。当创建其他仓库的时候，仓库名称可以自定义。

点击Create repository 创建仓库后会出现两个地址：

这里有两个地址，一个是 Https，一个是 SSH 。Https 每次提交都需要输入用户名和密码，SSH 只要添加了 SSH key 值，以后提交不需要输入用户名和密码。

创建成功后到这里你的Github账号就基本配置好了，打开github网址可以看到已经显示了。

将GitHub与本地环境搭建

开启 GitHub Pages
点击Settings，你将会打开这个库的 Settings 页面，向下拖动，直到看见 GitHub Pages，如图：

修改全局配置文件

Hexo 官方文档中有对全局配置的详细说明，推荐阅读。
小坑提醒，修改本地所有的配置文件时，注意所有的冒号:后边都要加一个空格，否则执行 Hexo 命令时会报错，一定注意。
找到本地blog文件夹下_config.yml，打开后滑到最后，修改成下边的样子：

1
2
3
4
deploy:
  type: git
  repository: https://github.com/xxx/xxx.github.io.git
  branch: master

你需要将repository后的所有xxx换成你自己的用户名，或者也可以在下图位置获取:

然后，您需要为自己配置身份信息，终端输入yourname和youremail换成您自己的 GitHub 用户名和邮箱：

1
2
git config --global user.name "yourname"
git config --global user.email "youremail"

生成ssh密钥文件：

1
ssh-keygen -t rsa -C " youremail "

然后直接三个回车即可，默认不需要设置密码
然后找到生成的.ssh的文件夹中的id_rsa.pub密钥，将内容全部复制

打开GitHub_Settings_keys 页面，新建new SSH Key

Title为标题，任意填即可，将刚刚复制的id_rsa.pub内容粘贴进去，最后点击Add SSH key。
在Git Bash中检测GitHub公钥设置是否成功，输入 ssh git@github.com ：

终端cd到blog文件夹下执行生成静态页面命令：

1
hexo g

尝试执行命令：

1
npm install hexo --save

若无报错，自行忽略此步骤。
然后在当前目录下，终端输入：

1
hexo d

这里踩了个坑，如果您执行命令hexo d仍然报错：无法连接 git 或找不到 git，则执行如下命令来安装hexo-deployer-git：

1
npm install hexo-deployer-git –save

完成安装之后，再次执行hexo g和hexo d命令。

随后按照提示，分别输入自己的 GitHub 用户名和密码，开始上传。
完成上传之后，通过http://xxx.github.io/ (xxx换成您自己的仓库名，也就是用户名)来访问自己刚刚上传的网站。

常用指令和发布文章

• 常用指令

1
2
3
4
5
hexo new "postName"        //新建文章
hexo new page "pageName"        //新建页面
hexo g          //生成静态页面至public目录
hexo server         //开启预览访问端口（默认端口4000，'ctrl + c'关闭server）
hexo deploy         //将.deploy目录部署到GitHub

• 常用组合

1
2
3
4
5
hexo clean
hexo g
hexo d
hexo d -g #生成部署
hexo s -g #生成预览

• 发布文章
终端cd到blog文件夹下，执行如下命令新建文章：

1
hexo new "xxx"

名为xxx.md的文件会建在目录…/blog/source/_posts下。
所有的文章都会以md形式保存在_post文件夹中，只要在_post文件夹中新建md类型的文档，就能在执行hexo g的时候被渲染。新建的文章头需要添加一些信息，如下所示：

1
2
3
4
title: xxx    //在此处添加你的标题。
date: 2019-6-xx 13:38:49   //在此处输入编辑这篇文章的时间。
tags: xxx    //在此处输入这篇文章的标签。
categories: xxx    //在此处输入这篇文章的分类。

文章编辑完成后，终端cd到blog文件夹下，依次执行如下命令来发布：

1
2
hexo g
hexo d

至此,搭建基于 GitHub Pages + Hexo 的博客就完成了