常見問題

如果你在安裝或者使用 Jekyll 的過程中遇到了問題，這里有一些建議也許可以幫助到你。如果你所遇到的問題沒有包含在下面，請?zhí)峤灰粋€ issue，這樣 Jekyll 團隊才能讓每個人有更好的使用體驗。

安裝問題

如果你在安裝 gem 的過程中遇到問題，可能你需要安裝為 ruby 1.9.1 的拓展模塊編譯所需要的頭文件，在 Ubuntu 或 Debian 系統(tǒng)中安裝可以通過運行：

sudo apt-get install ruby1.9.1-dev

在 Rdd Hat，CentOS 和 Fedora 系統(tǒng)中安裝你可以通過運行：

sudo yum install ruby-devel

在 NearlyFreeSpeech 中你需要在運行命令的時候添加下面的環(huán)境變量：

RB_USER_INSTALL=true gem install jekyll

在 OSX 系統(tǒng)中你可能需要升級 RubyGems：

sudo gem update --system

如果你還是遇到問題，你可能需要使用 XCode 來安裝命令行工具

sudo gem install jekyll

在 Gentoo 上安裝 RubyGems：

sudo emerge -av dev-ruby/rubygems

在 Windows 下你可能需要安裝 RubyInstaller DevKit。

運行 Jekyll 時的問題

在 Debian 或者 Ubuntu 系統(tǒng)中，你可能需要在 path 里添加 /var/lib/gems/1.8/bin/ 來使 jekyll 命令可以在終端中執(zhí)行。

Base-URL 問題

如果你正在這樣使用 base-url 選項：

jekyll serve --baseurl '/blog'

… 那么你需要在訪問網(wǎng)頁的時候使用：

http://localhost:4000/blog/index.html

這樣訪問會出現(xiàn)錯誤：

http://localhost:4000/blog

配置問題

沖突的配置設(shè)置的優(yōu)先順序如下：

1. 命令行標志
2. 配置文件設(shè)置
3. 默認配置

也就是說，默認配置會被 _config.yml 中指定的選項所覆蓋，而在命令行中指定的參數(shù)配置會覆蓋其它地方的配置。

Markup 問題

Jekyll 所使用的不同的 Markup 引擎可能會有一些問題。下面的文件可能會幫助你如果你遇到類似的問題。

Maruku

如果你的鏈接中有一些需要避免的的詞，你需要這樣寫：

![Alt text](http://yuml.me/diagram/class/[Project]->[Task])

如果你有一個空的標簽，比如 <script src="js.js"></script>，Maruku 會將它轉(zhuǎn)換成 <script src="js.js" />。 這將會在火狐或者其它瀏覽器中出現(xiàn)問題，而且在 XHTML 中不推薦使用。一個簡單的避免方法就是在起始標簽和結(jié)束標簽之間放一個空格。

RedCloth

4.1.1 和更高的版本將不支持 notextile 標簽。這是一個已知的 bug可能有希望在 4.2 版本中得到修復(fù)。你可以繼續(xù)使用 4.1.9 版本，但是測試套件需要安裝 4.1.0 版本。如果使用一個不支持 notextile 標簽的版本， 你可能需要注意 Pygments 的語法高亮格式會不正確，還有其它一些可能的問題。如果你遇到這個問題你只需要安裝 4.1.0 版本。

Liquid

最新的 2.0 版本似乎打破了 {{ 在模板中的使用，不再類似以前的版本，在 2.0 版本使用 {{ 會出現(xiàn)以下問題：

'{{' was not properly terminated with regexp: /\}\}/  (Liquid::SyntaxError)

摘要

從 V1.0.0 版本開始，Jekyll 已經(jīng)可以自動生成文章摘要。 一直到 v1.1.0 版本，Jekyll 仍使用Liquid 來傳遞摘要，這將會在引用不存在或標記沒有被關(guān)閉時造成奇怪的問題。如果你遇到了這些問題，你可以嘗試將在 _config.yml 中設(shè)置 excerpt_separator: "" 或設(shè)置成不敏感的字符。