kb

GitHub Pages用Jekyllの私的導入手順。

Rubyのインストール

1. RubyInstaller for WindowsからRuby+Devkit（太字のバージョンが推奨）をダウンロードし、既定値のオプションでインストール
   Use UTF-8 as default external encoding.はオンで。

2. 最後の段階でrick installを実行

3. ruby -vを実行し、バージョンが表示されればインストール完了

Rubyのバージョン変更

1. 必要なバージョンのRuby+Devkitを通常通りインストール

2. ユーザー環境変数のPathから使わないバージョンのパスを削除

Jekyllのインストール

1. gem install jekyll bundler
   

2. jekyll -vでバージョンが表示されればインストール完了

Bundlerのインストール

1. gem install bundler
   

2. bundler -vでバージョンが表示されればインストール完了

Gemのインストール

1. Gemfileの内容を編集

   source "https://rubygems.org"
   
   gem "github-pages", "~> 232", group: :jekyll_plugins
   
   platforms :mingw, :x64_mingw, :mswin, :jruby do
     gem "tzinfo", "~> 1.2"
     gem "tzinfo-data"
   end
   

   • jekyllやプラグインのgemは今のところ不要なのでコメントアウトしておく。

   • github-pagesのバージョンはDependency versionsを参照。

2. Gemfileのあるディレクトリでbundle installを実行

Jekyllの起動

1. ローカルサイトのルートディレクトリでbundle exec jekyll serveを実行

   • published: falseのポストを表示するには--unpublishedを加える。

   • タイムゾーンの関係で表示されない場合は--futureを加える。

2. http://localhost:4000/で正常にページが表示されれば完了
   _config.ymlにbaseurlを設定している場合はhttp://localhost:4000/baseurl/になる。

設定ファイルの更新が反映されない場合

1. bundle exec jekyll buildを実行

(Bundler::GemNotFound)や(Gem::LoadError)が出る場合

1. bundle updateを実行

Gemその他

Gemの更新

1. Gemfileのあるディレクトリでbundle updateを実行

Gemの全削除

1. Gemfileのあるディレクトリで以下を実行

   gem uninstall -aIx --user-install --force
   

Gemの一覧表示

1. Gemfileのあるディレクトリでgem listを実行