如何使用Jekyll+GitHub Pages搭建个人博客站点

作为一名有情怀的工程师，一般都会通过博客来记录自己的生活，成长，工作心得或者经验，大部分人使用博客都会经历如下几个阶段：

（1）记录在大脑中 （不推荐）

（2）使用XXX云笔记

（3）使用iteye，csdn，51cto，开源中国，博客园，简书，等等

（4）使用个人站点+微信公众号



（一）Jekyll是什么

jekyll是一个静态博客的生成器，它可以用来把我们使用markdown来写好的文章给转换成静态网页html来发布。


（二）Github Pages是什么

Github Pages 是面向用户、组织和项目开放的公共静态页面搭建托管服务，站点可以被免费托管在 Github 上，你可以选择使用 Github Pages 默认提供的域名 github.io 或者自定义域名来发布站点。Github Pages 支持 自动利用 Jekyll 生成站点，也同样支持纯 HTML文档。

（三）如何搭建使用

前提条件：

````
git环境
github账户
ruby环境 
````

jekyll底层是使用ruby编写对，所以安装时候需要先安装ruby环境：

在mac先要安装一些软件，这里假设你对git环境已经有了：

````
brew install ruby

gem install jekyll

gem install bundler

gem install jekyll-paginate

gem install jekyll-gist

````

上面对软件安装完毕后，你就可以在github上搜索一个基于jekyll模版对项目，当然你可以从网上搜索任何你喜欢的主题风格，找到之后使用git clone到自己本地：

 ````
 git clone xxx.git  myblog
 
 cd myblog
 
 jekyll server
 
 ````

然后访问http：//localhost：4040端口就可以在本地预览你到博客了

如果你喜欢这个主题，那么你就可以fork到你自己到github中，然后clone下来，修改一些地方，然后就push到自己到仓库中，就可以了，一些git操作命令：

````
git add .
git commit -m "first commit"
git remote add origin https://github.com/alex-my/alex-my.github.io.git
git push -u origin master
````

关于jekyll的博客的目录结构，感兴趣的可以参考官网文档：
http://jekyllcn.com/docs/structure/

我们写的文章一般是在_posts目录里面，它的格式如下：

````
2018-04-11-spark sql大数据量下的调优和实践.md
````

前面是日期，中间是标题，后缀一般是md，看起来比较简洁。

（四）绑定自己到域名

最后说下github里面的项目，进入项目根目录后，点击右上角的Settings配置选项，在里面可以配置自己的站点域名，我这里配置的是我自己的域名，默认情况下一般都是 username.github.io比如我的是：

````
qindongliang.github.io
````

这样看起来有点简陋，那么绑定我们已经有的域名到github pages上呢，非常easy，首先假设我们已经有一个域名了，没有的话可以自己到网上买，然后在自己到静态站点到根目录下，新建以名字为CNAME到文件，里面的内容就是我们的自己的域名，比如我的：

````
8090nixi.com
````

注意这里只需要域名后面的部分即可，不需要把http和www都写进来，然后登陆域名管理中心，我这里是阿里云的找到域名解析部分，添加一条CNAME记录：

````
CNAME @  qindongliang.github.io
````

配置完毕之后，一般10分钟之内就可以生效，如果不出意外，一会就可以通过我们自定义的域名访问我们的静态站点了。

至此，一个属于我们自己独立的个人站点就完成了，使用jekyll+github pages优缺点如下，借用阮一峰老师的总结：

优点：

````
　  * 免费，无限流量。

　　* 享受git的版本管理功能，不用担心文章遗失。

　　* 你只要用自己喜欢的编辑器写文章就可以了，其他事情一概不用操心，都由github处理。
````

缺点：

````
　　* 有一定技术门槛，你必须要懂一点git和网页开发。

　　* 它生成的是静态网页，添加动态功能必须使用外部服务，比如评论功能就只能用disqus。

　　* 它不适合大型网站，因为没有用到数据库，每运行一次都必须遍历全部的文本文件，网站越大，生成时间越长。
````

但对于中小站点来说，无疑是一个不错的方案，感兴趣的朋友可以尝试一下，我个人比较喜欢简洁的站点风格，大家可以通过我公众号底部的菜单栏的博客按钮感受一下。


有什么问题可以扫码关注微信公众号：我是攻城师(woshigcs)，在后台留言咨询。 技术债不能欠，健康债更不能欠， 求道之路，与君同行。