一、前言

　　前两天，机缘巧合，看到小士刀的博客,非常喜欢，于是就萌生了做个人博客的想法，作为一个小白，一开始照着网上的各种教程去搭建的时候，还是云里雾里的。记得几个月前刚接触GitHub（哈哈，对大四来说确实有点晚），对版本控制一点概念都没有，更别说使用GitHub　Page能做出一个好看又好用的博客了。本文主要参考GitHub Pages + Hexo搭建博客。

二、必要配置

2.1 GitHub Pages 仓库

2.1.1 创建对应仓库

　　在自己的GitHub账号下创建一个新的仓库，命名为username.github.io（username是你的账号名)。
在这里，要知道，GitHub Pages有两种类型：User/Organization Pages 和 Project Pages，而我所使用的是User Pages。
简单来说，User Pages 与 Project Pages的区别是：

User Pages 是用来展示用户的，而 Project Pages 是用来展示项目的。
用于存放 User Pages 的仓库必须使用username.github.io的命名规则，而 Project Pages 则没有特殊的要求。
User Pages 将使用仓库的 master 分支，而 Project Pages 将使用 gh-pages 分支。
User Pages 通过 http(s)://username.github.io 进行访问，而 Projects Pages通过 http(s)://username.github.io/projectname 进行访问。

2.2 Git

2.2.1 安装 Git

　　在windows下安装git比较常用的有两种方式：

Git 官方版本的安装
GitHub for Windows

2.2.2 配置 Git

当安装完Git应该做的第一件事情就是设置用户名称和邮件地址。这样做很重要，因为每一个Git的提交都会使用这些信息，并且它会写入你的每一次提交中，不可更改：

$ git config --global user.name "username"
$ git config --global user.email "username@example.com"

对于user.email，因为在GitHub的commits信息上是可见的，所以如果你不想让人知道你的email，可以Keeping your email address private:

在GitHub右上方点击你的头像，选择”Settings”；
在右边的”Personal settings”侧边栏选择”Emails”；
选择”Keep my email address private”。
　　这样，你就可以使用如下格式的email进行配置：

$ git config --global user.email "username@users.noreply.github.com"

2.3 Git 与 GitHub

2.3.1 git与github的区别

　　这里，我们要区分清楚git与github。
git是一个版本控制的工具，而github有点类似于远程仓库，用于存放用git管理的各种项目。

2.3.2 与github建立联系

　　为了能够在本地使用git管理github上的项目，需要进行一些配置，这里介绍SSH的方法。

2.3.2.1 检查电脑是否已经有SSH keys。

$ ls -al ~/.ssh
# Lists the files in your .ssh directory, if they exist

默认情况下，public keys的文件名是以下的格式之一：id_dsa.pub、id_ecdsa.pub、id_ed25519.pub、id_rsa.pub。因此，如果列出的文件有public和private钥匙对（例如id_ras.pub和id_rsa），证明已存在SSH keys。

2.3.2.2 如果没有SSH key，则生成新的SSH key。

$ ssh-keygen -t rsa -b 4096 -C "your_email@example.com"
　　# Creates a new ssh key, using the provided email as a label

之后一路回车即可。

2.3.2.3 向ssh-agent添加key。

首先确保ssh-agent可运行：

# start the ssh-agent in the background
　　$ ssh-agent -s

　　然后添加SSH key：

$ ssh-add ~/.ssh/id_rsa

2.3.2.4 在GitHub添加SSH key。

首先，拷贝key：

clip < ~/.ssh/id_rsa.pub
　　# Copies the contents of the id_rsa.pub file to your cllipboard

　　然后，在GitHub右上方点击头像，选择”Settings”，在右边的”Personal settings”侧边栏选择”SSH Keys”。接着粘贴key，点击”Add key”按钮。最后，测试链接：

$ ssh -T git@github.com
　　# Attempts to ssh to GitHub

如果你看到：

    The authenticity of host 'github.com (207.97.227.239)' can't be established.
RSA key fingerprint is 16:27:ac:a5:76:28:2d:36:63:1b:56:4d:eb:df:a6:48.
Are you sure you want to continue connecting (yes/no)?

就键入：yes。之后将会看到如下信息：

Hi username! You've successfully authenticated, but GitHub does not
　　provide shell access.

2.4 Hexo

2.4.1 安装Hexo

安装Hexo相当简单。在安装之前，必须检查电脑中是否已经安装下列应用程序：
• Node.js
• Git
如果您的电脑中已经安装上述必备程序，那么恭喜您！接下来只需要使用 npm 即可完成 Hexo 的安装。

$ npm install -g hexo-cli

2.4.2 使用Hexo建站

安装完后，在你喜欢的文件夹内（例如D：\Hexo），点击鼠标右键选择Git bash，输入以下指令：

$ hexo init

该命令会在目标文件夹内建立网站所需要的所有文件。接下来是安装依赖包：

$ npm install

这样，我们就已经搭建起本地的Hexo博客了。可以先执行以下命令（在对应文件夹下），然后再浏览器输入localhost:4000查看。

$ hexo generate
　　$ hexo server

这个博客只是本地的，别人是浏览不了的，之后需要部署到GitHub上。

三、一般的搭建方法

在上面，我们已经配置好了所需的所有东西，也成功地搭建了一个本地Hexo博客。现在，需要使用GitHub Pages搭建一个别人能够访问的Hexo博客了。

3.1 使用默认theme

