Work Instruction

  • for fast debugging, bundle exec jekyll serve on http://127.0.0.1:4000

install ruby and bundler

Ubuntu

sudo apt-get install ruby-dev
# sudo apt install build-essential # if required
# sudo gem install eventmachine # if required
sudo gem install bundler
sudo bundle install
  • Clone target repository
  • Go to project folder and open in terminal
  • build website
sudo bundle exec jekyll serve
  • Go to http://127.0.0.1:4000
  • Stop local hosting
Control + C
  • Renew: stop and rerun jekyll serve

Windows

gem install bundler 
  • Install jekyll
gem install jekyll
  • install paraday v2.0+
gem install faraday-retry
  • Go to project foler and install bundle
bundle install
  • run jekyll
bundle exec jekyll serve
  • Go to http://127.0.0.1:4000/ with any explorer

Reference

Ruby upgrade

wget https://cache.ruby-lang.org/pub/ruby/3.0/ruby-3.0.0.tar.gz # download 3.0
tar -xzvf ruby-3.0.0.tar.gz # unpack
# move to unpacked directory
# compile and install
cd ruby-3.0.0 
./configure
make
sudo make install
# version check
ruby --version
sudo apt-get install libssl-dev
# rebuild ruby
cd ~/Documents/GitHub/koyumi0601.github.io/ruby-3.0.0
./configure --with-openssl-dir=/usr/include/openssl
make
sudo make install
# version check
ruby --version
# gem update
sudo gem install jekyll
sudo bundle exec jekyll serve