Windows 8 で Jekyll のインストール

Windows 8 上で Ruby 製 Static Site Generator の Jekyll (ジキル)をインストールするための手順を書き留めておく。

Jekyll • Simple, blog-aware, static sites

環境

Windows 8 64bit

手順は次のとおりです。

  1. Ruby をインストール
  2. RubyDevKit (Ruby の開発キット)をダウンロードしてインストール
    DevKit-tdm-32-4.5.2-20111229-1559-sfx.exe
  3. Jekyll をインストール

Ruby をインストール

RubyInstaller Downloads ページからインストールします。

インストールしたら、ruby バージョン確認

ruby -v

gem バージョン確認

gem -v

DevKit をインストール

RubyInstaller Downloads ページから DevKit をダウンロードします。

  • DevKit-tdm-32-4.5.2-20111229-1559-sfx.exe

ダウンロードしたら、公式のドキュメントの通り、

C:\DevKit

に解凍してインストールします。

ダウンロードした圧縮ファイルは親のフォルダを持たないので、予め解凍先のフォルダを作っておく必要があります。(デスクトップに解凍してしまうと、デスクトップにファイルが配置されてしまうので注意が必要です。)

Development Kit · oneclick/rubyinstaller Wiki · GitHub

DevKit ディレクトリにファイルを解凍したら、PowerShell またはコマンドプロンプトを起動して
cd コマンドで DevKit ディレクトリに移動

cd c:\devkit

移動したら、ruby dk.rb init と入力してコマンドを実行します。

ruby dk.rb init
[INFO] found RubyInstaller v1.9.3 at C:/Ruby193

Initialization complete! Please review and modify the auto-generated
'config.yml' file to ensure it contains the root directories to all
of the installed Rubies you want enhanced by the DevKit.

config.yml という初期設定ファイルが作られます。

installing-jekyll-on-windows8_20130511

続いて、ruby dk.rb install と入力して devkit をインストールします。

ruby dk.rb install
[INFO] Installing 'C:/Ruby193/lib/ruby/site_ruby/1.9.1/rubygems/defaults/operating_system.rb'
[INFO] Installing 'C:/Ruby193/lib/ruby/site_ruby/devkit.rb'

これで DevKit のインストールは完了です。

Jekyll のインストール

コマンドプロンプトから gem install jekyll と入力して jekyll をインストールします。

gem install jekyll
Fetching: liquid-2.5.0.gem (100%)
Successfully installed liquid-2.5.0
Fetching: fast-stemmer-1.0.2.gem (100%)
Temporarily enhancing PATH to include DevKit...
Building native extensions.  This could take a while...
Successfully installed fast-stemmer-1.0.2
Fetching: classifier-1.3.3.gem (100%)
Successfully installed classifier-1.3.3
Fetching: directory_watcher-1.4.1.gem (100%)
Successfully installed directory_watcher-1.4.1
Fetching: syntax-1.0.0.gem (100%)
Successfully installed syntax-1.0.0
Fetching: maruku-0.6.1.gem (100%)
Successfully installed maruku-0.6.1
Fetching: kramdown-0.14.2.gem (100%)
Successfully installed kramdown-0.14.2
Fetching: yajl-ruby-1.1.0-x86-mingw32.gem (100%)
Successfully installed yajl-ruby-1.1.0-x86-mingw32
Fetching: posix-spawn-0.3.6.gem (100%)
Building native extensions.  This could take a while...
Successfully installed posix-spawn-0.3.6
Fetching: pygments.rb-0.4.2.gem (100%)
Successfully installed pygments.rb-0.4.2
Fetching: highline-1.6.18.gem (100%)
Successfully installed highline-1.6.18
Fetching: commander-4.1.3.gem (100%)
Successfully installed commander-4.1.3
Fetching: safe_yaml-0.7.1.gem (100%)
Successfully installed safe_yaml-0.7.1
Fetching: colorator-0.1.gem (100%)
Successfully installed colorator-0.1
Fetching: jekyll-1.0.1.gem (100%)
Successfully installed jekyll-1.0.1
Parsing documentation for liquid-2.5.0
Installing ri documentation for liquid-2.5.0
Parsing documentation for fast-stemmer-1.0.2
Installing ri documentation for fast-stemmer-1.0.2
Parsing documentation for classifier-1.3.3
Installing ri documentation for classifier-1.3.3
Parsing documentation for directory_watcher-1.4.1
Installing ri documentation for directory_watcher-1.4.1
Parsing documentation for syntax-1.0.0
Installing ri documentation for syntax-1.0.0
Parsing documentation for maruku-0.6.1
Couldn't find file to include 'MaRuKu.txt' from lib/maruku.rb
Installing ri documentation for maruku-0.6.1
Parsing documentation for kramdown-0.14.2
Installing ri documentation for kramdown-0.14.2
Parsing documentation for yajl-ruby-1.1.0-x86-mingw32
Installing ri documentation for yajl-ruby-1.1.0-x86-mingw32
Parsing documentation for posix-spawn-0.3.6
Installing ri documentation for posix-spawn-0.3.6
Parsing documentation for pygments.rb-0.4.2
Installing ri documentation for pygments.rb-0.4.2
Parsing documentation for highline-1.6.18
Installing ri documentation for highline-1.6.18
Parsing documentation for commander-4.1.3
Installing ri documentation for commander-4.1.3
Parsing documentation for safe_yaml-0.7.1
Installing ri documentation for safe_yaml-0.7.1
Parsing documentation for colorator-0.1
Installing ri documentation for colorator-0.1
Parsing documentation for jekyll-1.0.1
Installing ri documentation for jekyll-1.0.1
Done installing documentation for liquid, fast-stemmer, classifier, directory_watcher, syntax, maruku, kramdown, yajl-ru
by, posix-spawn, pygments.rb, highline, commander, safe_yaml, colorator, jekyll after 11 seconds
15 gems installed

Jekyll のインストールが完了です。;)

番外編: Windows 7 Pro 32bit に Jekyll をインストールしていたら PowerShell が小さくなった。

Windows 7 32bit に Jekyll をインストールしていたら PowerShell が急に小さくなってしまう事象に遭遇しました。

installing-jekyll-on-windows8_20130518_01

あうー!PowerShell ちいさっ…

installing-jekyll-on-windows8_20130518_02

原因は、現在のコードページが 1252 (ANSI – ラテン I) になっていることだった。

Jekyll をインストール中に、日本語から欧文に置き換わってしまったようだ。PowerShell で chcp (Change Code Page) コマンドを実行する。

PowerShell で chcp 932 と打ってシフトJIS コードへ変更する。

chcp 932

installing-jekyll-on-windows8_20130518_03

「プロパティ」(Alt + スペース,P)を開いて、オプションタブで現在のコードページが「 932 (ANSI/OEM – 日本語 Shift-JIS) 」になっていることを確認する。

これで問題は解決した。

ちなみに chcp と打つと現在のコードページを確認することができる。

この問題を解決するのに結構時間を費やしてしまった。