我们继续使用上面的文件夹D:\Hexo（也可以新建一个文件夹重新生成），然后编辑该文件夹下的_config.yml。
默认生成的_config.yml：

    # Deployment
　　## Docs: http://hexo.io/docs/deployment.html
deploy:
  type:

修改后的_config.yml：

  deploy:
type: git
repo: 对应仓库的SSH地址（可以在GitHub对应的仓库中复制）
branch: 分支（User Pages为master，Project Pages为gh-pages）

为了能够使Hexo部署到GitHub上，需要安装一个插件：

$ npm install hexo-deployer-git --save

然后，执行下列指令即可完成部署：

$ hexo generate
　　$ hexo deploy

之后，可以通过在浏览器键入：username.github.io进行浏览，开心吧~

3.2 其他theme

如果想要使用其他主题，可以使用git clone将别人的主题拷贝到D:\Hexo\themes下，然后将_config.yml中的theme: landscape改为对应的主题名字。
详细步骤可以参考网上的指南。
主题安装
萝卜白菜各有所爱，玩博客换主题是必不可少的，hexo的主题列表Hexo Themes。
我比较喜欢pacman，modernist、ishgo，raytaylorism。Pacman最为优秀，简洁大方小清新，
同时移动版本支持的也很好，但作者并没有把很多参数分离出来给出可配置项，我最终选择了modernist。

安装主题的方法就是一句git命令：

$ git clone https://github.com/iissnan/hexo-theme-next.git themes/next

目录是否是next无所谓，只要与_config.yml文件一致即可。

安装完成后，打开hexo_config.yml，修改主题为next

theme: next

打开hexo\themes\next目录，编辑主题配置文件_config.yml：

menu: #配置页头显示哪些菜单

Home: /
Archives: /archives
Reading: /reading
About: /about

Guestbook: /about
excerpt_link: Read More #摘要链接文字
archive_yearly: false #按年存档
widgets: #配置页脚显示哪些小挂件

category
- tag

tagcloud

recent_posts
- blogroll
blogrolls: #友情链接

bruce sha’s duapp wordpress: http://ibruce.duapp.com

bruce sha’s javaeye: http://buru.iteye.com

bruce sha’s oschina blog: http://my.oschina.net/buru

bruce sha’s baidu space: http://hi.baidu.com/iburu
fancybox: true #是否开启fancybox效果
duoshuo_shortname: buru #多说账号
google_analytics:
rss:

更新主题

cd themes/next
git pull

四、优化部署与管理

4.1 概述

Hexo部署到GitHub上的文件，是.md（你的博文）转化之后的.html（静态网页）。因此，当你重装电脑或者想在不同电脑上修改博客时，就不可能了（除非你自己写html o(^▽^)o ）。
其实，Hexo生成的网站文件中有.gitignore文件，因此它的本意也是想我们将Hexo生成的网站文件存放到GitHub上进行管理的（而不是用U盘或者云备份啦(╬▔皿▔)凸）。这样，不仅解决了上述的问题，还可以通过git的版本控制追踪你的博文的修改过程，是极赞的。
但是，如果每一个GitHub Pages都需要创建一个额外的仓库来存放Hexo网站文件，我感觉很麻烦（10个项目需要20个仓库(ˉ▽ˉ；)…）。
所以，我利用了分支！！！
简单地说，每个想建立GitHub Pages的仓库，起码有两个分支，一个用来存放Hexo网站的文件，一个用来发布网站。
下面以我的博客作为例子详细地讲述。

4.2 我的博客搭建流程

创建仓库，CrazyMilk.github.io；
创建两个分支：master 与 hexo；
设置hexo为默认分支（因为我们只需要手动管理这个分支上的Hexo网站文件）；
使用git clone git@github.com:CrazyMilk/CrazyMilk.github.io.git拷贝仓库；
在本地CrazyMilk.github.io文件夹下通过Git bash依次执行npm install hexo、hexo init、npm install 和 npm install hexo-deployer-git（此时当前分支应显示为hexo）;
修改_config.yml中的deploy参数，分支应为master；
依次执行git add .、git commit -m “…”、git push origin hexo提交网站相关的文件；
执行hexo generate -d生成网站并部署到GitHub上。
这样一来，在GitHub上的CrazyMilk.github.io仓库就有两个分支，一个hexo分支用来存放网站的原始文件，一个master分支用来存放生成的静态网页。完美( •̀ ω •́ )y！

4.3 我的博客管理流程

4.3.1 日常修改

在本地对博客进行修改（添加新博文、修改样式等等）后，通过下面的流程进行管理：

依次执行git add .、git commit -m “…”、git push origin hexo指令将改动推送到GitHub（此时当前分支应为hexo）；
然后才执行hexo generate -d发布网站到master分支上。
虽然两个过程顺序调转一般不会有问题，不过逻辑上这样的顺序是绝对没问题的（例如突然死机要重装了，悲催….的情况，调转顺序就有问题了）。

4.3.2 本地资料丢失

当重装电脑之后，或者想在其他电脑上修改博客，可以使用下列步骤：

使用git clone git@github.com:CrazyMilk/CrazyMilk.github.io.git拷贝仓库（默认分支为hexo）；
在本地新拷贝的CrazyMilk.github.io文件夹下通过Git bash依次执行下列指令：npm install hexo、npm install、npm install hexo-deployer-git（记得，不需要hexo init这条指令）。

一、 前言

二、 必要配置