Jekyll Knowledge

Kip Landergren

(Updated: )

My Jekyll knowledge base explaining usage, liquid templates, and collections.

Contents

Overview

Jekyll is a simple, blog-aware, static site maker. It requires no database and focuses on making easy file management translate into a useable website. It offers excellent plug-in support which allows for quick extensibility and has fostered a rich “batteries-included” ecosystem.

HTML documents are created via a templating process that reinforces separating semantic representation (HTML) from styling (CSS) and from data (YAML, among others).

Core Idea

HTML documents are compiled via templating process that allows for layouts, includes, and data into $PROJECT_HOME/_site and served as a static website.

Key Concepts

Liquid Templates

Jekyll enhances liquid with its own custom filters.

Collections

Groups of related items may be placed into directories and then rendered into HTML documents via configuration settings.

Jekyll Terminology

collection
A group of related content. Becomes accessible through site
front matter
YAML region marked by triple dashes (---). Must be first characters in file.

Related

Jekyll reference