はじめに

Github pagesでJekyllを使うのに、いろいろエラーが出たので備忘録として残す

実行環境

windows11
wsl2 Ubuntu 20.04
ruby 3.0
jekyll 4.3.2

環境構築

Rubyがインストールされているか確認

ruby -v

入っていなければ、Rubyのインストール
wslのターミナル内で実行
jekyllの公式を参考にしたのですが、この方法ではエラーがでてrubyのバージョン3.0を上げて回避。

sudo apt-get install ruby-full build-essential zlib1g-dev

RubyGemsのパッケージ（gemsと呼びます）をrootユーザーでインストールすることは避けてください。
その代わりに、ユーザーアカウント用のgemインストールディレクトリを設定します。
以下のコマンドは、~/.bashrc ファイルに環境変数を追加して、gem のインストールパスを設定します：

echo '# Install Ruby Gems to ~/gems' >> ~/.bashrc
echo 'export GEM_HOME="$HOME/gems"' >> ~/.bashrc
echo 'export PATH="$HOME/gems/bin:$PATH"' >> ~/.bashrc
source ~/.bashrc

Jekyllをインストールします

gem install jekyll bundler

これでjekyllを使い始める準備ができるはずと思ったがエラーで入らず

同じエラーがstackoverflowであったので試すも、rvmがないエラー
[Installation messed up with Ruby: Unable to install jekyll] https://stackoverflow.com/questions/75452016/installation-messed-up-with-ruby-unable-to-install-jekyll

stackorverflowで下記のエラーを見つけまずrvmをインストール
[No command 'rvm' found, but there are 20 similar ones] https://stackoverflow.com/questions/39643791/no-command-rvm-found-but-there-are-20-similar-ones
上のリンクを参考に下記を実行。途中でエラーがでたが、メッセージを参考に実行

sudo apt-get install curl
curl -L https://get.rvm.io | bash -s stable
source ~/.rvm/scripts/rvm
rvm requirements

ruby をインストールしてjekyllをインストール

rvm install 3.0
rvm use 3.0.0
rvm -v
rvm gemset update
gem install jekyll
jekyll -v

jekyllのテーマをローカルで使うためにgithub-pagesをインストール

gem install github-pages

インストールしたが、イマイチ使い方がわからず。

テーマのサイトからgit:cloneしてしたほうがよさそうです
クローンしたものをそのままjekyllで実行できました

クイックスタートを参考に実行。

jekyll new my-awesome-site
cd my-awesome-site
bundle exec jekyll serve

メッセージに出てきたアドレスをクリックして確認
ctrl-cでストップ

続けてテーマ設定を書きたかった長くなったので別の記事にします

終わりに

こんなに簡単のページが作れるなら、wordpressでブログを作るより楽そう。軽いしね。

参考にしたページ

[Rubyのインストール] https://www.ruby-lang.org/ja/documentation/installation/#apt
[jekyllrb-ja] http://jekyllrb-ja.github.io/docs/installation/ubuntu/