使用Github Pages + Hexo搭建博客（一）—— 配置git、Hexo

一直想要搭建一个博客，但一直没有付诸实施，抽了一个周末的时间捣鼓了一下github pages+Hexo的博客搭建方式，也算完成的一个并不完美的成品。本文基于官方文档，同时记录了我遇到的一些问题，下面就和大家分享我的搭建过程。

适用于mac环境的搭建

安装Git

在mac上安装git有两种方式，最快的方式便是使用homebrew，具体方式可以参见brew文档。也可以直接从AppStore安装Xcode，在Xcode->Preferences中选择Downloads，选择Command Line Tools即可。

安装完成后，在终端输入git —version指令查看是否安装成功。

安装Node.js

同样有两种方式安装Node.js。

第一种依旧是使用homebrew安装，使用如下命令安装：

brew link node

brew uninstall node

brew install node

第二种是通过安装包安装，在官网下载node的pkg安装包，并且额外安装npm即可。

安装完成后，在终端输入npm -v、node -v查看是否安装成功。

什么是Hexo

官方文档这样介绍Hexo：

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

在Jekyll和Hexo中，我最终选择了Hexo，当看到Hexo和Next的文档时，我便决定了使用Hexo，扁平化设计的网站和详细的文档有着无穷的吸引力。

安装Hexo

必须在git和Node.js安装完成的情况下才能安装Hexo。

在完成上述安装后，只需使用简单地npm指令就能够完成安装

npm install -g Hexo-cli

安装完成后，执行以下命令

Hexo init 'your folder name'

cd 'your folder name'

npm install

执行完毕后，您将在目录下看到这样的结构：

.
├── _config.yml
├── package.json
├── package-lock.json
├── node_modules
├── scaffolds
├── source
└── themes

在之后的文章中，我将介绍Hexo的文件结构等内容。

启动Hexo server

执行下列命令

Hexo s

正常情况下，启动过程完成后，使用浏览器访问http://127.0.0.1:4000 便能够看到一个Hello World博客页面。如果没有出现页面，可能是因为您电脑的4000端口被占用了，此时使用Hexo s -p port命令修改默认端口，再将4000修改为您设置的端口便能够进行访问。

创建属于自己的github pages

第一步，我们需要创建一个属于自己的github帐号。Github官网链接

第二步，点击new repository创建一个新的仓库：

填写repository name时，格式必须为yourname.github.io，并且需要与您的用户名相同，否则会报404错误。

在创建完repository后，可以在库中先创建一个hello.html来，通过访问https://yourname.github.io 来检验您的github pages能否正常访问。

部署本地文件到Github

首先要安装Hexo-deployer-git

npm install Hexo-deployer-git —save

打开根目录下的站点配置文件_config.yml，在文件中添加如下内容，或者覆盖文件最后的deploy属性：

deploy:
 type: git
 repo: https://github.com/yourname/yourname.github.io.git
 branch: master

完成以上配置后，使用如下命令进行部署：

Hexo clean
Hexo g
Hexo d

也可以创建一个脚本文件commit.sh来简化操作。

结语

如果没有发生错误，此时您便可以在浏览器中输入您的主页地址https://yourname.github.io查看到已经搭建完成的博客了，在后续的文章中，我将会介绍如何写作、如何使用Next主题（而不是默认的landscape）、配置站点文件以及集成第三方应用等方面的内容。