github结合hexo搭建个人静态博客

Posted on | In | | Visitors |

一、github的下载及github pages的配置

github在多平台下都可以安装，google搜索github，进入官网即可下载自己所需要的版本。各版本安装过程均较为简单，且官方手册叙述详细，在此不再赘述。

下面以windows平台为例介绍后续配置方法。

下载完成后，打开git终端，首先使用cd命令跳转到相应盘符建立一个新的工作目录，并将git部署在此目录下。

1
2
3
4
5
#将目录换至工作目录
cd /e
#新建一个名为mygit的工作目录用户存储本地项目
mkdir mygit
cd mygit

接下来，检查本机ssh-key的设置，此设置是为了安全地连接本机和github服务器。如果没有设置过ssh-key，这里则需要生成新的ssh-key。

1
2
3
4
cd ~/.ssh
#如果提示没有相应的文件或文件夹，需要创建一个新的ssh-key
#邮箱需要填写注册github时使用的邮箱
ssh-keygen -t rsa -C "邮箱地址@yourmail.com"

接着需要输入加密串。一段自己可以记得住的密码即可，会要求重复输入。最后会有ssh-key输出成功的提示，另外在.ssh文件夹中也可以发现新生成了公钥和密钥文件。

下面要做的是将公钥上传到github中，完成github服务器和本机的联系。在~.ssh文件夹中找到id_rsa.pub，并将其复制到github个人主页中的SSH and GPG keys一项中。

上传完成后进行测试，尝试连接github。使用以下代码实现。

1
ssh -T git@github.com

会要求输入刚才生成ssh-key时需要的加密串，输入正确后验证成功。
接下来要进行github pages的创建。

在github中创建一个repository，需要注意的是如果要创建github pages,必须以域名格式对此repository进行命名，即形如×××.github.io的形式。

复制此项目的在github中的地址，将项目克隆至本机。（需要注意的是，在github上搭建博客需要对github的工作原理及使用方法有一定了解，如项目的创建，克隆等等，可以参考git简明指南进行了解）

1
2
#实际操作时，以自己的项目地址为准
git clone https://github.com/aaaa/aaaa.git

如此便完成了github的本地配置以及github pages的配置。

二、Hexo模板的使用

事实上，可以用于在github上搭建博客的模板和语言有很多种，比如基于node.js的Hexo,还有基于Ruby的jelyll等。由于node.js在windows下的安装更为简单，本人使用了Hexo作为搭建博客的模板。

首先需要下载node.js,其同样支持多种平台，下载链接在此。

windows下的安装同样十分简单，运行exe文件后一路下一步即可。安装完成后，打开cmd，在其中输入npm,如果出现了关于其用法的介绍，则说明node.js安装成功且其安装路径已经加入了系统环境变量中。

接下来使用npm下载博客模板，首先需要在本地新建一个文件夹用来存储博客需要的文件，拟将此文件夹命名为blog。

切换至blog目录，安装Hexo模板，使用如下代码：

1
2
cd blog
npm install hexo-cli -g

接着安装博客所需要的相关插件

1
2
3
4
5
6
7
8
9
10
11
12
13
14
npm install hexo-generator-index --save
npm install hexo-generator-archive --save
npm install hexo-generator-category --save
npm install hexo-generator-tag --save
npm install hexo-server --save
npm install hexo-deployer-git --save
npm install hexo-deployer-heroku --save
npm install hexo-deployer-rsync --save
npm install hexo-deployer-openshift --save
npm install hexo-renderer-marked@0.2 --save
npm install hexo-renderer-stylus@0.2 --save
npm install hexo-generator-feed@1 --save
npm install hexo-generator-sitemap@1 --save
npm install moment-timezone --save

下载完成后，即可进行博客的配置和博文的撰写。关于Hexo的相关文档，可以到这个网站进行查看，其中详细地介绍了Hexo博客模板中各个参数的使用。

搭建博客使用以下代码：

1
2
3
4
5
hexo init blog
cd blog
npm install
hexo g #生成静态文件，默认在当前目录下生成一个叫做public的文件夹
#关于hexo命令的更多用法及更多命令，可以在帮助文档中进行查看。

预览博客，使用以下代码实现

1
hexo s

在浏览器地址栏中输入http://localhost:4000即可预览博客。另外在命令行中也可以看到可能存在的报错信息用于调试。

三、更换博客主题

在github中或者hexo的项目网站中找到自己喜欢的主题，然后将其在github中的项目复制到本地，进而修改blog中的_config.yml文件，将theme字段修改为目标主题名称。此处以next主题为例对博客主题进行修改。

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

更换完毕后，可能需要删除博客中的数据库文件，重启server服务后即可查看更换主题后的博客内容。

1
2
hexo clean
hexo s

关于next主题的相关修改方法文档，可以通过这里来了解更多，作者将主题配置的问题在那里列举地非常详细。

参考资料：

1.HelloDog——使用GitHub和Hexo搭建免费静态Blog
2.令狐葱——手把手教你使用Hexo + Github Pages搭建个人独立博客
3.Hexo官方文档
4.Next使用文档