在 Windows 上安装运行 Jekyll


Jekyll 是一个静态网站生成工具。它允许用户使用 HTML、Markdown 或 Textile 来建立静态页面,然后通过模板引擎 Liquid(Liquid Templating Engine)来运行。

版权声明:本文为 frendy 原创文章,可以随意转载,但请务必在明确位置注明出处。


痛点:

缺少本地调试运行。

描述:

在初步搭起博客并发布第一篇 hello word 的时候,frendy 暴力跳过了本地调试运行,直接修改了源码往 github 上提交看效果,费时费力。

解决:

本地搭建 Jekyll 运行环境(Win10 64位),当然官方推荐是在 Linux, Unix, or Mac OS X 在运行。

步骤:

1.安装 Ruby

a).前往 http://rubyinstaller.org/downloads/

b).在 “RubyInstallers” 部分,选择某个合适的版本点击下载。这里 frendy 选择的是 rubyinstaller-2.3.3-x64。

java-javascript

c).通过安装包安装

  • 这里 frendy 保持默认的路径 C:\Ruby23-x64, 此外安装包明确提出 “请不要使用带有空格的文件夹 (如: Program Files)”。
  • 勾选 “Add Ruby executables to your PATH”,这样执行程序会被自动添加至 PATH 而避免不必要的头疼。

java-javascript

d).打开一个命令提示行并输入以下命令来检测 Ruby 是否成功安装

java-javascript

2.安装 DevKit

DevKit 是一个在 Windows 上帮助简化安装及使用 Ruby C/C++ 扩展如 RDiscount 和 RedCloth 的工具箱。

a).再次前往 http://rubyinstaller.org/downloads/

b).下载同系统及 Ruby 版本相对应的 DevKit 安装包。这里 frendy 选择的是 DevKit-mingw64-64-4.7.2-20130224-1432-sfx。

java-javascript

c).运行安装包并解压缩至某文件夹,如 C:\DevKit。

d).通过初始化来创建 config.yml 文件。在命令行窗口内,输入下列命令:

cd "C:\DevKit"
ruby dk.rb init
notepad config.yml

java-javascript

e).在打开的记事本窗口中,检查文件末尾是否友添加新的一行 - C:\Ruby23-x64,保存文件并退出。

java-javascript

f).回到命令行窗口内,审查(非必须)并安装。

ruby dk.rb review
ruby dk.rb install

java-javascript

3.安装 Jekyll

a).确保 gem 已经正确安装。

gem -v

java-javascript

b).安装 Jekyll gem

gem install jekyll
4.安装 Pygments

Jekyll 里默认的语法高亮插件是 Pygments。 它需要安装 Python 并在网站的配置文件_config.yml 里将 highlighter 的值设置为pygments。

不久之前,Jekyll 还添加另一个高亮引擎名为 Rouge, 尽管暂时不如 Pygments 支持那么多的语言,但它是原生 Ruby 程序,而不需要使用 Python。 更多信息请点此关注。

java-javascript

5.启动 Jekyll

按照官方的 Jekyll 快速开始手册 的步骤,一个新的 Jekyll 博客可以被建立并在 localhost:4000 浏览。

jekyll new myblog
cd myblog
jekyll serve

这里 frendy 直接进入自己的博客目录执行如下:

java-javascript

6.后续问题

a).晚上吃完烤鱼回来重新打开电脑启动时却遇到如下问题: java-javascript

=> 修改 _config.yml 里的 highlighter: pygments 为 highlighter: rouge 避免了该问题。


欢迎来撩

frendy

It will shine for us...