work

general

Jekyll

Various commands:

To start a jekyll server, clean up, update, install the bundles, run:

bundle exec jekyll serve
bundle exec jekyll clean 
bundle update jekyll
bundle install

• If the gemfile is changed, need to run bundle
• If the config yaml is changed, (for example update theme), need to update bundle update

To update Bundler to a version compatible with your Ruby version and check / uninstall old versions:

sudo gem update --system
sudo gem update bundler
sudo gem install bundler 
gem list bundler    
sudo gem uninstall bundler -v 2.6.5

Styling

• Using Minima
• The tab order is given by the filename, so you can prepend a_ etc.
• List of Fonts: https://fonts.google.com

Admonitions:

Adding the following to the jekyll_plugins group in the gemfile allows to use admonitions in markdown files:

  gem "jekyll-gfm-admonitions", "~> 1.0"

Available admonitions are:

Adding Content

The files in directories starting with an underscore are not processed by jekyll if specified in the _config.yml file like this:

# this add content to the website from the local dirs starting with _
collections:
  pi0:
    output: true

Optionally permalinks can be added for navigation.

Useful links:

• versions for the compatible version of the software when running jekyll on github
• jekyll on github
• jekyll tutorial
• cool tables