GreenHat SBS standard posts and article

The distinction between a post and an article — as far as SBS is concerned — is that posts are .md suffixed files (Markdown files) that exist somewhere in the _posts directory, and articles are .md or .html suffixed files anywhere else on the site. 

Posts form part of your blog, a chronological series of posts. Articles are static pages like an About page or a Contact page.

A typical blog post

The front matter for a typical blog post looks like this:

---
title: Problems with p0f after reboot or upgrade
date: 2018-03-02 06:30
description: How to fix the 'p0f appears to be down' message that sometimes occurs on CPanel systems after an upgrade or reboot.
tags: [Tech,Linux,cPanel]
cats: How-To
excerpt: If you get the __p0f appears to be down__ message after upgrading or rebooting a CPanel system, I have a fix for you. I haven't yet worked out how to stop it altogether but this fix holds things steady until the next upgrade or reboot.
---

Title, date, description and excerpt are all necessary. In actual fact SBS will attempt to create all these fields for you if you don’t specify them, but it is far better to write your own.

Note the format of the date: YYYY-MM-DD hh:mm

Dates must be in this format.

The title is obviously the title of your post.

The description is what appears in the HTML (and on search engines if they index you). It is also used by the archive, category and tag pages to describe your post.

The tags and cats fields serve to define taxonomies for your posts. You can either specify a single option for each taxonomy or multiple options between square brackets and separated by commas.

The excerpt is what appears on the home page as a teaser for your post. It can contain Markdown.

An article or static page is created in exactly the same way as a blog post but it does not reside in the _posts directory (see below). _ 

Location and filename

A blog post must be somewhere in the _posts directory. It can be directly underneath the _posts root or in a subdirectory.

A blog post must begin with the date in YYYY-MM-DD format and be followed by a dash.

So, for example, these are all valid blog post files:

_posts/2017-04-04-a-review-of-my-car.md
_posts/2019/08/2019-08-17-what-my-cat-had-for-dinner.md
_posts/subdir/2020-01-01-happy-new-year.md

Theoretically, filenames can have spaces in them and use mixed case letters but I highly recommend using all lower case letters and used a dash instead of a space. This allows for better cross-platform compatibility.

Citation blog posts

A citation blog post is where you’re directly citing an article on an external web site with some comments of your own as a leader. SBS knows it’s a citation if you have the citation key in the front matter.

The front matter for a citation blog post will look something like this:

---
title: Problems with p0f after reboot or upgrade
date: 2018-03-02 06:30
description: How to fix the 'p0f appears to be down' message that sometimes occurs on CPanel systems after an upgrade or reboot.
tags: [Tech,Linux,cPanel]
cats: How-To
citation:
    url: https://anothersite.com/url-of-post-on-their-site
    title: Title of post on external site
    site: 
        name: External site name
        url: https://anothersite.com
    author:
        name: Auther Name
        url: https://anothersite.com.com/author-page-if-there-is-one/
---

Note that a citation has no excerpt. This is because the entire contents of the post will appear on your home page rather than just an excerpt.

The citation url is the URL of the post on the external site.

The citation title is the title of the post on the external site. Note that this may be different to the title of your own post.

The citation site and author fields are optional but recommended (so that you’re giving proper credit to the original article).

The citation site specifies the name of the site you’re citing and its home page URL.

The citation author specified the author of the post on the external and their ‘author page’ if there is one.

Images

You can of course add images to your posts. See the separate section on images.