Basics

Our site is a Jekyll blog, hosted via GitHub Pages. Upon new commits to the dev branch, it is automatically (re)deployed via GitHub Actions.

The main types of content for Jekyll sites are pages and posts. A page is for standalone content that isn't associated with a specific date, such as our features overview. The repo contains a directory named _pages that contains all pages. A post is a blog post. They are saved within the _posts directory.

General

All pages and posts need to have a YAML front matter. It sits sits right at the top of a file between two triple-dashed lines (---) and is used to set variables for the page. This is a very simple example of such a front matter:

---
permalink: /cool/url/path/
title: "Super Nice Page Title"
---

After this front matter, everything can be written in Markdown, HTML and Liquid.