Bonvin Lab webpage based on the Jekyll template Minimal Mistakes
See a live version of this website hosted on GitHub. For more information on the template and folder organization, visit the original author's web page.
To ensure whatever you create/change appears as faithfully as possible after pushing to the main repository, install the version of Ruby and the gems used by Github. See a list here.
Following the instructions from: https://github.com/BillRaymond/install-jekyll-apple-silicon/blob/main/README.md
And using homebrew
- Install ruby3.0
brew install ruby@3.0
- Add path to ruby3.0 in .bashrc (or .bash_provile)
export PATH="/opt/homebrew/opt/ruby@3.0/bin/:$PATH"
- Restart your terminal and make sure you are now using ruby3.0
ruby -v
- Install Jekyll and Bundler
gem install --user-install bundler jekyll
- Add the path to the gems to in .bashrc (or .bash_provile)
export PATH="~/.local/share/gem/ruby/3.0.0/bin:$PATH"
- Clone the haddocking.github.io repository and install all dependency Gems with Bundler
git clone https://github.com/haddocking/haddocking.github.io.git haddocking-website
cd haddocking-website
bundle init
bundle add jekyll --version "~>4.2"
bundle config set --local path 'vendor/bundle'
bundle install
bundle exec jekyll new --force --skip-bundle .
bundle add webrick
bundle install
bundle update
- Adapt the settings in _config.yml accordingly
In order for links to properly work, the
url
setting in must be set accordingly, otherwise you will be redirected to the live version. This sets all thesite.url
variable calls throughout _layouts/, _includes/, etc.
url: "" # Empty string will render the page successfully locally. Do not commit it to the main repository!
incremental: true # This will be disabled by Github, but is useful for testing changes locally!
To preview changes, which you should always do before committing anything or making any pull requests, run the web server locally using the following:
$ bundle exec jekyll serve
$ python _utilities/create_new_article.py 'A Random Post'
- For updating jeckyll and bundle
$ gem update jekyll
$ gem update bundle