如何使用hexo+github建立自己的博客

利用hexo和github搭建自己的博客网站并不复杂，只需follow以下3个steps：

创建github.io page
搭建本地hexo环境
将github.io page与hexo关联起来

一、创建github.io page

1. 首先要有github账号，没有的话去github.com注册一个。

github是一个基于git的web协作社区。

2. 在github上创建一个特殊的repository

特殊在哪呢？这个repo的名字格式被要求为这样：”[your-github-account-name].github.io” 。
例如我的账号名是’yc111’，那我的这个repo就是 yc111.github.io 。
注意：一定要用你的github账号名加上 .github.io 这一整串作为这个 repository 的名字，不能是其他名字，否则不会生成github.io根域名的page。
关于这个，在这里User, Organization, and Project Pages可以看到更详细的解释。

3. 向第2步创建的仓库任意上传一份文件

主要用于初始化一下仓库，比如上传一份README.md文件：

cd newRepository
echo "# my github.io page" >> README.md
git init
git add README.md
git commit -m "first commint"
git remote add origin git@github.com:yc111/yc111.github.io.git
git push -u origin master

如果是首次使用github，需要先设置一下用户名和邮箱，以及配置SSH key，最好再将传输协议设置为git协议。

4. 验证 github.io page 是否创建成功

进入 github 中该 repository 的 settings 页面，滚动到 Github Page 处，可以看到 “your site is published at https://yc111.github.io/
进入浏览器，输入 https://yc111.github.io ，页面出来了，显示 “my github.io page” 。
说明 github.io page 创建成功。

二、搭建本地hexo环境

Hexo是一个高效的静态网站生成框架。通过hexo，可以轻松使用markdown编辑文章。

1. Hexo是基于node.js的，所以首先要安装node.js。

去node官网下载最新版，然后安装。

2. 在本地创建一个文件夹，用于存放hexo工程。

为便于描述，假设创建的文件夹命名为：blog。

3. 安装hexo（全局安装）。

1	npm install hexo -g

4. 初始化hexo。

hexo init

5. 生成静态页面

1	hexo generate

6. 本地启动

1	hexo server

如果看到 “INFO Hexo is running at http://localhost:4000/. Press Ctrl+C to stop.” ，说明启动成功。

7. 打开本地博客网址，验证hexo环境。

在浏览器打开 localhost:4000 ，可以看到hexo自动生成的 hello world 页面，hexo环境搭建成功！

三、将 github.io page 与 hexo 关联起来

在blog目录下有一个 _config.yml 文件，它是hexo的站点配置文件，要将 github.io 与 hexo 关联起来，首先要配置 _config.yml 里的 deploy 字段。

1. 编辑 `_config.yml` 配置`deploy` 字段。

1	vim _config.yml

翻到最下面，将deploy字段的值配置如下：

deploy:
  type: git
  repo: git@github.com:yc111/yc111.github.io.git
  branch: master

注：vim进入编辑的命令为i，退出编辑模式的方法为按ESC键，按:号进入命令模式，保存并退出命令为wq。

2. 安装hexo的deploy工具。

1	npm install hexo-deploy-git --save

3. 将本地hexo静态网页部署到github上。

1	hexo deploy

当出现 “INFO Deploy done：git” 的时候，说明部署完毕。

4. 验证部署结果

在浏览器打开 yc111.github.io
可以看到本地的hexo博客出现在了 github.io 网站上。
同时，名为 yc111.github.io 的 repository 下可以看到被上传了文件和代码（hexo工程blog目录下的public目录）
说明 github.io page 与 hexo 关联成功！

一些hexo的常用命令

以后要部署新的文章，只需按以下步骤：

1
2
3

hexo clean  #清除缓存，避免一些奇怪的问题
hexo generate
hexo deploy

其他常用命令：

hexo new "newArticleTitle"  #创建文章 可以简写为hexo n
hexo new page "newPageName"  #创建页面
hexo generate  #生成静态页面至public目录 可以简写为hexo g
hexo deploy  #将public目录部署到github 可以简写为hexo d
hexo server  #启动本地服务 可以简写为hexo s
hexo help  #hexo帮助
hexo version  #查看版本信息

组合命令：

1 2	hexo s -g #生成页面并启动本地服务 hexo d -g #生成页面并部署到github

自律是真正的自由