Two ways to edit
In the browser. Open admin and sign in with GitLab. You get a visual editor with previews. Saving writes a commit to the main branch of the lore repository under your name.
With git. Clone gitlab.com/bread-and-circuits/lore, edit the Markdown under content/, and open a merge request. Obsidian users can open content/ as a vault: wikilinks, callouts, and embeds all render here.
Either way, the site rebuilds and publishes within a couple of minutes.
Getting access
Editing needs a GitLab account with Developer access to the lore project. Ask in the show’s Discord and an editor will add you. Reading needs nothing.
House style
- One page per thing: a floor, a faction, a contestant, an episode. Link generously with
[[wikilinks]]; the graph and backlinks come free. - Write what aired. The production keeps unaired material private, and so should you.
- Put the short version first. A reader who stops after the first paragraph should still leave knowing what the page is about.
- Rules pages are generated from the engine and overwritten on every build. To change a rule, change the engine.
Folders
| Folder | What goes there |
|---|---|
content/world/ | Places, factions, the Showrunner, the mechanics of the dungeon as experienced |
content/cast/ | One page per contestant |
content/history/ | One page per episode, plus season arcs |
content/rules/ | Generated. Do not edit. |
content/assets/ | Images and other media |