Run Jekyll on Windows Part 1

一．安装Ruby 和 Ruby DevKit

 

Ruby 是一门编程语言，Jekyll 就是用Ruby写的。因此为了运行Jekyll,你需要安装Ruby和相关的开发工具DevKit，用来建立一些Jekyll依赖的本地扩展。

 

1．  安装Ruby

首先，到Ruby官网下载安装最适合你的电脑的installer。

http://rubyinstaller.org/downloads/

推荐2.1.7版本的。

安装的时候，请选择 Add Ruby executables to your PATH， 将ruby加入环境变量中。如果安装时没有勾选，也可以之后手动添加，在此不表。

至于安装位置，推荐在某盘下第一层目录，如C:/Ruby21。

 

        2. 安装 Ruby DevKit

同样在上面那个链接，左下方有DEVELOPMENT KIT，选择适当的版本下载并解压。解压路径推荐为之前的Ruby安装路径下的DevKit文件夹，如C:/Ruby21/DevKit。或者C:/RubyDevKit （比较正式的推荐，但我没有采用，因为那样的话一级目录太多，个人不是很喜欢。一般推荐装C盘，基于同样的原因，我选择的是D盘）。

                   打开Ruby DevKit解压到的文件夹。

                   在该文件夹下启动cmd。

         （或者以任意你乐意的方式，在cmd中进入Ruby DevKit的文件夹，进行接下来的操作。这里我比较推荐Windows PowerShell，打开该工具，输入 cd %你的文件夹绝对路径% 即可）。

接下来初始化。命令：rubydk.rb init。此处相当于直接调用ruby来初始化这个开发环境，因此如果没有将ruby加入环境变量path的话将无法执行。

正常的话，此时将提示你初始化完成。并且有英文提示，在原路径下生成了一个config.yml文件。

然后按照英文提示，用编辑器等打开config.yml文件。文件中有英文说明及示例，可参照。简言之，就是在这个确认config文件中，指明ruby的安装位置，如前文所述的C:/Ruby22。

                   修改后，保存文件。

         回到cmd（或powershell）中，修改文件的时候不要把这个给关闭了，如果关闭了，请重新启动到原路径。

                   终于要安装DevKit了！！！之前的只是解压。。。

                   输入命令 rubydk.rb install 并回车。

                   第一步大功告成！

 

二．安装Jekyll Gem

1.       启动你最喜欢的命令行工具并进入以下命令：gem install jekyll。（这句可是照原文翻译。。然而我觉得对于新手来说仍然没有表述清楚，应该启动到原来那个开发工具文件夹下才对嘛，不然就是错误。。呜呜。。。）

2.      然后可爱的命令行工具就将抛出几行英文咯。大致就是说成功安装jekyll, Jekyll的文档也解析好安装好啦。

Github推荐的教程中说到，The latest version of Jekyll at the time of writing is v2.4.0, whichis compatible with Windows. Most of the previous versions are, too. Do notattempt to install Jekyll v1.4.3, though, which is known to be incompatiblewith Windows.

 

意思就是说有个老版本是不行的。但是时过境迁，那个老版本已经彻底老了，现在都是3.0.0，那个才1.4.3……

3.      这个时候Jekyll就已经安装好了。接下来怎么用呢？

三．安装语法高亮器（SyntaxHighlighter）[请无视我蛋疼的翻译]

继续翻译原文。

总览：不管你是在用Markdown还是HTML，Jekyll 都能让你轻松插入漂亮的代码块到你的页面中。Jekyll默认“伴随”（其实原文是comes with，不知翻译成什么好，反正知道他们是搞在一起的咯）一个基于python 的语法高亮器：pygments.rb。为了在windows上使用，你需要安装python和一些额外的工具。有一个很棒的替代品是基于ruby的Rouge （口红！！！忽然觉得语法高亮器还真的有点像口红呢~），这个工具安装起来更快更容易（那还说什么，就装这个噻）, 但是不支持许多像pygments这样的语言。（第一次听说这个家伙哈，特意去官网逛了一下，pygments.org，约莫瞅了一眼，应该是一个“大众开发万众创新”的社区，可以高亮超过300门编程语言的东西,官方解释为python syntax highlighter）

接下来不这样翻译了，干事！

1.      安装Rouge。

都说了这个简单粗暴，所以首先还是用这个吧。

gem installrouge

2.      然后又成功了！和安装jekyll是一毛一样的成功。多亏了ruby的gem工具，就像python的easy_install工具一样！（话说python的这个一看就明白哈，gem到底什么鬼，宝石珍宝精华？？？不过用宝石装饰这个及物动词的解释倒是有点像~和rouge一样生动呢）

3.      然后呢，打开你的_config.yml，设置rouge为你的默认syntax highlighter。

Highlighter:rouge

说是这么说啊，我并没有找到_config.yml文件啊，只有原来那个config.yml啊！！难道是作者笔误？其实并不是，我倒是感觉作者的步骤顺序错了,应该是要先按照https://help.github.com/articles/using-jekyll-with-pages/

Setting upJekyll创建一个站点目录才行吧。

4.      在你的网站目录下打开命令行工具，jeklly new YOUR_JEKYLL_SITE，这样在该目录下会生成一个YOUR_JEKYLL_SITE目录。里面有相当多文件了（这个时候就有_config.yml文件了嘛）。

5.      然后cd YOUR_JEKYLL_SITE，打开该目录（Jekyll站点目录）

6.      然后初始化。git init。因为是github嘛，所以就git咯。

7.      对了，站点目录下那个_config.yml文件可是有很多东西需要设置的。比方说可以在这里添加highlighter：rouge啊。当然还有更多，看看这个config文件就知道啦。

8.      然后jekyll serve 就行了。命令行工具给出了很多信息。注意看server address一行，应该默认是http://127.0.0.1:4000/，你在浏览器输入这个地址，就是进入到Jekyll的欢迎界面了。具体jekyll的使用还需要学习，加油~

推荐文章：

http://www.ruanyifeng.com/blog/2012/08/blogging_with_jekyll.html

 

看完这篇文章，我大致有了一点思路。不过暂时遇到了莫名其妙的困难。我试过以jekyll new 一个站点目录作为仓库上传到github，也试过将jekyll build生成的目录作为仓库传到github，但结果都是一样的，相应网址显示不正常，虽然有部分我写入的信息，而且指向博客等目录的链接失效。而在本地jekyll server是正常的。