Minimal Mistakes
Bonvin Lab webpage based on the Jekyll templateSee 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.
Getting Started
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.
Installation Instructions (updt. Feb. 2016)
- 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!
Running the website 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
octopress new post
Small utility to create a new post automatically. Quick and dirty replacement of $ python _utilities/create_new_article.py 'A Random Post'
- For updating jeckyll and bundle
$ gem update jekyll
$ gem update bundle