Jekyll在windows下的本地环境搭建

12 Apr 2014

安装Ruby和DevKit

推荐在win7下使用的版本

rubyinstaller-1.9.3-p448.exe直接安装即可,安装路径不要含有空格。

DevKit解压到C:\devkit下,依次执行下面的命令安装

$ cd /D C:\devkit
$ ruby dk.rb init
$ ruby dk.rb install

安装Jekyll

1. 修改rubygems源

使用淘宝(http://ruby.taobao.org/)的rubygems源

$ gem sources --remove https://rubygems.org/
$ gem sources -a http://ruby.taobao.org/
$ gem sources -l
*** CURRENT SOURCES ***

http://ruby.taobao.org
# 请确保只有 ruby.taobao.org
$ gem install rails

2. 安装Jekyll

$ gem install jekyll

查看Jekyll版本

jekyll -v

3. 启动Jekyll服务器

jekyll serve

启动服务器后,浏览器输入 http://127.0.0.1:4000/ 访问搭建的博客。

若干错误的解决

1. Jekyll serve “Error: Invalid argument"错误

降级Jekyll版本到1.4.2

$ gem uninstall jekyll
$ gem install jekyll --version "=1.4.2"

2. Jekyll serve “invalid byte sequence in GBK”

中文编码问题

找到jekyll安装目录,修改convertible.rb文件

C:\Ruby193\lib\ruby\gems\1.9.1\gems\jekyll-1.4.2\lib\jekyll\convertible.rb

第38行

self.content = File.read_with_options(File.join(base, name), merged_file_read_opts(opts))

替换为下面内容

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

参考链接

  1. Windows 安装 Jekyll 若干问题的解决
  2. jekyll本地环境搭建(Windows)
  3. Jekyll serve “Error: Invalid argument” issue
  4. 在 Windows 上安装 Jekyll
  5. Jekyll 笔记
  6. Jekyll在github上构建免费的Web应用
Tagged: jekyll   windows  


Comments: