Hexo + GitHub配置个人博客

前言

前段时间突然想要搭建一个个人网站，但是在申请域名的时候发现需要很麻烦的步骤，而且需要差不多三周的时间域名才能完成，所以说就先放弃了，然后就发现强大的GitHub支持这个功能，然后就……

为什么要写下这个过程呢？前车之鉴，以前装了一个黑苹果的虚拟机，但是一段时间之后发现系统坏了，但是第一次安装的时候什么都没有记录，所以说只有再去找教程，解决问题慢慢安装，很是心酸。所以说现在我把自己关于一些配置的过程记录下来，也为我以后查看提供了方便。

本人博客效果预览：AnICoo1

0.声明

本教程只针对windows用户

1.GitHub客户端下载

下载GitHub的桌面客户端GitHub，然后安装，安装完成后会出现下图三个东西，如果在安装路径内没有找到的话，可以在开始菜单那里找到，其实主要使用的是Git Shell

需要注意的是因为GitHub是国外的网站，所以说使用国内网络下载会非常的慢(其实是我很慢= = )，所以说建议下载的时候可以找一个免费的VPN先顶一段时间。

2.Node.js下载

下载Node.js，然后安装，这个同上，使用VPN

3.GitHub仓库

这个我感觉就没必要讲了，GitHub的帮助文档什么的讲的很清楚，需要注意的是你的仓库名称需要是 xxx.github.io , 其中 xxx 表示你的名字，因为看到有的人配置的时候因为仓库的名字和本人GitHub账号的昵称不一致导致配置失败，所以说最好还是使仓库名称和GitHub账号的昵称一样吧。

4.GitHub SSH密钥配置

进入Git Shell，输入：

ssh-keygen -t rsa -C "your's emaill address"

引号内为你的邮箱地址，然后点击回车，会让你确定保存地址，直接回车确认，然后会提示你输入密码，输入即可，但是屏幕不会显示，这个使用过Shell编程的都知道，然后点击回车，再次输入密码，点击回车，然后去所保存的文件夹查看，会发现如图两个文件

打开id_rsa.pub，可使用Notepad++打开，然后将里面的内容全部复制。

打开GitHub，点击头像里面的setting选项，然后找到SSH密钥的配置，新建SSH key

Title随意设置，下面的Key将你复制的文件内容粘贴至此。 然后Add SSH key，完成。

然后回到Git Shell，输入检查SSH是否可用

ssh -T [e-mail]

出现下图内容即表示成功

5.创建本地仓库关联GitHub仓库

在任意位置添加一个文件夹(最好英文，中文我没试过)，然后使用Git Shell进入刚才创建的文件夹，依次输入命令：

git initgit config --global user.name "Your's name"git config --global user.email "Your's email address"

其中的Your’s name替换成你的名称，Your’s email address替换成你的邮件地址即可

尝试提交

在本地仓库文件夹内随意创建一个文件，然后依次输入命令

git add .git commit -m "第一次尝试提交"[e-mail]:yourname/yourname.gitgit push -f origin master

其中第一个yourname为你的GitHub账号昵称，第二个youname为你的仓库名称，然后回到GitHub网页中就能看到仓库中多了一个你所创建的文件。

6.Hexo的安装

先检查一下Node.js是否安装成功，输入:

node

如果看到提示符变为一个向右的箭头，即表示成功，如下图

按ctrl+shift+c退出node模式

安装Hexo

npm install -g hexo-cli

整个过程可能有时候会卡在一个地方，这个时候千万不要关闭界面，只需等待即可，
完成后，检查是否安装成功

hexo version

如果出现版本号信息，即为成功。

进入我们创建的本地仓库，依次输入以下命令

hexo initnpm installhexo ghexo s

完成后，在浏览器输入http://localhost:4000/即可看到hexo已经成功生成了博客，但是只能我们本地能够看到。

7.Hexo配置到GitHub

进入我们刚才创建的本地仓库文件夹，可以看到一个 _config.yml 文件，同样的使用Notepad++打开，在文件内容最后我们可以看到

将其改成

当然后面的网址当然是自己的。
保存后，在Git Shell中输入，当然此时应在本地仓库文件夹中

hexo ghexo d

如果出现以下异常:

ERROR Deployer not found: git

输入以下命令，重新输入以上两个命令即可。

npm install hexo-deployer-git --save

执行完上面的两条命令之后，可能会让你输入你的用户名和密码，输入你的GitHub账号和密码即可，

完成

进入我们的GitHub账户，查看仓库是否更新，如果更新，进入我们注册的网址即可看到一个崭新的博客网站生成了。如果第一次访问不了，没关系，过几分钟再来访问即可。初始化的博客有一个默认的主题，我们可以选择自己想要的主题来进行更换，可在https://hexo.io/themes/进行主题选择，然后根据帮助文档进行配置，我使用的是jacman主题(http://wuchong.me/jacman/)，下一次再说jacman主题的配置过程、发表博客以及博客内功能配置等问题。

参考资料

http://opiece.me/2015/04/09/hexo-guide/

总结

因为也是第一次在windows下配置Hexo，所以说按照步骤一步步来应该不会有什么坑，如果有什么问题或者疑问可以评论，我们一起来解决。