前段时间萌发自己搭建博客的念头，冲动之下买了个云服务器，奈何个人对html的东西实在不通，折腾了几天，blog依然丑的可以。后来无意间看见在github上可以搭建个人blog，就用谷歌折腾该如何在github上搭建blog，奈何网上很多教程都过于古老，或者很多细节都含糊不清，导致爬了好几天几天坑，才blog搭建了起来。

成功搭建的hexo网站

我的hexo网站

如何在github上搭建blog

本文分为三个部分:

• 本地环境搭建
• github 部署
• hexo 与github关联

需要的的原料

• git
• github 账号
• node js
• hexo
• 个人域名(可选)

本地环境搭建

1. 安装git

https://www.git-scm.com/download/win

选择你需要的版本，一路默认安装便可

2. 安装node js

• 32位下载地址

https://nodejs.org/dist/v4.2.3/node-v4.2.3-x86.msi

• 64位下载地址

https://nodejs.org/dist/v4.2.3/node-v4.2.3-x64.msi

下载完成后双击安装，不做任何操作，一直默认下去便可。

3. 安装完成后win+R调出CMD命令，输入node -v，校验是否安装成功，如果出现以下信息，则表示安装成功</br>
   
   node js安装成功
4. 安装完成node js后，在任意目录下打开cmd命令窗口，输入以下命令来安装hexo

npm install -g hexo

如果出现以下信息，则表示hexo安装成功</br>

hexo 安装成功

5. 接着输入以下命令添加git依赖</br>
   注意：</br>

• 该命令必须在hexo g 之前完成
• 部署这个命令一定要用git bash，否则会提示Permission denied (publickey).

 npm install hexo-deployer-git --save

如果出现以下信息，则表示hexo git依赖安装成功

hexo git 依赖安装成功

6. 创建hexo工程
   在任意盘符中创建一个文件夹，把它命名为hexo，打开该文件夹，在该目录下打开cmd，输入以下命令

hexo init

hexo 便自动创建了一个项目，目录结构如下:

hexo目录结构

7. 现在在cmd命令下输入以下命令

hexo server -p 5001

如果出现以下信息，表示你已经生成了hexo工程。

hexo工程生成成功

</br>
现在，是时候在浏览器中展示你的成果了，在浏览器地址栏中，输入以下地址，如果出现以下页面，该页面便是你以后的blog的预览效果。

http://localhost:5001/

效果

github部署

如果以上的网页能正常显示，那么恭喜你，本地环境搭建已经基本完成，现在是时候将hexo部署到github上了，将hexo部署你还需要完成几个步骤：

1. 创建一个github账号

2. 创建一个新的软件仓库，名称格式必须为：github的用户名.github.io。</br>
   如：我的github用户名为：AriaLyy，那么该软件仓库的名必须为: AriaLyy.github.io</br>
   最终软件仓库如下：
   

   hexo软件仓库

3. 现在点击Settings，往下拉，如果你看见下图的信息 Your site is published at http://AriaLyy.github.io/
   

   github网站生成
   
   只要出现可以点击的网络地址，那么表示github已经成功帮你自动生成一个静态网站了。

4. 创建github ssk公钥
   在任意目录打开CMD，输入以下命令创建git ssh公钥，一路回车下去便可

ssh-keygen -t rsa -C "key_name"

接着讲ssh公钥添加到github中。</br>
ps:如果你碰到ssh-keygen不是内部命令，那么你需要将git安装目录下的Git\usr\bin路径设置在环境变量中。

hexo 已github关联

如果你已经完成了以上的步骤，那么你离成功只剩下一步之遥。</br>
还记得我们的hexo工程，以及*.github.io的软件仓吗？</br>
打开该文件，找到_config.yml文件，用文本编辑器打开，找到deploy字段，添加以下信息

deploy:
  type: git
  repository: git@github.com:AriaLyy/AriaLyy.github.io.git # 这个配置为你*.github.io软件仓库clone地址
  branch: master  #分支为master分支

这里有几点需要注意：

• 每个参数，冒号后面，必须要有一个空格！！！！！！
• repository 参数需要 ssh 的clone地址
• branch 分支需要是master分支

如果你已经配置好以上步骤，接下来在hexo文件夹下打开cmd，输入以下命令，将hexo工程部署到github上。</br>

hexo d -g

注意：部署这个命令一定要用git bash</br>
如果一切顺利，那么将会出现类似于下面的成功提示信息

hexo github关联成功

那么在浏览器地址上输入:你的*.github.io软件仓库的名称，将会打开你的blog。

效果

如果一切顺利，请尽情享受你的喜悦吧。

这是我在github上创建的个人blog，点击我