利用GitHub搭建一个你的博客-CFANZ编程社区

声明：本文在Windows下进行操作的，Mac以及其它操作系统请做参考 多图警告！

1. 环境搭建

首先需要下载两个东西

node.js
git

具体的下载，安装就不用多说了，基本上下载完默认安装即可，安装的路径最好先记住。Git 安装的时候会弹出下面的窗口，我们选择第二个即可。这样我们在Windows的命令窗口也可以进行Git操作了。

两个都安装完了之后，打开命令窗口（按住Win+R后输入CMD即可打开命令窗口），分别输入 node -v 、npm -v 及 git --version 这三个命令是为了查看刚才我们安装的软件的版本，如果你能够看到他们的版本号（如同下图，也许版本号会有不同），那么恭喜你，环境搭建这一个大难关你已经过了，可以进入下一步骤了。

1.1 有问题看这里

2. 配置 GitHub

2.1 注册 GitHub

先到GitHub官网Sign up(注册)一个账号。

填好用户名、邮箱、密码进入下一步

2.2 SSH授权

注册好账号之后我们可以随意的查看其他人的项目，甚至是clone下载，但是要提交代码就必须完成SSH授权，如果可以不用授权就提交代码的话，那么Github岂不是乱了套。

2.2.1.生成SSH key

打开Git Bash，输入ssh-keygen -t rsa然后按三下回车，如下图所示

接着就会在C:\Users\Administrator.ssh目录下生成到id_rsa和id_rsa.pub两个文件，id_rsa是密钥，id_rsa.pub是公钥，接下来需要将id_rsa.pub的内容添加到GitHub上，这样本地的id_rsa密钥才能跟GitHub上的id_rsa.pub公钥进行配对，才能够授权成功。

2.2.2.在GitHub上添加SSH Key

首先点击右上角的倒三角进入Settings

紧接着选择左侧SSH and GPG keys,然后选择右上角的New SSH key，再把id_sra.pub的内容复制粘贴到key（id_sra.pub可以使用 sublime 或者记事本打开），最后Add SSH key就可以了。

SSH key 添加成功之后，输入ssh -T git@github.com进行测试，如果出现以下提示证明添加成功了。

3. 创建 GitHub 仓库

4. 设置本地博客的配置

4.1 安装Hexo

在你认为合适的地方创建一个文件夹，然后在文件夹空白处按住 Shift+鼠标右键，然后点击在此处打开命令行窗口。（同样要记住啦，下文中会使用在当前目录打开命令行来代指上述的操作）
在命令行输入npm install -g hexo

然后输入 npm install hexo --save 这时候你会看到命令窗口刷了一堆白字，然后输入 hexo -v 查看hexo是否安装成功了。

如果出现与上图一样的情况的话，就说明你离成功就近在咫尺了。

4.2 初始化Hexo

同样是在命令窗口中，继续输入 hexo init，等待下载好了之后输入 hexo s

这时候我们就可以打开浏览器了，在地址栏中输入 http://localhost:4000/ 我们就可以看到如下图的界面，这个就是我们的博客。没错，我们的博客就这样建好了。不过这个只是我们本地的博客，下面就要考虑怎么把我们的本地博客上传到我们的GitHub上了。

接下来先看一下我们的博客文章放在哪里。打开我们的文件夹下面的source文件夹，你会发现里面有一个_posts文件夹，再进入就会看到一片初始化的文章hello-world.md也就是上图显示在页面的文章。如果我们想新建文章的话，可以通过命令窗口输入hexo new 'filename'我们的文件夹下面就会生成一个新的md文件，然后我们打开编辑就可以了。

4.3 发布博客

首先复制我们的GitHub项目地址，如下图。

然后打开我们新建的文件夹下面生成的_config.yml文件，在最下方作如下修改。

deploy 是部署的意思，type: git 就是使用 git 进行部署，repo: github仓库地址

接下来回到命令窗口，输入 npm install hexo-deployer-git --save

安装好Git上传插件之后，输入 hexo g，然后输入 hexo d就可以将我们的博客上传到我们的GitHub了，而且以后更新文章就只需要用这两个命令就可以了。这样别人也可以通过 https://yourname.github.io 来访问我们的博客了（开头一定要用https，yourname是你的github的名字）。

5. 个性化设置（更换主题）

有木有觉得这个博客的默认主题特别的丑，如果不觉得可以忽略这一步（哈哈）。
这里以我使用的主题为例。
第一步去找我们想要的主题，然后下载下来。我用的是next主题，在命令窗口输入git clone https://github.com/iissnan/hexo-theme-next themes/next

然后打开配置文件，找到 theme 将原来默认的 landscape 替换 next。然后在命令窗口输入 hexo clean 、hexo g 及 hexo s，先看一下本地博客是什么样子，确认好了在输入 hexo d 部署到GitHub

每一个主题都有一个使用文档，next的使用文档为 http://theme-next.iissnan.com/getting-started.html 我们可以为我们的主题修改名字，添加评论等等，具体的你们就自己去研究了。如果你们觉得太麻烦的话，欢迎大家直接 Fork 我的，地址为 https://github.com/AD-feiben/hexo 当然里面的也有大家要修改的地方。