インストール

Jekyll は数分でインストールと運用準備ができます。 もし、それが悩みの種となっていたら、issue(英語)に あなたが遭遇した問題を報告することで(または、プルリクエスト送信で)、我々がプロセスを より簡単に変更するかもしれません。

必要条件

Jekyll のインストールは簡単で単純明快です。 しかし、いくつかの必要条件があり、 インストールを始める前にあなたのシステムで 使用されていることを確かめる必要があります。

  • Ruby
  • RubyGems
  • Linux, Unix または Mac OS X
  • NodeJSか、あるいは別のJavaScriptランタイム(CoffeeScriptをサポートするため)
Jekyll を Windows で実行する

Windowsは公式にはサポートしていませんが、Windows上でJekyllを実行できるかもしれません。 Windows向けのドキュメントページに、説明があります。

Rubygems を使ったインストール

Jekyll をインストールする最もよい方法は RubyGems を経由する事です。 ターミナルプロンプトで、単純に Jekyll をインストールするには 以下のコマンドを実行します。

$ gem install jekyll

Jekyll の gem の全ての依存関係は、上記のコマンドで自動的にインストールされるため、 あなたはそれらについて心配する必要はありません。 もし Jekyll のインストールに問題が発生した場合、 Jekyll コミュニティは、皆のための体験を向上できるので トラブルシューティング ページをチェックするか、 その問題を報告(英語) してください。

Xcode コマンドラインツールをインストール

ネイティブ拡張を利用したJekyllの依存関係をインストールする際に問題が生じた場合、 あなたがMax OS Xを使っているなら、Xcodeと、 付属のコマンドラインツールをインストールする必要があるでしょう。 ダウンロードは、 Preferences → Downloads → Components.

Pre-releases

pre-release をインストールするためには、必要なものをインストールした状態で、以下を実行してください。

gem install jekyll --pre

このコマンドで、最新の pre-release がインストールできます。もし、特定のバージョンの pre-release を使いたい場合は -v オプションを使い、インストールしたいバージョンを指定してください。

gem install jekyll -v '2.0.0.alpha.1'

もし、開発バージョンの Jekyll をインストールしたい場合、少し手順が複雑です。 開発バージョンでは最新の素晴らしい利点を得ることができますが、安定性に欠ける恐れがあります。

$ git clone git://github.com/jekyll/jekyll.git
$ cd jekyll
$ script/bootstrap
$ bundle exec rake build
$ ls pkg/*.gem | head -n 1 | xargs gem install -l

その他の追加機能

Jekyll には、インストールした方がよい、 Jekyll の使用プランに応じてサポートする いくつかの(オプションの)追加機能があります。 これらの追加は LaTeX サポートやコンテンツレンダリングエンジンの選択を含みます。 詳細については the extras page をチェックしてください。

ProTip™: シンタックスハイライト有効化

Jekyll を使用している人ならば、 Pygments を使用して シンタックスハイライトを有効化したほうがよいでしょう。 これ以上進む前にやり方を調べるべきです。

今やあなたは全てをインストールしたに違いないのだから、さあ取り掛かろう!