Jekyll Notes

Links

Jekyll and Github

• Jekyll Documentation
• Using Jekyll with GitHub Pages

Markdown on GitHub

• Mastering Markdown
• Markdown Basics
• Writing on Github
• GitHub Flavoured Markdown

Kramdown

• Kramdown Cheatsheet
• Kramdown Reference

Jekyll and Liquid Templating

• Liquid for Designers
• Jekyll Templates

Themes for Jekyll

• Jekyll Now from Building a blog with Jekyll and GitHub pages
• Poole
• Lanyon
• Skinny Bones

Quickstart (local)

From the Jekyll site

$ echo "source 'https://rubygems.org'

# This Gem pulls in all GitHub Pages dependencies.
# It should be close to the current latest:
# https://pages.github.com/versions.json

gem 'github-pages'" > Gemfile

bundle install --path=vendor/bundle
bundle update # regularly
bundle exec jekyll serve

Kramdown

Kramdown can do footnotes¹ and assign id, title and class to elements.

Kramdown can do abbrs too.

kramdown

Definitions in Kramdown

Kramdown code blocks are either indented by tab or four spaces, or use tilde as delimiters:

def what?
  42
end

Math support in Kramdown, requires including MathJax, visit http://gastonsanchez.com/blog/opinion/2014/02/16/Mathjax-with-jekyll.html

Footnotes