# Counterweight Posts

This is where I keep my blog posts. The structure does not follow any blog 
convention: I keep my stuff here the way I like to prevent lock-in into any
specific blog service or technology. Once I want to render all of this into a 
real blog, I just develop and run some small code to adapt the contents to the
concrete solution I will be using.

## Structure

Posts should be stored in the `posts` folder. Each post:
- Should have its own folder. The folder name must be a unique slug.
- Must contain two files inside:
    - `content.md`: the actual post, as markdown.
    - `meta.yaml`: metadata on the post. This is a flexible file and generally,
      there are no limits to what to store here. Below is a table of fields 
      that are expected.

| Field      | Description                                                                                 |
|------------|---------------------------------------------------------------------------------------------|
| `title`    | The human readable title for the post.                                                      |
| `date`     | The posting date of the post, with format `YYYY-MM-DD HH:MM:SS`, as in 2021-05-30 11:59:59. |
| `category` | A category for the post. |
| `tags`     | A list of tags, represented as comma separated strings. | 
| `slug` | Unique, machine readable slug. | 
| `authors` | List of authors, represented as comma separated strings. | 
| `summary` | A brief, human readable summary for the post. |