通过GitHub和Hexo搭建个人博客

折腾了几个小时终于用hexo和github构建了一个个人博客,终于可以愉快的记录一些东西了。实际上20分钟就能完成整个过程,为了下次不走弯路,赶紧记录下这次构建过程。

Github账号申请

首先,你需要一个github账号,然后在账号下建立一个repository,这个过程及其简单,此处唯一需要说明的是repository必须命名为username.github.io,username就是你的用户名,而且必须要跟你用户名相同。

安装node.js和git

由于hexo是基于node.js构建的,所以我们需要在电脑上部署node.js,官网推荐有两个版本,追求稳定的用户可以安装LTS长期支持版,这个也是官网推荐大多数用户安装的。具体安装过程不详述,这个过程大家应该重复了无数遍了。安装git基本与node.js类似,直接现在安装即可。

安装hexo

接下来就要在自己电脑上安装hexo。hexo官网首页给出了如下简单的说明。

1
2
3
4
5
npm install hexo-cli -g
hexo init blog
cd blog
npm install
hexo server

首先,我们需要在命令行下输入 npm install hexo-cli -g 命令执行安装。

然后执行 hexo init blog 初始化博客。这里blog是指你为hexo建立的文件夹。

接下来用cd命令进入hexo文件夹,执行npm install 命令,根据博客既定的dependencies配置安装所有的依赖包。

执行最后一条命令我们可以在本地地址localhost:4000来访问博客,这里我们可以暂且不做。

最后我们还要执行下面的命令,否则之后deploy的时候会出现ERROR Deployer not found:的错误。

1
npm install hexo --save

设置SSH keys

安装完git之后,在我们的右键菜单就会多出Git GUI Here和Git Bash Here,点击Git Bash Here进入Bash命令行,执行一下命令查询是否已经存在SSH Key。没有配置过的话应该是不存在的,如果存在的话,直接删除.ssh文件夹里面所有文件即可。

1
ls -al ~/.ssh

然后输入以下命令,把XXXXX@XXX.com换成你Github注册时用的邮箱。

1
ssh-keygen -t rsa -C "XXXXX@XXX.com"

然后它会提示要你输入passphrase,输入的话下面可能会用到。然后依次输入下列命令,一路回车。

1
2
3
4
5
ssh-agent -s
ssh-add ~/.ssh/id_rsa
eval `ssh-agent -s`
ssh-add
clip < ~/.ssh/id_rsa.pub

下面进入Github,找仓库页面上的setting,然后点Deploy keys,进去把刚才存放粘贴板上的内容复制进去,title可以随便写。保存完成之后我们可以执行以下命令检查。

1
ssh -T git@github.com

中间会向你确定是否继续联接,输入yes,如果配置成功,会显示Hi, yourusername!, You’ve successfully authenticated, but GitHub does not provide shell access.

更改repo文件并发布

马上就要成功了,进入hexo文件夹,用编辑器打开_config.yml文件,拖到最下面你会看到如下信息。

1
2
deploy:
type:

把你自己的信息输入进去就行,yourusername更换成你自己的用户名即可。这里type:后面需要填写git而不是github,

1
2
3
4
deploy:
type: git
repository: https://github.com/yourusername/yourusername.github.io.git
branch: master

之后执行下列命令就可以通过yourusername.github.io来访问你自己的网站了。

1
2
hexo g
hexo d

后记

折腾了好几遍,参考了很多博客,顺序可能有点乱,大致的过程就是上面这样,到这里只是完成了hexo博客搭建的第一步,之后主题设置,发表博客,备份内容等等都还需要很长时间的摸索。

参考资料

史上最详细“截图”搭建Hexo博客并部署到Github

20分钟教你使用hexo搭建github博客

手把手教你用Hexo+Github 搭建属于自己的博客

使用hexo搭建github.io博客(一)

手把手教你使用Hexo + Github Pages搭建个人独立博客