Hexo+Github Page搭建个人博客

之前看到很多人搭建自己的博客，而不是依托于CSDN、博客园等站点，因此课后之余，花了点时间搭建了本博客，期间遇到了很多问题，现在再此写下了具体的搭建过程以及遇到的麻烦和具体的解决办法，希望对读者有所帮助。

1、Hexo

1.1 Hexo简介

Hexo 是一个快速、简洁且高效的博客框架。Hexo 使用 Markdown（或其他渲染引擎）解析文章，在几秒内，即可利用靓丽的主题生成静态网页。

1.2 安装前提

安装Hexo前需要安装Node.js和Git。

安装Git
Windows：下载并安装 git.

Linux (Ubuntu, Debian)：sudo apt-get install git-core
Linux (Fedora, Red Hat, CentOS)：sudo yum install git-core

注意：初次安装git需要配置用户名和邮箱，否则git会提示：please tell me who you are.
1
2
3
4
>   $ git config --global user.name "Your name"
>   
>   $ git config --global user.email "Your email"
>

此外，初次使用git的用户要使用git协议大概需要三个步骤：

一、生成密钥对
1
2
>   $ ssh-keygen -t rsa -C "your_email@youremail.com"
>

二、设置远程仓库（本文以github为例）上的公钥

>   1.查看生成的公钥: $ cat ~/.ssh/id_rsa.pub   
>   2.随后登陆你的GitHub账户，Setting->左栏点击SSH and GPG keys->New SSH key
>   3.复制上面所查看的公钥，粘贴进key文本域，点击Add key
>   4.验证是否起作用: $ ssh -T git@github.com		
>

三、把git的 remote url 修改为git协议
1
2
>   $ git remote set-url origin git@github.com:someaccount/someproject.git
>
安装Node.js
对于windows用户来说，建议使用安装程序进行安装。安装时，请勾选Add to PATH选项。

1.3 安装Hexo

所有必备的应用程序安装完成后，即可使用 npm安装 Hexo。

1	$ npm install -g hexo-cli

该命令行在Git Bash 上使用，打开它的方法很简单，在桌面或者文件夹任意位置单击右键，选择“Git Bash Here”即可。由于Hexo的很多操作都涉及到命令行，读者可以考虑始终使用Git Bash来进行操作。

2、搭建博客

2.1 初始化

安装 Hexo 完成后，请执行下列命令，Hexo 将会在指定文件夹中新建所需要的文件。

1
2
3

$ hexo init <folder>
$ cd <folder>
$ npm install

当然你也可以自己新建一个目录，比如我在F盘中创建了myblog目录，进入目录中点击右键选择Git Bash Here，直接执行以下命令

1 2	$ hexo init $ npm install

新建完成后，指定文件夹的目录如下：

.
├── _config.yml
├── package.json
├── scaffolds
├── source
|   ├── _drafts
|   └── _posts
└── themes

2.2 启动服务器

执行以下命令来启动服务：

1 2	$ hexo g #hexo generate，生成静态文件 $ hexo s #hexo server，启动本地服务器

如果启动过程中没有报错，此时你用浏览器访问http://localhost:4000/，就可以看到一个空白的博客页面，hexo3.0使用的默认主题是landscape，此时的服务是本地启动的，别人并不能看到。

2.3 Github配置

想要别人也访问到你的页面，跟着继续吧。首先在Github官网上注册一个账号，有账号的跳过注册，直接登录。登录后找到new repository按钮创建一个新的仓库, 要注意必须创建与你的Github用户名相对应的Github Page仓库，格式必须是username.github.io。

2.3 建立关联

进入你刚创建的仓库，复制仓库的地址 ,然后打开hexo文件夹下的_config.yml文件，拉倒最下面，修改deploy为以下代码，在repository后面粘贴你的仓库地址：

deploy: 
    type: git
    repository:  git@github.com:username/username.github.io.git
    branch: master

输入以下命令部署到Github Page

1
2
3

$ hexo clean
$ hexo g
$ hexo d

然后在浏览器输入username.github.io就可以看到你的博客啦。

之后每次更改你的_post目录下的博客文章，都需要输入上述命令来部署到Github Page。