Skip to content

Adding Post Category

Mike Simpson edited this page Jul 14, 2025 · 2 revisions

Posts are broadly collected into categories, such as Mental Health Stories or Self-care. Ideally, we would like to have as few categories on the site as possible, but it is possible that others will need to be added over time.

Adding a Post Category

To add a category, add a markdown file into the _categories folder in the root of the codebase.

The markdown file should include the following header material:

---
short_name: self_care
title: Self-Care
menu: blog
---

The short name should be one word or snake_case, and is the category identifier that will be added to the categories parameter of the blog post. The title is the display-friendly name, which can include spaces. This is how it will be displayed on the website. The menu parameter can be ignored but should be included for site usability.

Any content under the header will be included on the page when the user clicks on that category, as shown in the examples above. This should include a brief description of what the category is and what the blog posts in this category are intended to be about.

ConveRSE Wiki

Clone this wiki locally