Jekyll + GitHub Pagesでサイトをつくる

GitHubにブログ用リポジトリをつくる

GitHub: Create a New Repository

Repository name: syon.github.io ※USERNAME.github.io形式

Jekyllのインストール

Jekyll 1.4.3 (2014.02.14)

$ gem install jekyll
$ jekyll new syon.github.io
$ cd syon.github.io

Jekyll Bootstrapのダウンロード

GitHub: plusjade / jekyll-bootstrap - Download ZIP

リポジトリフォルダsyon.github.ioを空にしてZIPの中身を入れる。 設定は_config.ymlに記述。

ローカルで動作確認

$ jekyll serve

http://localhost:4000

_siteフォルダにJekyllが生成したファイルが出力される。ここがサイトルートパス。 GitHubに対して_siteをpushする必要はない(.gitignoreに入ってる)。

公開

公式アプリの GitHub for Mac を使っています。Commit → Sync で公開。

利点

  • 無料 (容量制限はアカウント全体で 0.60GB っぽい)
  • markdownで記事を書ける
  • 純粋な静的html/css/jsを置ける、構造そのままアップされる
  • つまりWordPressのよくわからんところを自分の管理下でちゃんとできる
  • 従来のレンタルサーバのようにFTPではなくgitで管理できる
  • GitHubの信頼性に乗っかれる。バックアップとか気にしない。大事なもの置かない。
  • ハードル低めなgitの練習になる

TIPS

カテゴリごとのPageリスト(Postではない)を生成する

syon.github.io / index.md で使っています。

参考