Creates or edits Kanka HTML entity files. Use when creating new Kanka entities or editing existing entity HTML files.
Files go in the subdirectory matching their Kanka type:
| Directory | Entity type |
|---|---|
notes/ | Lore articles, reference documents, guides |
characters/ | Named NPCs and PCs |
locations/ | Towns, regions, buildings, landmarks |
organisations/ | Factions, guilds, religions |
races/ | Ancestries/species lore |
creatures/ | Monster and creature entries |
quests/ | Quest entries |
journals/ | Journals and diaries |
families/ | Family trees and lineages |
events/ | Historical events |
calendars/| Calendars |
Subdirectories within a type folder are used to sub-categorize entities — prefer a subfolder over encoding the category in the filename. For example, a faith organisation goes in organisations/faith/pharasma.html, not organisations/pharasma-faith.html. Subfolder names are singular (e.g., faith, reference, npc).
File naming: The filename must match the entity's name field converted to kebab-case, with .html extension (e.g., name "Silvermist Lodge" → silvermist-lodge.html). Do not abbreviate or simplify. The directory provides all type/category context. Do not include a type field in the YAML metadata; the entity type is determined by which top-level directory the file lives in, so storing it in the YAML would make the file harder to move and keep in sync.
Every entity file begins with a YAML block in an HTML comment:
<!-- kanka:
entity_id: 123456