如何搭建一个独立博客——简明Github与Hexo教程

前言

买过域名和主机，折腾过wordpress，个人博客也搭建起来了，本来是准备写技术文章，分享，但是折腾那些东西花费了太多的时间，认真写作反而少了。现在决定换成hexo写博客，专注写作分享，少折腾。

本文主要参考cnfeat的《如何搭建一个独立博客——简明Github Pages与Hexo教程》,原文很详细，
还有Zippera的《hexo系列教程》

为什么选择Hexo

hexo是一个基于Node.js的静态博客程序，可以方便的生成静态网页托管在github上。作者是来自台湾的tommy351。作者对hexo只有一句话的介绍:

A fast, simple & powerful blog framework, powered by Node.js.
一个快速、简单并且强大的基于Node.js的博客框架。

我们可以用hexo创建自己的博客，然后托管到github上，也可以绑定自己的域名。

hexo的优势：

• 简单：平常只需要hexo new,hexo generate,hexo server,hexo deploy四个命令，或者更少只需要hexo g和hexo d两个命令。（hexo支持首字母命令）
• 快：配置方便也容易理解，配置好后，马上就能看到效果。
• 支持markdown，我觉得这是最大的一个优势了，wordpress上用markdown简直不爽。
• 文章全都本地有保存，方便管理啊。（我一般本地写文章，然后利用网盘自动同步，还发布到博客上，这样再也不怕文章丢失了）
• 其他还有支持Octopress扩展，兼容主流三大平台Win、Linux和Mac等等

为什么选择GitHub Pages？

GitHub Pages本用于介绍托管在GitHub的项目，不过，由于他的空间免费稳定，用来做搭建一个博客再好不过了。

github Pages可以被认为是用户编写的、托管在github上的静态网页。

优势：

1. github pages有300M免费空间，资料自己管理，保存可靠；
2. 学着用github，享受github的便利，上面有很多大牛，眼界会开阔很多；
3. 顺便看看github工作原理，最好的团队协作流程；
4. github是趋势；
5. 就算github被墙了，我可以搬到国内的gitcafe中去。

本地博客的搭建

安装Git

Windows下直接下载安装就行，安装好后，会发现开始菜单里有Git Bash，这就表明成功了。
Linux（我只用过Ubuntu，以Ubuntu说明）下可以下载deb包安装，也可以终端输入

sudo apt-get install git

Mac土豪用户请看官方说明！

安装Node.js

安装方法同安装git差不多。
注意：Windows安装完后还需要添加环境变量，使npm命令生效。在环境变量的Path里添加npm的路径。比如我的是;C:\Program Files\nodejs\node_modules\npm,分号不能少。

安装hexo

上面两部成功后，打开Git Bash，输入

npm install -g hexo

安装hexo。（如果出现错误，可能是环境变量没有设置好，最好重启下，或者网上搜索解决办法）

hexo安装完成后，在你喜欢的文件夹里新建一个hexo文件夹（比如D：\hexo），然后在文件夹内点击鼠标右键，选择Git Bash，并且输入如下命令

hexo init

hexo就会自动在目标文件夹建立它所需要的文件了。
然后继续输入

npm install hexo-renderer-ejs --save
npm install hexo-renderer-stylus --save
npm install hexo-renderer-marked --save

安装需要的一下依赖包。

本地查看效果

经过上面三部，一个本地的博客已经建成功了，可以先来一睹为快。
继续输入如下命令

hexo g
hexo s

然后我们看到提示：

提示

这时在浏览器输入http://localhost:4000/，就能看到自己的博客了。
要结束预览只需要在Git Bash里同时按下ctrl+C。

如果没有问题，本地的博客已经建成功了，注意，只是本地的。如果想其他人也能看到，就需要部署到github上了。（部署到其他地方也可以，但github最方便）

博客部署到Github

注册账号

访问Guthub官网：http://www.github.com ,输入用户名、邮箱和密码就行，很简单

配置SSH keys

觉得麻烦的这一步可以不弄，但是不弄的话，没有都要输入用户名和密码更麻烦。
这有个官方教程不过是英文的。

第一步：生成新的SSH keys

命令行输入下面的内容，并回车：

ssh-keygen -t rsa -C "your_email@example.com"

将your_email@example.com换成你刚刚注册github时的邮箱。
然后有提示：

Generating public/private rsa key pair.
Enter file in which to save the key (/your_home_path/.ssh/id_rsa):

直接按回车键就好，然后系统要你输入密码：

Enter passphrase (empty for no passphrase): [Type a passphrase]
Enter same passphrase again: [Type passphrase again]

