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.
- Install RVM (optional, to manage your Ruby installations)
\curl -sSL https://get.rvm.io | bash -s stable --ruby
rvm install ruby-2.6.3
rvm --default use ruby-2.6.3
- Install Bundler
gem install bundler
- 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 install
- 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