Github Pages+Hexo博客搭建

之前使用博客园,总觉得不爽,也试过自己搭建博客。
wordpress太臃肿,其他的功(界)能(面)不(不)强(好)大(看),仔细想来想去还是用Github Pages+Hexo搭建一个静态blog吧,专注于写作。

准备工作

安装下列软件

  • node.js
  • git
  • 注册一个github账号

配置和使用Github

配置SSH Keys

我们如何让本地git项目与远程的github建立联系呢?用SSH keys。
检查SSH keys的设置
首先我们需要检查你电脑上现有的ssh key:

1
$ cd ~/.ssh 检查本机的ssh密钥

如果提示:No such file or directory 说明你是第一次使用git。
生成新的SSH Key:

1
2
3
$ ssh-keygen -t rsa -C "邮件地址@youremail.com"
Generating public/private rsa key pair.
Enter file in which to save the key (/Users/your_user_directory/.ssh/id_rsa):<回车就好>

注意1: 此处的邮箱地址,你可以输入自己的邮箱地址;注意2: 此处的「-C」的是大写的「C」
然后系统会要你输入密码:

1
2
Enter passphrase (empty for no passphrase):<输入加密串>
Enter same passphrase again:<再次输入加密串>

在回车中会提示你输入一个密码,这个密码会在你提交项目时使用,如果为空的话提交项目时则不用输入。这个设置是防止别人往你的项目里提交内容。
注意:输入密码的时候没有*字样的,你直接输入就可以了。
最后看到这样的界面,就成功设置ssh key了:

添加SSH Key到GitHub

在本机设置SSH Key之后,需要添加到GitHub上,以完成SSH链接的设置。
1、打开本地C:\Users\visionsmile\.ssh\id_rsa.pub文件。此文件里面内容为刚才生成人密钥。如果看不到这个文件,你需要设置显示隐藏文件。准确的复制这个文件的内容,才能保证设置的成功。
2、登陆github系统。点击右上角的Settings —-> SSH keys —-> ADD SSH Key
3、把你本地生成的密钥复制到里面(key文本框中), 点击 add key 就ok了

测试

可以输入下面的命令,看看设置是否成功,git@github.com的部分不要修改:

1
$ ssh -T git@github.com

如果是下面的反馈:

1
2
3
The authenticity of host 'github.com (207.97.227.239)' can't be established.
RSA key fingerprint is 66:d6:87:33:75:12:f5:e5:24:19:df:1e:58:d3:81:33.
Are you sure you want to continue connecting (yes/no)?

不要紧张,输入yes就好,然后会看到:

1
Hi hxhb! You've successfully authenticated, but GitHub does not provide bash access.

设置用户信息

现在你已经可以通过SSH链接到GitHub了,还有一些个人信息需要完善的。
Git会根据用户的名字和邮箱来记录提交。GitHub也是用这些信息来做权限的处理,输入下面的代码进行个人信息的设置,把名称和邮箱替换成你自己的,名字必须是你的真名,而不是GitHub的昵称。

1
2
$ git config --global user.name "hxhb"//用户名
$ git config --global user.email "hxhb@live.com"//填写自己的邮箱

SSH Key配置成功
本机已成功连接到github。

Github上建立仓库

登录后系统,在github首页,点击页面右下角「New Repository」

填写项目信息:

project name:username.github.io
description: Writing 1000 Words a Day Changed My Life

注:Github Pages的Repository名字是特定的,比如我Github账号是hxhb,那么我Github Pages Repository名字就是hxhb.github.io。

安装Hexo

打开git Bash(Linux下直接在终端输入)

1
$ npm install -g hexo

注意:在Linux下可能需要更新npdejs后才可以安装hexo,可以使用以下命令

1
2
3
$ sudo npm cache clean -f
$ sudo npm install -g n
$ sudo n stable

部署Hexo

新建一个Blog文件夹,然后在该文件夹中打开Git Bash

1
2
$ hexo init
$ npm install

Hexo随后会自动在目标文件夹建立网站所需要的所有文件。
现在我们已经搭建起本地的hexo博客了,执行以下命令,然后到浏览器输入localhost:4000看看。

1
2
$ hexo g
$ hexo s

安装主题

1
$ git clone https://github.com/iissnan/hexo-theme-next.git themes/next

启用next的主题

修改Hexo目录下的config.yml配置文件中的theme属性,将其设置为next。

1
theme: next

注意:Hexo有两个config.yml文件,一个在根目录,一个在theme下,此时修改的是在根目录下的。

更新主题

1
2
$ cd themes/jacman
$ git pull

注意:为避免出错,请先备份你的_config.yml 文件后再升级。

使用与调试

在本地如果需要预览或者调试你的博客,可以启动本地服务器:
hexo serve
部署到Github前需要配置_config.yml文件。

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

因为type是git,所以部署到Github前需要安装hexo-deployer-git

1
$ npm install hexo-deployer-git --save

之后执行下列指令即可完成部署,注意部署会覆盖掉你之前在版本库中存放的文件。

1
2
3
$ hexo clean
$ hexo generate
$ hexo deploy

或可加入 —generate 选项,在部署前自动生成文件。
本地查看调试

1
2
$ hexo g #生成
$ hexo s #启动本地服务,进行文章预览调试

或者直接作用组合命令

1
$ hexo d -g

此后的每次变更_config.yml 文件或者上传文件都可以先用此命令调试,非常好用,尤其是当你想调试出自己想要的主题时。

详情参考:如何搭建一个独立博客——简明Github Pages与Hexo教程

全文完,若有不足之处请评论指正。

扫描二维码,分享此文章

本文标题:Github Pages+Hexo博客搭建
文章作者:ZhaLiPeng
发布时间:2014年11月18日 11时11分
本文字数:本文一共有1,376字
原始链接:https://imzlp.me/posts/58952/
许可协议: CC BY-NC-SA 4.0
转载请保留原文链接及作者信息,谢谢!
您的捐赠将鼓励我继续创作!