这个密码是在你提交项目时使用，为空的话就不用输入，为了方便我就没输密码，直接按了回车键。

最后会看到这样的界面，这就表明设置成功了：

Your identification has been saved in /your_home_path/.ssh/id_rsa.
Your public key has been saved in /your_home_path/.ssh/id_rsa.pub.
The key fingerprint is: 01:0f:f4:3b:ca:85:d6:17:a1:7d:f0:68:9d:f0:a2:db your_email@example.com

添加SSH key到Github上

用文本编辑器打开～/.ssh/id_rsa.pub（Windows下是C:\Documents and Settings\Administrator.ssh\id_rsa.pub），这就是刚刚生成的秘钥,这是隐藏文件，你需要设置显示隐藏文件才能看到，然后全选里面的内容并复制。

登陆github网站：

1. 点击右上角的Account Settings—->SSH Public keys —-> add another public keys
2. 把刚刚复制的内容粘贴到key里，title随便填，比如我加的是Ubuntu系统的，就写个Ubuntu。
   
   
   
3. 点击add SSH，这就完成了。

测试是否添加成功

命令行输入(不要修改下面的内容)：

ssh -T git@github.com

你可能看到警告（也可能没有）：

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.

出现这就表明真的成功了。

设置用户信息

现在你已经可以通过SSH链接到GitHub了，还有一些个人信息需要完善的。

Git会根据用户的名字和邮箱来记录提交。GitHub也是用这些信息来做权限的处理，输入下面的代码进行个人信息的设置，把名称和邮箱替换成你自己的，名字和邮箱是github注册时使用的那个。

git config --global user.name "your user_name"
git config --global user.email "your_email@example.com"

SSH key配置成功

到这Github本地全部配置完成了，如果有问题，请重新配置一次，或者google问题，解决就好了。

使用Github Pages建立博客

与GitHub建立好链接之后，就可以方便的使用它提供的Pages服务，GitHub Pages分两种，一种是你的GitHub用户名建立的username.github.io这样的用户&组织页（站），另一种是依附项目的pages。

想建立个人博客是用的第一种，形如user_name.github.io这样的可访问的站，每个用户名下面只能建立一个。

创建repository

在自己github主页右下角，创建一个新的repository。比如我的Github账号是wanyne，那么我应该创建的repository名字应该是[wanyne.github.io](wanyne.github.io)。

然后填写项目信息：

project name：wanyne.github.io
description： The Spiritual Journey !

注：Github Pages的Repository名字是特定的，比如我Github账号是wanyne，那么我Github Pages Repository名字就是wanyne.github.io。description可以随意写，写你对这个博客的一句话介绍就好。

配置本地文件，链接github

打开之前新建的hexo文件夹，里面有一个_config.yml的文件，用文本编辑器打开，推荐用sublime text。然后编辑，在最下面deploy那修改为：

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

除了将两个wanyne改成你自己的github用户名，其他全部不要改，然后保存。

部署完成

在命令行输入：

hexo g
hexo d

如果最后出现：

[info] Deploy done: github

就说明部署成功，用浏览器打开wanyne.github.io(将wanyne改成自己的)，就能看见自己的博客了，别人也可以访问了。

写博客文章

还是在hexo文件夹，右键打开Git Bash，输入（将name换成你要发表的文章的标题）

hexo new "name"

然后在source/_posts/里就能看到一个name.md的文件了，现在就可以写你想写的任何内容了。
也可以直接在source/_posts/里直接新建一个name.md的文件，注意开头要加入下面的内容

title: Test
date: 2014-12-19 23:37:07

tags:

发表文章

文章写好后保存，命令行输入：

hexo g
hexo d

就和之前一样，成功后马上就能你的博客上看到了。快去试试吧！
今后发布文章只有写个md文档，然后hexo g和hexo d就好了，是不是很方便。

后记

这只是写博客的第一步，正在想要打造自己的博客，还需要自定义博客，还需要学会使用markdown写作等等，这些都挺有乐趣，感兴趣的可以多看看。最重要的是要坚持写，坚持分享！

推荐几个链接，都是精华的东西，值得一看。

1. 献给写作者的 Markdown 新手指南
2. 用 Markdown 写作用什么文本编辑器？
3. 好用的免费图床七牛
4. 为什么你应该（从现在开始就）写博客
5. 如何搭建一个独立博客——简明Github Pages与Hexo教程
6. hexo系列教程

文／Vaayne（简书作者）
原文链接：http://www.jianshu.com/p/fe5b4b657778
著作权归作者所有，转载请联系作者获得授权，并标注“简书作者”。