scribble

Leon's scribble.

About Email GitHub

07 Sep 2013
Windows 系统 Jekyll 博客搭建手记

前言

准备把博客从 Wordpress 搬到 Github,Jekyll成为我的首选,这里主要介绍 Windows 系统本地搭建的步骤。以前照着网上的介绍操作过,但是没有成功过,遇到了不少问题,今天翻了很多的资料,算是找到了一种比较可行 的方法,之前看到过的网上教程中大都有要求 Ruby,Devkit 的具体某个版本,今天发现全部用最新的版本,也是可以的。


安装 Ruby 环境和 DevKit

直接到 rubyInstaller 官网下载,目前最新的版本分别是 Ruby 2.0.0-p247 (x64)DevKit-mingw64-64-4.7.2-20130224-1432-sfx.exe ,我的系统是 64 位,32 位的话选择对应版本, 先安装 Ruby 环境,注意,必须先安装 Ruby 环境,为免混乱,可以解压至 C:\Ruby , Ruby 安装成功之后安装 DevKit,同样解压至 C:\DevKit


配置

a.打开命令行终端(CMD),运行以下命令:

cd C:\DevKit

ruby dk.rb init

ruby dk.rb install

b.完成之后安装 Jekyll:

gem install jekyll

可以用 jekyll --version 来检查是否安装成功

c.安装 rdiscount,这个是用来解析 Markdown 标记的解析包。

gem install rdiscount

运行

cd 到工程目录,目前网上大部分教程说的启动服务命令 jekyll --serve 都已过时,正确的应该是:

jekyll serve

中文支持异常情况

你可能会遇到下面这种情况:

D:\WebstormProjects\superraytin.github.com>jekyll serve
Configuration file: D:/WebstormProjects/superraytin.github.com/_config.yml
       Deprecation: Auto-regeneration can no longer be set from your configurati
on file(s). Use the --watch/-w command-line option instead.
            Source: D:/WebstormProjects/superraytin.github.com
       Destination: D:/WebstormProjects/superraytin.github.com/_site
      Generating... Error reading file D:/WebstormProjects/superraytin.github.co
m/_posts/life/2013-05-23-i-am-a-test.md: invalid byte sequence in GBK
error: invalid byte sequence in GBK. Use --trace to view backtrace

或者下面这种情况

D:\WebstormProjects\superraytin.github.com>jekyll serve
Configuration file: D:/WebstormProjects/superraytin.github.com/_config.yml
       Deprecation: Auto-regeneration can no longer be set from your configurati
on file(s). Use the --watch/-w command-line option instead.
            Source: D:/WebstormProjects/superraytin.github.com
       Destination: D:/WebstormProjects/superraytin.github.com/_site
      Generating...   Liquid Exception: invalid byte sequence in GBK in _posts/s
kill/2011-12-29-jekyll-introduction.md
error: invalid byte sequence in GBK. Use --trace to view backtrace

目前网上流传的一些解决办法

1.http://yanping.me/cn/blog/2012/10/09/chinese-charset-problems-with-jekyll/ 这篇文章给出的解决办法: 修改 bash 的字符集:在 C:\Documents and Settings\ 用户名下,找到文件 .bash_profile,后面加两行:

set LCALL=enUS.UTF-8

set LANG=en_US.UTF-8

这种方法经过测试并不能解决问题

2.http://www.dewen.org/q/5893 给出的解决办法:

a: 在文件头加上

# -*- coding:utf-8 -*-

指定运行环境的编码

ruby --encoding=utf-8

b: 运行

chcp 65001

前面一种直接无效,后面一种可以起到短暂的效果,但是会有部分功能失效的问题,并且文章打开丢失了模板的头尾,只剩下乱码的文章主体部分。


终极解决办法

解决第一种错误——打开路径 C:\Ruby200-x64\lib\ruby\gems\2.0.0\gems\jekyll-1.2.0\lib\jekyll,打开 convertible.rb

找到:

self.content = File.read(File.join(base, name))

替换成:

self.content = File.read(File.join(base, name), :encoding => "utf-8")

解决第二种错误——打开路径 C:\Ruby200-x64\lib\ruby\gems\2.0.0\gems\jekyll-1.2.0\lib\jekyll\tags,打开 include.rb

找到:

source = File.read(File.join(includes_dir, @file))

替换成:

source = File.read(File.join(includes_dir, @file), :encoding => "utf-8")

重启 Jekyll 服务,编译成功。


markdown 解释中文列表的问题

Jekyll 默认的 markdown 解释引擎是 maruku,在解释列表的时候,列表中有英文字符正常,否则会不正常,这种情况需要把解释引擎切换为 rdiscount, 具体方法是打开 _config_yml 文件,在 pygments:true 下面添加一行

markdown: rdiscount

参考资料

http://log.medcl.net/item/2012/04/jekyll-encounter-encoding-problems/

http://www.cnblogs.com/purediy/archive/2013/03/07/2948892.html

http://cloudaice.com/markdown-list-chinese-problem/

其他

Jekyll 环境搭好之后,每次启动服务都需要 cd 到工程目录,然后运行命令 jekyll serve

是不是觉得有点繁琐呢?

反正我是觉得很烦,这里写了个短小的批处理文件,可以当作是一键启动服务的开关,打开记事本,将下面的命令行拖到里面保存为 .bat 文件,放到桌面上,以后双击即可启动服务。

@echo
cd D:\WebstormProjects\jekyllBlog
D:
jekyll serve
pause

批处理文件执行效果:


Til next time,
Leon at 22:27

scribble

About Email GitHub