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
_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 で使っています。
参考
- GitHub Pages
- GitHub Help - Categories / Pages
- jekyll+github pagesでブログを作る ? fragments
- blog.makitasako.com - ブログをGitHubに移行しました。
- Github Pages について整理しておきます - そんなこと覚えてない
- 30分のチュートリアルでJekyllを理解する
- ruby と jekyll と jekyll-bootstrap で静的サイトを作る - KRAKENBEAL RECORDS
- Jekyllいつやるの?ジキやルの?今でしょ!