自分用の覚書。
前回のGithub Pagesでwebページをmarkdown言語で作れるのが便利の話の続き。
Github Pagesをwindowsローカルの環境で確認しながら編集するために環境をつくる。
***
大枠がわかるリンク
・GitHub Pages を使ってみる | Github Docs
・Jekyll を使用して GitHub Pages サイトを作成する
・Jekyll を使用して GitHub Pages サイトをローカルでテストする
概要
だいたいは上記のページを参考にしてできる。
自分の場合は、Github上でつくったリポジトリをwindowsローカルにクローンしてきて、そこでJekyllを使えるようにしたので、手順がすこし違った。
あと、なにかしらのバージョンの問題で、bundle exec jekyll serveをするときにエラーが発生するが、
Gemfileに
gem "webrick"
を追加すると解決した。（参考リンク: Jekyll serve fails on Ruby 3.0 #8523）
やったことメモ
RubyInstallerでrubyをインストール
RubyIntaller for windows
gemでbundleとjekyllをインストール
Jekyll on Windows
Git for windowsをインストール
git for windows
その後のコンソール上の作業は、上記でインストールされたGit bashを使って行った
（これじゃないとgitコマンド使えなかった）
自分がGithubで作ったリポジトリを、
git clone https://github.com/username/repositoryname.git
でローカルにクローンしてくる
クローンしたリポジトリ内に、Gemfileと.ignoreを用意する。
Gemfile
source "https://rubygems.org"
# Hello! This is where you manage which Jekyll version is used to run.
# When you want to use a different version, change it below, save the
# file and run `bundle install`. Run Jekyll with `bundle exec`, like so:
#
# bundle exec jekyll serve
#
# This will help ensure the proper Jekyll version is running.
# Happy Jekylling!
#gem "jekyll", "~> 3.9.0"
# This is the default theme for new Jekyll sites. You may change this to anything you like.
gem "minima", "~> 2.5"
# If you want to use GitHub Pages, remove the "gem "jekyll"" above and
# uncomment the line below. To upgrade, run `bundle update github-pages`.
# gem "github-pages", group: :jekyll_plugins
gem "github-pages" , "~> 215", group: :jekyll_plugins
# If you have any plugins, put them here!
group :jekyll_plugins do
gem "jekyll-feed", "~> 0.12"
end# Windows and JRuby does not include zoneinfo files, so bundle the tzinfo-data gem
# and associated library.
platforms :mingw, :x64_mingw, :mswin, :jruby do
gem "tzinfo", "~> 1.2"
gem "tzinfo-data"
end# Performance-booster for watching directories on Windows
gem "wdm", "~> 0.1.1", :platforms => [:mingw, :x64_mingw, :mswin]
gem "webrick"
.ignore
_site
.sass-cache
.jekyll-cache
.jekyll-metadata
vendor
git bashのコマンドライン上で
bundle install
その後、jekyllのサーバーを起動
bundle exec jekyll serve
ここでエラーが出なければうまくいく
Webブラウザで
http://127.0.0.1:4000
にアクセスする。
これでGithub pagesのページが確認できればOK!
こうして作った環境で、ローカルで確認しながら編集して、きりの良いところでgit pushでgithubにあげてwebページを公開する。
