Writing a Post
So, I see you feel ready to write a post! That’s amazing!
Please do note that this template has some special collections, aimed at RPG-oriented resources. Each collection has a template model, which we strongly suggest you copy and fill with your creation.
After you created what you want, you must move your creation to the adequate folder.
Collection | Sub-folder | Layout | Description |
---|---|---|---|
Adventures | _adventures | adventure | Each individual adventure, with all its data, encounters and steps |
Ages | _ages | age | Periods of time |
Animals | _animals | animal | Animals as biological data, when there is no stats block |
Armors | _items | armor | Armors and other protection gear |
Chapters | _chapters | chapter | Texts, prose or otherwise, in a series or book |
Items | _items | item | Items that are not armor or weapons |
Monsters | _monsters | monster | Individual monsters, NPCs, PCs or other creatures |
Plants | _plants | plant | Biological data regarding plants and fungi |
Posts | _posts | post | Generic post format with few metadata |
Settlements | _settlements | settlement | Cities, towns and other settlements, as well as their ruling structure, shops and houses |
Spells | _spells | spell | Non-epic spells of any class and nature |
Weapons | _items | weapon | Weapons |
Common Aspects
File Names
We ask that each file be named according to Jekyll’s convention to post names, with its date of writing or finishing, as you see fit, and its title without special characters and accents, and all whitespaces replaced by hyphens (-
), in the form: YYYY-MM-DD-title-without-spaces.md
Common Front Matter
All files must have front matter defined in its top. Below we will discuss specifics for each collection, but all of them has some common elements:
Variable | Description |
---|---|
title | The title with all possible UTF-8 characters |
author | Your name |
date | The same date as in the filename, following ISO 8601’s format |
layout | One of the layouts available - please don’t alter the template’s |
All metadata above is required.
All layouts will output, under the first-level header (h1
), both the author name and the date.
Individualities
Each layout has specialized front matter, which is used by the layout on display. We discuss each of them further on the Layouts guide.