The Weirwood
A personal, story-focused A Song of Ice and Fire / Fire & Blood lore wiki
by Vicente Danzmann. Plain Markdown → Quartz →
GitHub Pages. Live at theweirwood.boo.
Local development
npx quartz build --serve # hot-reload preview at http://localhost:8080
npx quartz build # one-off production build → public/
Node 22 is pinned in .nvmrc and .node-version. Run nvm use if you have nvm.
Adding an article
Preferred (Foam): open the repo in VSCode with the recommended Foam
extension installed. Command Palette → Foam: Create New Note From Template
→ pick the template matching the folder it belongs in (character, house,
place, event, beast, order, relic, faith, mystery, custom) → enter
a title. The new note is created with
frontmatter pre-filled. Move it into the right subfolder under content/,
write the body, cross-link with [[wikilinks]].
Manual: create a .md file under one of the ten folders in content/
using lowercase-hyphenated slugs (e.g., content/characters/maegor-i-targaryen.md).
Start with the frontmatter block — see CLAUDE.md for the schema.
The frontmatter is the page furniture. Each key you fill in becomes one of
the boxes under the title; leave a key out and there is simply no box for it.
words: sets the italic motto under the title, tags: become the chips beside
it — each one leading to that tag's own page, where every page carrying it is
gathered and grouped by section — and status: stub raises the stub badge. Anything an entry needs that no
other page shares goes in facts:, an ordered map that adds one box per key.
No component needs editing to add a box.
Linking: [[Maegor I Targaryen]] links to the article with that exact title.
Use the pipe to change the words without changing the target:
[[Balerion|the Black Dread]]. A wikilink to a not-yet-written page becomes a
placeholder — useful for planning. Articles carry no aliases: field; linking by
anything but the real title silently drops the page out of the graph, which
CLAUDE.md explains.
Images
Two ways to embed images.
From a local file (preferred — external links rot).
Save images under content/attachments/. Optimize to WebP at reasonable
dimensions before committing (keeps the repo light):
# macOS: brew install webp, then:
cwebp -q 80 source.png -o balerion.webp
VSCode is configured to auto-route pasted or dragged images into
content/attachments/ when editing a note under content/, and insert the
Markdown link. Embed with either syntax:
![[balerion.webp]] # Obsidian/Foam-style; Quartz resolves by filename
![[balerion.webp|400]] # width in pixels
 # standard Markdown
From an external URL. Standard Markdown works:
Use sparingly — external images can disappear, change, or become slow to load.
Hotlinking from other sites is also poor etiquette; download the image
(if licensing permits) and rehost under content/attachments/ instead.
Copyright. Most ASOIAF art is copyrighted. Favour your own maps and
diagrams, licensed or public-domain images, or link out (with attribution)
rather than rehosting.
Deployment
Every push to main triggers .github/workflows/deploy.yml:
npm ci installs dependencies.npx quartz build produces public/.CNAME at the repo root is copied into public/CNAME so GitHub Pages
knows to serve the custom domain.actions/upload-pages-artifact bundles public/.actions/deploy-pages publishes it.
DNS is managed at Cloudflare: apex A records → 185.199.108-111.153,
www CNAME → ivcente.github.io. Records are DNS-only (grey cloud) so
Cloudflare doesn't proxy — GitHub's Let's Encrypt cert handles TLS directly.
Repo structure
content/ # source of truth — one .md per entity
├─ characters/
├─ events/
├─ houses/
├─ places/
├─ attachments/ # optimized WebP images
└─ index.md # landing page
quartz.config.yaml # Quartz v5 config (site title, theme, plugins)
quartz/ # Quartz framework code (do not edit)
CNAME # custom-domain marker (copied into build output)
.foam/templates/ # note templates for Foam
.vscode/ # workspace settings (Foam, image routing)
.github/workflows/ # CI deploy pipeline
CLAUDE.md # conventions for future Claude Code sessions
Credits
Built on Quartz v5 by Jacky Zhao and contributors
(MIT). Content is my own except where quoted and attributed.
Third-party assets, all CC BY 3.0
from game-icons.net. The licence requires these
credits to stay reachable from the site itself: they are published at
/colophon and linked from the footer of every page. Do not remove that link
without moving the attribution somewhere equally findable.
quartz/static/weirwood.svg, quartz/static/icon-tree.png and
quartz/static/og-image.png — "Dead wood icon" by
Lorc
(source). Modified:
recoloured, background removed or replaced, viewBox re-cropped.quartz/static/icon-face.png — "Tree face icon" by Cathelineau
(source). Modified:
recoloured and set on a dark ground.
quartz/static/icon.png is whichever of the two icons is currently the favicon
— a copy, not an original. See the note in CLAUDE.md.
