2

在Windows系统配置Jekyll

 3 years ago
source link: https://yanhaijing.com/jekyll/2011/12/30/run-jekyll-on-window/
Go to the source link to view the article. You can view the picture content, updated content and better typesetting reading experience. If the link is broken, please click the button below to view the snapshot at that time.
在Windows系统配置Jekyll
30 December 2011
号外号外:我的新书《React状态管理与同构实战》出版啦!!!快点我查看

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

  1. 安装Ruby:在Windows系统上当然使用rubyinstaller了, 猛击我下载 (笔者使用的版本是:Ruby 1.9.3-p545)
  2. 安装Ruby DevKit: 猛击我下载
  3. 安装Jekyll
  4. 安装Python: 猛击我下载
  5. 安装Pygments

以下是详细步骤:

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

140.png

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:

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

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

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

笔者最近安装了最新版的jekyll,已经不存在需要修复两处bug的问题了,安装到第六步就ok了,上面提到的gbk编码问题,可用如下方法解决,在cmd窗口输入如下命令,临时改变编码。

> chcp 65001

原文网址:http://yanhaijing.com/jekyll/2011/12/30/run-jekyll-on-window/

微信公众号:颜海镜关注微信公众号 颜海镜微信支付二维码赞赏支持 微信扫一扫

About Joyk


Aggregate valuable and interesting links.
Joyk means Joy of geeK