Guides1 min read

This is your blog

An example post that ships with the template. Replace it with your own, or delete it.

This post is an example. It is a plain Markdown file in content/blog/, and it is here so the blog index, the category pages, the RSS feed and the sitemap have something to show on a fresh clone.

Publishing a post of your own means adding a file next to this one and committing it. There is no CMS and no database behind it: the file is the post.

What to do with this one

Delete it, or rewrite it. If you keep the blog, a good first post is the one your visitors would otherwise ask you about: what the product is for, who it is for, and what changed since you launched.

Two things are worth setting before you publish anything:

  • The brand, so the cover shapes, the page titles and the link previews carry your name and your color. See the branding variables in docs/configuration.md.
  • The categories. Keep the set small: two or three cover most products, and each one gets a page of its own.

If you do not want a blog at all, remove the Blog link from the navbar and the footer, and delete the content/blog/ folder.

The next example, "Writing a post: the fields that matter", goes through the front matter one field at a time.