Tweet
Jekyll
Jekyll を Windows に導入するとき注意すること
Jekyll を Windows で用意する場合には大変苦労するかもしれません。バージョンや環境による影響が大きいからです。導入方法については、多くの方が Web で公開しているので、ここでは注意するべき点について述べておきます。どうしても Jekyll が Windows 環境下に導入できないときは、次のことを確認してみるべきです。
著者が導入時に参考にしたものの内、最も良い資料は次のページのものでした。英語のページですが、それほど難しいことは書かれていません。次のページを読みながら進めれば、問題なく Jekyll をセットアップすることができるでしょう。
このページの内容は、紹介したページの内容から、重要であったものをいくつか抜粋して解説しています。
Windows(OS), Ruby, DevKit, Jekyll のバージョンを確認する。
まず初めに結論から述べると、次の組み合わせが良いようです。OS が 32bit の場合には x32 系を、64bit の場合には x64 系を選択してください。
- Ruby 1.8.6 ~ 1.9.3
- DevKit tdm-32-4.5.2
- Ruby 2.0.0
- DevKit mingw64-32-4.7.2
- Ruby 2.0.0 x64
- DevKit mingw64-64-4.7.2
Ruby.2.1x, 最新の Devikit, Jekyll の組み合わせでは、Jekyll が導入できませんでした。発生したエラーのうち、いくつかを手動で解決しましたが、それでもなおエラーが発生し、あらゆる環境下で再現が困難な状況に陥ります。これでは移植が容易である利点を損ないます。
Jekyll を Windows で利用する場合には、Ruby のバージョンを最新にすることをあきらめた方が良いかもしれません。もしも他の Ruby で動作するプロダクトが、最新の Ruby でなければ動作しないのであれば、それは Jekyll の方を諦めるか、複数インストールして、うまく使い分けるしかありません。
インストールするディレクトリには全角文字(2byte)および半角スペースを含めない。
Ruby, Devkit, Jekyll, (Python) をインストールするディレクトリには、全角文字列および半角スペースを含めないでください。見落としがちですが、半角スペースが含まれると、Jekyll をセットアップすることができません。Ruby そのものは正常に動作するので見落とすことになります。
Jekyll のページ中にある {{ について
記号 "{" が2つ続けて "{{" と書かれると、Jekyll に含まれるテンプレートエンジン Liquid が、そのテキストを変数であると認識します。これは実際にはソースコードであったり、変数でないことが保障されるテキストであっても発生する問題です。
例えば、Jekyll のページ中に、Markdown とは異なるマークアップ言語を採用し、その構文の中に {{ がある場合などが該当します。Liquid が処理されるのは、Jekyll のページがコンパイルされた後(の様)です。しかしながら、ページのコンパイルによって {{ がページの内容から失われる場合にも、Jekyll からのコンパイルの実行時に、Liquid が無効なエラーを通知します。あるいは、Liquid が変数として {{ から始まるテキストを認識してしまいます。
この問題は現在のところ解決されません。議論されたことはあるようですが、2014年現在で最新の Jekyll では問題の解決を確認できませんでした。一時的な解決策としては、{{ から始まるテキストを何かの方法でエスケープすることです。2つの記号の間に半角スペースを入れるなどすると、Liquid はテンプレートの一部として認識しなくなります。