work

c++

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

Sometimes nuke bundler and re-install it:

sudo rm -f /opt/homebrew/bin/bundle /opt/homebrew/bin/bundler
sudo gem uninstall bundler -aIx

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:

> [!NOTE] 
> Note

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.

Additional markdown features

• Web Links:

  This site was built using [GitHub Pages](https://pages.github.com/).
  

• Section Links:

  See the [Admonitions](#admonitions) section for more details.
  

• emails:

  You can contact me at [gemc@jlab.org](mailto:gemc@jlab.org)
  

Useful links:

• jekyll on github
• jekyll tutorial
• cool tables