GitHub Pages, Jekyll and Liquid

GitHub Pages, Jekyll and Liquid

Hints and tips on using Jekyll for publishing to GitHub Pages.

• Add Disqus to Jekyll pages

  Example code to add to every page as a footer to enable the Disqus comments service.

• Alternate static site generators to Jekyll

  Jekyll is built on Ruby which is a pain to work with on Windows. It also doesn't match my chosen development language of JavaScript. Here are some possible alternatives to Jekyll along with some strengths and weaknesses.

• How to create a page toc

  If you want to generate a table of contents list (toc) for a markdown file, you can use the native Kramdown feature.

• List of problems and issues with Jekyll and GitHub Pages

  While sites generated using GitHub pages can use Jekyll to enhance them, there are some limitations and, it seems, a number of problems.

• GitHub Pages, Jekyll and Liquid

  Hints and tips on using Jekyll for publishing to GitHub Pages.

• Jekyll/Liquid Variable Filters

  A comprehensive list of filters available to modify/format Jekyll variables.

• Jekyll/Liquid Tags

  This is a list of `tags` that can be used in Jekyll.

• How to generate a list of collection documents

  The following code automatically generates a list of collection documents. It assumes that the collection uses `output: true` and optionally includes a collection title and description defined in the `_config.yml` configuration file.

• How to generate a list of pages in a given folder

  The following code automatically generates a list of pages that exist in a given folder.

• Hints and tips on using Jekyll for publishing to GitHub Pages

  Some reference sites and links for Jekyll, Liquid and GitHub Pages.

• Hints and tips on using Jekyll for publishing to GitHub Pages

  These are the default attributes (variables) that you get with each part of the Jekyll domain.

• A Page to test things

  GitHub pages use Jekyll but not all features are available. This page is for testing what works and what doesn\'t

• A Test Jekyll/GitHub Collection Document (MarkDown)

  Testing collections and page variables - this page is in a collection and is a markdown file

• A Test Jekyll/GitHub Collection Document (HTML)

  Testing collections and page variables - this page is in a collection and is an HTML file