Question

构建 github 个人博客站： https://username.github.io/ （个人博客必须是 https 开头）

• https://github.com/dennycn/dennycn.github.io
• https://dennycn.github.io
• http://127.0.0.1:4000/

安装环境：

• ruby
• RubyGems：ruby 包管理工具
• jekyll
• pygments 代码高亮

jekyll 常用命令

jekyll help # 查看帮助
jekyll help subcommand  # 查看子命令的帮助信息
jekyll new site-name  # 创建一个新的
jekyll build  # 构建，缺省把博客生成到 _site 目录下

jekyll server  # 开启本地服务器查看效果
jekyll server -P 4001  # 指定端口
jekyll server -w  s# 文件发生变化时，自动重新编译

gem 工具

gem 是 ruby 的包管理器。

更换 TAOBAO 源

gem sources --remove https://rubygems.org/
gem sources -a https://ruby.taobao.org/
gem sources -l

2.1 Linux/bsd 下安装

2.2 windows 下安装

Jekyll 是一个简单的网站静态页面生成工具。由于是用 Ruby 语音编写的，所以在 Windows 系统上配置起来还是稍微有点繁琐的。具体过程如下：

• 安装 Ruby：在 Windows 系统上当然使用 rubyinstaller 了， 猛击我下载 （笔者使用的版本是：Ruby 1.9.3-p545）
• 安装 Ruby DevKit： 猛击我下载
• 安装 Jekyll
• 安装 Python： 猛击我下载
• 安装 Pygments

以下是详细步骤：

1. 从 rubyinstaller 下载安装包并安装到某个磁盘中，比如：E:\Ruby192，在安装界面把所有的选项都勾选上；

2. 把下载的 DevKit 解压到某个目录，比如 E:\devkit , 在该目录中运行如下命令： > ruby dk.rb init

来生成一个 config.xml 配置文件，该配置文件中包含了前面的 Ruby 安装目录 （E:\Ruby192） 然后运行如下命令： > ruby dk.rb install

3. 然后运行如下命令安装 Jekyll： > gem install jekyll --version=2.5.3

现在可以开始使用 jekyll 了。如果您还需要使用代码高亮工具，则需要继续安装 Pygments ，过程如下：

4. 安装下载的 Portable Python（笔者使用的是 PortablePython_3.2.1.1.exe ），安装目录为 E:\Portable_Python_3.2.1.1

然后把 E:\Portable_Python_3.2.1.1\App\Scripts 和 E:\Portable_Python_3.2.1.1\App 目录分别添加到系统 Path 环境变量中

5. 把下载的 distribute-0.6.49.tar.gz 解压的某个目录（比如： E:\distribute-0.6.28 ), 猛击我下载

在该目录中运行如下命令：

> python distribute_setup.py

6. 然后通过如下命令来安装 pygments：

> easy_install Pygments

最后需要修改 2 处 Bug：

Pygmentize 中的 Bug：修改如下文件 E:\Ruby192\lib\ruby\gems\1.9.1\gems\albino-1.3.3\lib\albino.rb 修改的内容参考 这里

由于中文 XP 系统使用的 GBK 编码，GBK 编码导致 jekyll 处理的 bug，修改 E:\Ruby192\lib\ruby\gems\1.9.1\gems\jekyll-0.11.2\lib\jekyll\convertible.rb 这个文件，修改方式 参考这里

然后就可以使用 Jekyll 了，在生成静态页面的时候 可能还会出现 GBK 字符不能编码的问题，但是不影响生成网页了。

2.3 项目创建

第一步创建项目

jekyll new myjekyll

切换到 myjekyll 目录，运行下面的命令即可

jekyll server

然后打开浏览器的 127.0.0.1:4000 ，即可查看网站效果

2.4 文章导入

http://import.jekyllrb.com/

RSS

To import your posts from an RSS feed (local or remote), run:

$ ruby -rubygems -e 'require "jekyll-import";
  JekyllImport::Importers::RSS.run({
   "source" => "my_file.xml"
  })'

2.5 绑定域名 CNAME

双向指定 ：空间代码增加 CNAME 文件，域名管理商增加 CNAME 记录。

如果你不想用 http://username.github.com/jekyll_demo/ 这个域名，可以换成自己的域名。

具体方法是在 repo 的根目录下面，新建一个名为 CNAME 的文本文件，里面写入你要绑定的域名， 比如 example.com 或者 xxx.example.com 。

如果绑定的是顶级域名，则 DNS 要新建一条 A 记录，指向 204.232.175.78。如果绑定的是二级域名，则 DNS 要新建一条 CNAME 记录，指向 username.github.com （请将 username 换成你的用户名）。此外，别忘了将 _config.yml 文件中的 baseurl 改成根目录 / 。

至此，最简单的 Blog 就算搭建完成了。进一步的完善，请参考 Jekyll 创始人的 示例库 ，以及其他用 Jekyll 搭建的 blog 。

2.6 Jekyll 站点实例

站点示例： https://github.com/jekyll/jekyll/wiki/Sites

https://jimenbian.github.io/ --> http://www.garvinli.com/ 工作室的项目博客

http://yanhaijing.com --> https://yanhaijing.github.com/ 带分类和存档的个人博客

https://jeremywei.github.io/ --> http://weizhifeng.net/

http://www.zhanxin.info