Jekyll プロジェクトを作る

Jekyllでプロジェクトを作る方法です。いくつかアプローチがありますのでそれぞれ見ていきます。

環境

  • Jekyll 3.3.1

方法1. デフォルトのテーマを使ったプロジェクト

jeyll newを使うとデフォルトのテーマ(minima)を使ったプロジェクトを生成できます。

プロジェクト名を_newとして作ってみます。

$ jekyll new _new

これでデフォルトのテーマminimaを使ったプロジェクトができました。実行してみます。

$ cd _new
$ jekyll serve

localhost:4000にアクセスすると次のような感じで表示されます。


方法2. オリジナルのテーマを作るためのプロジェクト

jekyll new-themeを使うと、オリジナルテーマ作成用のプロジェクトが生成されます。gemとしてテーマを登録したい人向けのようです。

プロジェクト名を_new_themeとして作ってみます。

$ jekyll new-theme _new-theme

そのまま実行すると、gemspecファイルの"FIXME""TODO"の箇所を修正してくださいとエラーがでます。

$ cd _new-theme
$ jekyll serve
Please fix this gemspec. (Gem::InvalidSpecificationException)
The validation error was '"FIXME" or "TODO" is not a summary'

適当にTODOを修正して、実行すると次のような感じで表示できます。index.htmlが無いのでIndex of /がそのまま見えるようです。


方法3. ブランクプロジェクト

何も無い空のプロジェクトです。jekyll new [プロジェクト名] --blankで作れます。

プロジェクト名を_blankとして作ってみます。

$ jekyll new _blank --blank

実行すると真っ白な画面が表示されます。画面イメージはありません(真っ白なので)。

$ cd _blank
$ jekyll serve

つぎは

ブランクプロジェクトに加筆していくことで、Jekyllを一歩ずつ学べそうな気がします。