通过GitHub Pages和jekyll在GitHub上建立免费博客

终于设置好可以发博客了！

第一篇就来说说怎么通过GitHub Pages和jekyll(jekyll的中文网页)，在GitHub上发文章吧。

GitHub Pages are public webpages freely hosted and easily published through our site.

Jekyll is a simple, blog-aware, static site generator perfect for personal, project, or organization sites.

搭建GitHub博客项目

首先根据GitHub Pages的指引，建立好项目：

https://github.com/username/username.github.io

其中 username 必须是自己在GitHub上的用户名。再把项目clone到本地目录：

/Users/jowyer/Code/jowyer.github.io/

重用jekyll默认工程

为了快速开始，可以使用jekyll默认的模板来进行修改。

$ cd /Users/jowyer/Code/
$ jekyll new blog
$ cd blog
$ cp -R ./. ../jowyer.github.io/

将jekyll模板工程中的所有文件，包括.gitignore都拷贝至GitHub博客项目的本地目录中去。

最后将本地的博客项目 Commit & Sync 到GitHub去就搞定了！

快去你的 http://username.github.io/ 看看吧！

了解目录结构

至此，构成博客网页的所有内容都组织在你的GitHub工程中了，网页内容，结构，样式都可以随意调整。

进一步关于jekyll的文件结构及其用法请移步 jekyll官方教程 。

jekyll调试

jekyll提供了很方便的本地调试方法，只需要在工程目录下输入：

$ jekyll serve

就会在本地启动一个开发服务器，这时在浏览器中打开http://localhost:4000/就可以进行本地调试了。关闭本地服务器：Ctrl+c。

jekyll安装

如果你和我之前一样，电脑上没有安装jekyll，那我们还有一段路要走。

Requirements:

• Ruby (including development headers)
• RubyGems
• Linux, Unix, or Mac OS X
• NodeJS, or another JavaScript runtime (for CoffeeScript support).

我在mac上的安装顺序是：

1. 安装Homebrew

   • $ ruby -e "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/master/install)"

2. 安装RVM

   • $ \curl -sSL https://get.rvm.io | bash -s stable

3. 用RVM安装Ruby

   • $ rvm install ruby-2.1.3

4. 用RubyGems安装jekyll

   • $ gem install jekyll

当然，你也可以遵循jekyll官方安装指南。

Reference

kramdown Syntax