dazoyee space

Jekyll

Jekyll（ジキル）の使い方

Jekyllとは

Rubyで書かれた人気のある静的サイトジェネレータ
テンプレートとプレーンテキスト形式のコンテンツファイルを使用して、ウェブサイトやブログを作成できる
Jekyllはこれらのファイルを静的なウェブサイトに変換し、さまざまなプラットフォームでホスト可能
シンプルさ、高速性、およびGitなどのバージョン管理システムとの互換性で知られている

セットアップ

JekyllはRubyで動くため、Rubyをインストールする必要がある

Ruby

scoopを用いてインストールすることを 前提とする

scoop install ruby

scoop install msys2

ridk install

Jekyll

gem install jekyll bundler

jekyll -vでインストールされたことを確認する

http://jekyllrb-ja.github.io/docs/installation/windows/

新規作成

対象のリポジトリでコマンド実行する

jekyll new --skip-bundle .

デフォルトのテンプレート用のmarkdownファイルやGemfileなどが生成される

依存ライブラリをダウンロードする

bundle install

bundle add webrick

GitHub PagesとJekyllでMarkdownを静的サイト公開

Jekyll を使用して GitHub Pages サイトを作成する

ビルド

bundle exec jekyll serve

http://localhost:4000にアクセス

いろんなテーマ

デザインをカスタマイズできる

ここから選ぶ
http://jekyllthemes.org/

テーマがGemに公開されていると、簡単にカスタマイズ可能
https://rubygems.org/
検索して存在していると公開されている

  1. Gemfileファイル修正
    gem "jekyll-theme-clean-blog"
  2. _config.ymlファイル修正
    theme: jekyll-theme-clean-blog
  3. テーマインストール
    bundle install
  4. 確認
    bundle exec jekyll serve