Github + hexo建站小结

本文简单对基于Github Pages和hexo搭建个人博客站点进行总结，欢迎提出意见和反馈。

安装node.js和Git

安装node.js
参考Mac上安装node.js小结一文
安装Git
1
brew install git

安装hexo

初始化博客

本文假定博客存放目录名称为blog（下同）

1	hexo init blog

安装npm

1 2	cd blog npm install

检查是否成功

1 2	hexo g hexo s

浏览器打开http://localhost:4000，看到以下页面

关联Github

登录您的 GitHub 账号，新建名称为您的用户名.github.io的仓库。假设我的 GitHub 账号的用户名是 test，那么我就应该新建名称为test.github.io的仓库。
Description可写可不写，随意。
勾上Initialize this repository with a README。
点击Create Repository完成创建。

开启Github Pages

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

修改全局配置文件

本地blog文件夹下_config.yml，打开后滑到最后，修改成下边的样子：

deploy:
  type: git
  repository: https://github.com/xxx/xxx.github.io.git
  branch: master

发布

hexo d

常见指令

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

常用组合

1
2
3

hexo clean
hexo g
hexo d

发布文章

终端cd到博客文件夹下，执行如下命令新建文章：

1	hexo new "xxx"

名为xxx.md的文件会建在目录…/博客目录名/source/_posts下。

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

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

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

1 2	hexo g hexo d

至此，Mac 上搭建基于 GitHub Pages + Hexo 的博客就完成了。