Link Search Menu Expand Document (external link)

Writing a Post

So, I see you feel ready to write a post! That’s amazing! :smile:

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.