Jekyll Theme
Minimal Mistakesの手動やGemでのインストールや、あと他にもいくつか。
Jekyll用テーマ
あちこちにいろいろ。
当方はMinimal Mistakesを使うことに。
Minimal Mistakesを導入 手動編
インストール
Minimal Mistakesからインストール。
$ git clone [email protected]:/minimal-mistakes.git
Quick Start Guideを参考に、要らないファイルを削除。
Gemfile書き換え。
で、コマンド実行。
$ bundle update
$ bundle exec jekyll serve
エラーが出たので、潰していく。
エラー潰し
エラーメッセージを見ると、gem installしたやつがバージョンに合わないらしい。
gem list hogeで確認して、合わないバージョンのはgem uninstall -v x.x.x hogeで削除。
今度はNo GitHub API authentication...というエラーが出てきた。
“No GitHub API authentication” error #399を参考に、
_config.ymlに追記。ついでにもう一個手直し。
まだ出る…今度はinvalid byte sequence in Windows-31J...なエラーが出てきたので、
[ruby]jekyll server で 『invalid byte sequence in Windows-31J～』とエラーになった時の対処方法](http://d.hatena.ne.jp/osyo-manga/20140216/1392552409)を参考にし、環境変数RUBYOPTに-Kuを設定。
設定
公式サイトを見ながら_config.ymlの構成を見て設定を確認しつつやってみたら、ブログっぽいものが作れるように。
Minimal Mistakesを導入 Gem編
GitHub Pagesを作ったときの超シンプルなやつに適用してみる。
Jekyll の更新を参考にしたというか、ほぼそれしかやってないというか。
Gemfile
gem "minimal-mistakes-jekyll"
gem "github-pages", group: :jekyll_plugins
gem 'wdm', '~> 0.1.1' if Gem.win_platform?
group :jekyll_plugins do
gem "jekyll-data"
end
index.html
---
layout: home
---
_config.ymlはMinimal Mistakesのgitからザクッと持ってきて、あちこち書き換える。
少なくともこれだけは必須かな。
remote_theme: "mmistakes/minimal-mistakes"
repository: ユーザ名/リポジトリ名
もしtheme:という項目があったら、削除するかコメントアウトで。
日本語UIにしたい場合はこれも。デフォルトでは"en-US"のようで。
locale: "ja-JP"
GitHub Pagesを稼働させる手順でindex.mdというファイルができていたけど、これは削除で。
コマンドを叩く。
$ bundle install
まずは動かしてみる。
$ bundle exec jekyll s
エラーが出たので調べていくと、先述のJekyll の更新に辿り着いた。
Personal access tokensでtakenを作成。
ユーザ環境変数JEKYLL_GITHUB_TOKENの値を追加。
当方はWindows7なので、Windowsメニュー1→右上にあるユーザアイコン→環境変数の設定に。
ナビメニューが必要になったら2、Minimal Mistakesのgitから_data/配下のnavigation.ymlを持ってきて編集を。
_config.ymlで日本語UIを使うためにlocale: "ja-JP"を設定している場合は、同じく_data/配下のui-text.ymlを。これは置くだけで。
動作確認ができたところでgit add的なことをしようとしたら、かなりのファイルが追加される状況に…
そういえばまだ.gitignoreファイルを作ってなかった。
Winodwsでの作成は.gitignoreファイルの作り方で。
内容はMinimal Mistakesのgitからパクる。
あとは_postsとか_pagesとか、あとcollection的なのを追加していけばいいかと。
Gem化されたテーマというのも、準備はいろいろ面倒くさかったという。
soloを導入
soloもやってみたので、メモ。
Fork A Repoを見つつ、まずはFork （ってよく判ってない）。
その後コマンドで引っ張ってくる。
$ git clone https://github.com/user-name/solo
で、真っさらから作ってみる。
$ git init
$ jekyll new your_repository
“new”ってくらいなので、既にコンテンツがある場合は怒られる。
jekyll new -f your_repositoryで。
Agus Makmunを導入
Agus Makmunも基本的にはSoloと同じようにいけた。
ただ、Jekyllさんに小言を言われないように、_config.yamlのgems:をplugins:に書き換える。
Baseを導入
Base | CloudCannon Academyの「導入は」簡単だった。
ソースが見やすくて一見カスタマイズしやすそうだけど、癖がすごい。
カスタマイズはCustomize Baseに書いてある通り。
-
いわゆるスタートキーとかスタートアイコンとか。 ↩