在Github上搭建Jekyll博客

发表于 更新于 分类于
以程序员的方式。

博客类型

github的个人博客有两种方式。

全局的（User, Organization Pages）

全局的只能有一个，并且在新建仓库的时候名字必须是: <username>.github.com 或者 <username>.github.io，这就告诉github你要创建一个全局的blog，访问的地址看起来像这样: 

http(s)://<username>.github.io

工程博客（Project Pages）

工程博客在工程下的gh-pages分支，这样的博客可以每一个工程建立一个，访问地址是这样子的:

http(s)://<username>.github.io/<projectname>

创建方式

自动创建

在创建工程之后点击settings,然后点击Automatic Page Generator，然后会打开页面编辑器，后面的你们都知道了。

Jekyll 创建

你可以在本地创建你的Jekyll项目（这需要本地的ruby gem环境），然后上传到相应的仓库的相应分支。
当然，Jekyll-bootstrap是更好的加速的模板，推荐使用。

http://jekyllbootstrap.com/

需要注意的一点，Jekyll-bootstrap 在安装主题的时候会产生git项目的子项目，所以建议删除所有的.git文件夹之后重新init git仓库然后push到远端仓库，否则极容易引起github的编译错误，会发邮件告诉你需要配置该项目的git子模块。

集成云评论

默认 Jekyll-bootstrap使用的是disqus，这是一个国外的云评论系统，集成的Twitter等国内可能会使用不了（原因你懂的），这里推荐 多说，可以参考如下教程：

点我

重定向域名

顶级域名

由于本人在万网购买的域名不支持Alias方式，所以也没有什么经验，不过官方的文档说明似乎是说只需要在你的域名提供商的管理页面添加一个A方式的规则就可以了。大家可以自行尝试，但是这种方式并不推荐，因为极有可能你的域名还要转向你的个人网站，博客其实只需要使用子域名就好了。

子域名

步骤如下：

  1. 在你的git工程根目录下创建名为CNAME的文件，这个文件包含且仅包含单行的子域名信息，格式看起来像这样：<sub_uri>.domain_name
  2. 在你的域名管理页面创建 CNAME 规则， 名称填写<sub_uri>,后面的主机填写<username>.github.io 等待一分钟使其生效。

好了，开始你的博客之旅吧，写博客是一个好习惯，能帮助梳理知识脉络，有助于归纳总结，长期坚持有助于知识的积累。 Have fun!