Tine Van lent's website - tinevanlent.be

Build and test static site

Development

Linux set up

  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
    

Bare OS X set up

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

Set up development site

git clone git@github.com:asset-web/tinevanlent.be.git
cd tinevanlent.be/

Example Jekyll commands

  • 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
    

Docker set up

Build static site and run tests locally

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

Update jekll

docker compose up -d
docker compose exec web bundle update jekyll

Run development jekll server

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

docker compose up -d

CI/CD

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