トラブルシューティング

あなたが今までJekyllのインストールや使用した際に問題が発生した場合、 いくつか助けになるかもしれないヒントがあります。以下にあるヒントでも解決しない場合、 その問題を報告(英語) してください。そうすることで Jekyll コミュニティはすべての人によりよい体験を与えられます。

インストールでの問題

もしあなたがgem インストールにおいてエラーに遭遇したら, あなたはruby 1.9.1 用の拡張モジュールをコンパイルするためのヘッダファイルをインストールする必要があります。 Ubuntu や Debian 上で以下を実行することでインストールできます。

sudo apt-get install ruby1.9.1-dev

Red Hat、CentOSやFedoraのシステム上では以下を実行することでインストールできます。

sudo yum install ruby-devel

NearlyFreeSpeech では、あなたはJekyllを インストールする前に次のコマンドを実行する必要があります:

export GEM_HOME=/home/private/gems
export GEM_PATH=/home/private/gems:/usr/local/lib/ruby/gems/1.8/
export PATH=$PATH:/home/private/gems/bin
export RB_USER_INSTALL='true'

OSXでは、RubyGemsの更新をする必要があります:

sudo gem update --system

それでもまだ問題がある場合は、 [Xcodeを使ってコマンドラインツールをインストールする] (http://www.zlu.me/ruby/os%20x/gem/mountain%20lion/2012/02/21/install-native-ruby-gem-in-mountain-lion-preview.html) 必要があります。 コマンドラインツールをインストールすることで、次のコマンドを使ってネイティブのgemsをインストールすることができます。

sudo gem install jekyll

GentooでのRubyGemsのインストール:

sudo emerge -av dev-ruby/rubygems

Windows ではRubyInstaller DevKit をインストールする必要があります。

Jekyllの実行での問題

Debian や Ubuntuでは、あなたのターミナルで jekyll コマンドが実行できるようにするために PATHに /var/lib/gems/1.8/bin/ を追加する必要があります。

Base-URL の問題

もし、あなたが次のようなbase-urlオプションを使用している場合:

jekyll serve --baseurl '/blog'

… その時は次の様にしてあなたのサイトにアクセスできることを確認してください:

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

以下にアクセスしてもうまく動きません:

http://localhost:4000/blog

設定での問題

構成設定の競合の優先順位は次のとおりです:

  1. コマンドラインフラグ
  2. 設定ファイルでの設定
  3. デフォルト値

それは、次のとおりです: デフォルト値は_config.ymlで指定されたオプションで上書きされて、 そしてコマンドラインで指定されたフラグは、他の場所で設定されたすべての設定を上書きします。

マークアップでの問題

Jekyllが利用する様々なマークアップエンジンはいくつかの問題があることがあります。この ページには、同じ問題が発生する可能性のある他の人を助けるためにそれらをドキュメント化します。

Maruku

もし、あなたのリンクにエスケープが必要な文字が含まれていた場合、次の文法を使う必要があります:

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

中身が空のタグがある場合、例えば<script src="js.js"></ SCRIPT>、Marukuは 次のように変換します<script src="js.js" />。 これはFirefoxやおそらく他のブラウザでも問題を引き起こし、 非推奨なXHTMLになります。 簡単な修正は開始タグと終了タグの間にスペースを入れることです。

Liquid

最新版のバージョン2.0では、テンプレートでの{{の利用を壊すようです。 以前のバージョンとは異なり、バージョン2.0での{{の利用は以下のエラーの引き金になるようです:

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

抜粋

v1.0.0 以降、Jekyllは投稿の抜粋を自動生成します。 v1.1.0 以降のJekyllではこれらの抜粋をLiquidに通すと参照が存在しないか、 タグが閉じられていないという奇妙なエラーを引き起こすことがありました。 もし、あなたがこれらのエラーに遭遇した場合、_config.ymlexcerpt_separator: ""を 設定してみてください。あるいはそれに意味のない文字列を設定してみてください。

あなたが遭遇した問題を報告してください!

もしバグに遭遇した場合、GitHubにIssueを作成し、 問題と、あなたが見つけた回避策があればそれも記述してください。 そうすれば、我々がそれをこのページに文書化して共有することができます。