1. Install Ruby

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

2. Configure Gem location

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

3. Install Jekyll & Bundler

    # Check version requirements here https://pages.github.com/versions/
    gem install jekyll --version 3.8.5
    gem install bundler
   

Prerequisite homebrew is installed

brew install ruby
echo 'export PATH="/usr/local/opt/ruby/bin:$PATH"' >> ~/.bash_profile
gem install --user-install bundler jekyll
echo 'export PATH="$HOME/.gem/ruby/2.7.0/bin:$PATH"' >> ~/.bash_profile

git clone [email protected]:asset-web/tinevanlent.be.git
cd tinevanlent.be/

• Create new site with default theme

   jekyll new .
  

• Serve development site

   bundle exec jekyll serve
  

• Build production site

   JEKYLL_ENV=production jekyll build
  

• Update dependencies, specific or all gems.

   bundle update jekyll
   bundle update
  

Build static site and run tests locally

docker build . -t tvl-web
docker run --rm tvl-web

# Update single gem
docker compose run --rm web bundle update jekyll

docker compose run --rm web bundle update --all

# Disable copying lock file and installing gems in Docker file
rm Gemfile.lock
docker compose build web
docker compose run --rm web bundle update --all
# Re-enable copying lock file in Docker file
docker compose build web
docker compose run --rm web bash /src/scripts/cibuild.sh

Run the below command and then visit: http://localhost:4000

docker compose up -d

Gitflow workflow in use. Travis CI used to build and test. Deploy static Jekyll site to remote server is managed using Digital Ocean integration.