By

简单将我搭建Hexo博客的过程记录下来。

1. 前提条件

  • GitHub账号
  • 名为usrname.github.io的repo
  • 安装Node.js
  • 安装git

2. 安装Hexo

首先利用npm来安装Hexo：

$ npm install -g hexo-cli
$ npm install hexo --save

安装完之后，创建博客文件夹：

$ hexo init hysic-blog
$ cd hysic-blog
$ npm install

3. 配置Hexo

打开根目录下的_config.yml对Hexo进行设置。我主要修改了title、subtitle、author、language、url、theme和deploy，前5个的功能很容易理解，主题（theme）是Hexo很重要的东西，相当于一系列css和js的组合，博客的颜值全靠它。

3.1 选择主题（theme）

我目前选择的主题是Jacman，Hexo官网上给出了14个主题，这个知乎问题下面有很多推荐的主题，我就是在这里发现Jacman的（虽然Hexo主页上也有）。首先下载Jacman主题：

$ git clone https://github.com/wuchong/jacman.git themes/jacman

下载完成后将_config.yml中的theme设置成jacman即可。

注意：修改_config.yml时，冒号:后面一定要加一个空格。

3.2 配置Jacman主题

打开/themes/jacman/目录下的_config.yml文件，对Jacman主题进行设置。我目前只改了author_img和Author information中的几项，等以后参照Jacman配置指南继续设置。

4. 撰写博文

创建新博文：

$ hexo new blog-name

在\source\_posts目录下生成blog-name.md的文件，md文件采用Markdown语法，我正在参考知乎这个问题下面的回答学习中。

5. 本地查看

$ hexo server

可以在http://localhost:4000/本地查看博客。

6. 部署Hexo

部署就是把你写的博文和你选择的主题发布到你在互联网上的个人博客中。首先要在根目录_config.yml文件中设置部署方式：

deploy: 
  type: git
  repository: git@github.com:hysic/hysic.github.io.git
  branch: master

然后安装Hexo的git deployer：

$ npm install hexo-deployer-git --save

最后一步部署：

$ hexo generate
$ hexo deploy

以上两步可以简写成hexo g和hexo d。期间需要输入GitHub账号和密码，提示INFO Deploy done: git说明部署完成，可以把hysic.github.io
这个博客地址告诉自己的亲朋好友了。

7. 搭建Tips

  • 首先要知道Hexo有3.x和2.x的区别，Hexo官网给的应该是Hexo 3.x的安装教程，但网上很多教程都是基于Hexo 2.x的，所以步骤可能会有一些不同。

  • 安装和配置过程不可避免会有一些报错，重点是不要慌，相信李笑来老师那句“你并不孤独。”，把报错内容放到google搜索框中，回车，解决方法很可能就出现了。

  • 如果遇到莫名其妙的问题，先删除根目录的.deploy_git文件夹，再执行hexo clean && hexo g && hexo d命令清除缓存文件重新生成静态文静并部署。