Posting a Blog

Blogging is baked into Jekyll. You write blog posts as text files and Jekyll provides everything you need to turn it into a blog.

Posts Folder

The _posts folder is where your blog posts live. You typically write posts in Markdown.

Creating Posts

Naming Post File

To create a post, add a file named as the following format to the _posts directory:

YEAR-MONTH-DAY-title.MARKUP

Where YEAR is a four-digit number, MONTH and DAY are both two-digit numbers, and MARKUP is the file extension representing the format used in the file. For example, followings are examples of valid post file names:

2011-12-31-new-years-eve-is-awesome.md
2012-09-12-how-to-write-a-blog.md

Meanings of Elements in the Front-matter of a Post

All the blog post files must begin with a front matter block which is typically used to set a layout or other meta data.

---
layout: post
nav-class: dark
categories: krystian
title: Krystian's March Update
author-id: krystian
---

1. layout front-matter determine which layout will be used to render the current file.

   Layouts live in the _layouts directory. The convention is to have a base template called default.html and have other layouts inherit from this as needed. In the current website, valid layout values key are: alumni, default, post, and team. A blog post must include layout: post on its front-matter.

2. nav-class front-matter is responsible for setting the top navigation color to black (dark).

   Right now dark is the only valid value.

3. categories front-matter, this will mark the current blog post to belong to a specific author. Valid categories values are: company, krystian, louis, rene, vinnie, marshall, damian, richard.

   This front-matter will be used at the bottom of the blog post, to list all the blog posts that have been written by curent author, as shown below.

4. title front-matter will be used as blog post title.

5. author-id front-matter, this refers to the files that are inside the people folder (without file extension) and will be used to show the author's name just below the post's title linking it to the author's profile page. Valid values would be damian, glen, jens, and so on.

It will pull the author's name from the {author-id}.html by checking member-name front-matter under the hood. e.g. The above front-matter will check member-name front-matter from krystian.html, which will result in: Krystian Stasiowski.

The following shows how people\krystian.html looks like:

---
layout: team
nav-class: dark
member-name: Krystian Stasiowski
---

Posting without author-id front matter wouldn't display the author's name.

Example Post

Here is a sample post named 2020-01-01-Post-Example.md with following contents:

---
layout: post
nav-class: dark
categories: krystian
title: Test
author-id: krystian
---

This is an example of a blog post.

If we put the file inside _posts folder, it will be rendered like this: