Wiki Setup

How This Wiki Works

This wiki is a GitHub-hosted Quartz 5 digital garden — interactive graph, backlinks, full-text search, and a file explorer. Content is plain Markdown with Obsidian-style [[wikilinks]].

Architecture

Hermes (writes content)
       │
       ▼
/var/www/wiki/docs/   ← Markdown source files (Quartz content)
       │
       ├── npx quartz build -d docs -o site  →  /var/www/wiki/site/  →  nginx → wiki.huymai.fi
       │
       └── git push      →  github.com/mquhuy/wiki  →  your computer / phone

Sync Workflow

1. I write content to /var/www/wiki/docs/ during our conversations
2. A cron job runs deploy.sh: builds Quartz + commits + pushes to GitHub
3. You browse at wiki.huymai.fi or clone the repo locally
4. You edit → commit + push → the deploy script pulls changes and rebuilds

Features

• Graph view — see how notes link together (right sidebar)
• Backlinks — every page shows what links to it
• Search — full-text, Ctrl/⌘ + K
• Explorer — collapsible file tree (left sidebar), no manual nav to maintain
• Tags — click any tag for a list of related notes
• [[wikilinks]] — link notes by path or name, resolved automatically

Build Requirements

• Node 22+ on the host
• npm ci installs deps; npx quartz plugin install compiles plugins (run once / when quartz.lock.json changes)
• deploy.sh handles all of this automatically

Reading on Your Phone

• GitHub Mobile app — browse the repo directly
• wiki.huymai.fi — responsive web, works great on mobile browsers
• Obsidian (with Git plugin) — if you clone to a git-based notes app

Local Editing

git clone git@github.com:mquhuy/wiki.git
cd wiki
# Edit .md files in docs/
git add -A && git commit -m "your changes"
git push