Jekyll 学习

Jekyll 的安装

安装

Jekyll 最好的安装方法就是通过 RubyGems 来安装:

gem install jekyll

Jekyll 需要以下的 gems: directory_watcher,liquid,open4,marukuclassifier。这些组件将会在 gem 的安装命令之后自动安装。

如果你在 gem 的安装过程中遇到错误,你可能需要安装 ruby1.9.1 的编译扩展组件的头文件。如果是 Debian 系统,你可以这样做:

sudo apt-get install ruby1.9.1-dev

如果是 Red Hat、CentOS 或 Fedora 系统,你可以这样做:

sudo yum install ruby-devel

NearlyFreeSpeech 上,你需要:

RB_USER_INSTALL=true gem install jekyll

如果你在 Windows 操作系统上遇到像 Faild to build gem native extension 这样的错误,你可能需要安装 RubyInstaller DevKit

在 OSX 上,你可能需要升级 RubyGems:

sudo gem update --system

如果你见到 missing headers 这样的错误,你可能还需要为 Xcode 安装命令行工具,你可以从 这里 下载。

从 LaTex 到 PNG

Maruku 本身对从 LaTex 到 PNG 的转换是可选的,它是通过 blahtex(Version 0.6) 完成的。但是,blahtex 必须和 dvips 一起放在你的 $PATH 中。

注意:你需要自己设置 dvips 的位置,因为 remi's fork of Maruku 不会固定它的位置)

RDiscount

如果你希望使用 RDiscount 来渲染 markdown,而不是 Maruku,只要确保 RDiscount 被正确地安装:

sudo gem install rdiscount

然后运行 Jekyll,并使用以下的参数选项:

jekyll --rdiscount

你可以在你的 _config.yml 中写入如下代码,从而不必指定标志

markdown: rdiscount

Pygments

如果你希望在你的文章中通过 highlight 标签实现代码高亮,你需要安装 Pygments

在 OS X Leopard 和 Snow Leopard上 :

它和 Python2.6 已经预装了:

sudo easy_install Pygments

或者在 OS X 中使用 MacPorts:

sudo port install python25 py25-pygments

或者在 OS X中 使用 HomeBrew

brew install python
#export PATH="/usr/local/share/python:$(PATH)"
easy_install pip
pip install --upgrade distribute
pip install pygments

注意:Homebrew 并不会为你自动链接到可执行文件。对于 Homebrew 默认的 Cellar 路径和 Python2.7 来说,确保把/usr/local/share/python 添加到你的 PATH 中。想要了解更多信息,请查看 这里

在 Archlinux 上:

sudo pacman -S python-pygments

或者使用 python2 版的 pygments:

sudo pacman -S python2-pygments

注意:python2 版本的 pygments 创建一个名为 pygmentize2 的可执行文件,而 Jekyll 会尝试寻找 pygmentize。创建一个执行链接 # ln -s /usr/bin/pygments2 /usr/bin/pygmentize 或者使用 python3 版的 pygments 都是可以的。(这条建议似乎已经过时了,因为 python2 版的 pygments 现在确实安装 pygmentize)

在 Unbutu 和 Debian 上:

sudo pat-get install python-pygments

在 Fedora 和 CentOS 上:

sudo yum install python-pygments

在 Gentoo 上:

sudo emerge -av dev-python/pygments