hexo+github搭建博客折腾记

这是我用hexo+GitHub搭建的个人博客
历时两天，趟了无数次坑，终于搭好了，所以这是一篇详细的记录下搭建博客的整个流程的笔记。

以下是正题

首先，什么是hexo？什么是GitHub？
hexo是一款基于Node.js的静态博客框架，可以方便的生成静态网页
GitHub 是一个面向开源及私有软件项目的托管平台，是开源代码库以及版本控制系统
综合起来的意思就是你用hexo生成了一个静态的博客系统网页，再去GitHub上申请一块空间托管这个系统！

---

准备工作

安装node
因为Hexo是一款基于Node.js的静态博客框架，所以我们需要安装好它

安装git
git是必须安装的，它的作用是把本地的hexo内容提交到github上去.

注册一个GitHub账号
作用是用来做博客的远程创库、域名、服务器之类的，注册很简单，我就不用说了。

GitHubpages配置
注册好了之后，看下这个 指南 和 GitHubpages的说明，去创建一个你的名字的空间，这样的 yourname.github.io 关于GitHub的其他配置，网上都有很多教程。
GitHub Pages 用于介绍托管在GitHub的项目，不过，由于他的空间免费稳定，用来做搭建一个博客再好不过了。
每个帐号只能有一个仓库来存放个人主页，而且仓库的名字必须是username/username.github.io，这是特殊的命名约定。你可以通过http://username.github.io 来访问你的个人主页。
这里特别提醒一下，需要注意的个人主页的网站内容是在master分支下的。

---

装hexo

上面的准备工作都做好后，你需要创建一个文件夹，如GitHubblog，这里我创建的文件夹是qxiaomay，在E盘git目录下的E:\git\qxiaomay
然后进入该目录，即qxiaomay，开始安装hexo。先右键打开git bush，执行下面命令：

$ npm install hexo-cli -g

这个过程稍微有一点点久，你可以去旁边玩一盘小游戏喝一杯水。。。
装好之后你可以用 hexo -v 命令查看他的信息，我的hexo如下所示：

hexo: 3.2.2
hexo-cli: 1.0.2
os: Windows_NT 10.0.14393 win32 x64
http_parser: 2.7.0
node: 4.6.0
v8: 4.5.103.37
uv: 1.9.1
zlib: 1.2.8
ares: 1.10.1-DEV
icu: 56.1
modules: 46
openssl: 1.0.2j

这里还有一个坑，就是npm没有反应，这个时候可以去装一个cnpm代替npm
cnpm安装命令$ npm install -g cnpm --registry=https://registry.npm.taobao.org
安装参考这里

---

hexo的使用

现在就可以开始用hexo创建博客了。

初始化hexo
还是在刚刚的目录下E:\git\qxiaomay 右键 git bush

hexo init
cnpm install

第一天命令就是博客的初始化，运行后可能会出现这样的

[info] Copying data
[info] You are almost done! Don't forget to run `npm install` before you start b
logging with Hexo!

所以后面要执行npm install

如果你装了cnpm镜像就用cnpm，不需要的话就用npm

生成静态页面

hexo generate

hexo g也可以

启动服务

hexo server

hexo s也可以，一般都会出现下面的提示

[info] Start processing
[info] Hexo is running at http://localhost:4000/. Press Ctrl+C to stop.

这表明hexo服务已经启动了。你可以在浏览器中输入localhost:4000/看看能不能打开页面。
不知道你们可不可以打开，反正我不可以，后来查了一下，才知道要换一个端口号，我后来换成hexo server -p 5000 用5000端口就可以打开了。
初始页面是这样子的，都会有一篇内置的博客【hello world】：

配置信息
有页面了是不是很激动，但是，首页名称是hexo，而且页面底部的信息也不是自己的啊，我们来改掉他们！
找到博客根目录下的配置文件_config.yml，用自己喜欢的文本编辑器编辑它。看到# Site的那一部分，里面的title就是博客的名字，subtitle就是副标题，author对应的那个就是作者名字啦，把名字改成你自己的就好啦。
我自己的配置，我很懒，就随便弄了。

# Site
title: qxiaomay
subtitle: cheer up!
description: 
author: qxiaomay
language: zh-CN
timezone:

更多的配置可以查看官方文档

更换主题
这里以主题yilia为例进行说明。
还是在你自建的文件夹下，安装主题：

$ hexo clean
$ git clone https://github.com/litten/hexo-theme-yilia.git themes/yilia

修改Hexo目录下的_config.yml配置文件中的theme属性，将其设置为yilia。

theme: yilia

更新主题：

$ cd themes/yilia
$ git pull
$ hexo g # 生成
$ hexo s # 启动本地web服务器

这个时候再打开localhost就已经更新了，如果4000端口不行的话，记得要改端口哦
我更新后的主题是这样子的，由于之前我哪一步上传了一篇文章，所以还有一个new POST：

在使用这个主题之前，我还换过另外一个主题，名字是pacman，它长这样的，我觉得它有一点浮夸，就没用它，yilia的简洁大方才符合姐的气质！

主题配置
主题配置要打开你所要的主题下面的配置文件：

主要配置菜单栏，标题，头像，小图标等等。网上有很多配置教程，我的部分配置如下：

# Header

menu:
  主页: /
  所有文章: /archives
# 随笔: /tags/随笔/

# SubNav
subnav:
  github: "https://github.com/qxiaomay"
  weibo: "http://weibo.com/5108162161/profile?rightmod=1&wvr=6&mod=personinfo&is_all=1"
  rss: "http://blog.csdn.net/maymayjn"
  # rss: "#"
  # zhihu: "#"
  #qq: "#"
  #weixin: "#"
  ·······

配置完成后，页面就是这样了：

小图标长这，嘻嘻！

部署到GitHub上

到了这一步你离成功就越来越近了，我们把在本地web环境下预览到的博客部署到github上，就可以通过https://qxiaomay.github.io/ 直接访问了。

部署有两种方式，一种是直接用hexo deploy部署，一种是用git部署，我比较推荐第二种方式，第一种虽然简单，但是特别容易出错。。
那我就着重说一下第二种部署方式。

克隆git分支

$ git clone https://github.com/qxiaomay/qxiaomay.github.io.git .deploy/qxiaomay.github.io

将我们之前创建的repo克隆到本地，新建一个目录叫做.deploy用于存放克隆的代码。

接下来hexo generate生成public文件的新内容。

$ hexo generate

将其拷贝至.deploy文件夹下的qxiaomay.github.io的git目录下
再将他们提交上去就可以了。

git add .
git commit -m “update”
git push origin master

执行过程中可能需要让你输入Github账户的用户名及密码，按照提示操作即可。
这个过程可能有一点小小的漫长，完成后基本上就大功告成了

到这里一个基本的博客系统就搭好了。接下来就是去填充它完善它了，我之前看到一篇文章是你为什么要写博客
【摊手】whatever~开心就好

其他参考教程：
手把手教你使用Hexo + Github Pages搭建个人独立博客
Hexo搭建Github静态博客
用Hexo创建个人博客
Jekyll搭建个人博客
主题主题还是主题
我的小图标