Docmd Wiki Site

Static wiki site built from markdown source via docmd v0.8.x, deployed at wiki.hyraxknot.com (served statically by CT 118 Caddy from /var/www/wiki).

Architecture

/root/workspace/wiki/            # Source markdown (54+ .md files)
├── concepts/                    # System concepts & architecture
├── entities/                    # Services, components, hosts
├── guides/                      # How-to workflows
├── Hyraxknot Division/          # Division policies & status
├── references/                  # Reference data
├── _archive/                    # Retired but preserved
├── comparisons/                 # Decision records
├── queries/                     # Reusable queries
├── raw/                         # Source material (articles, assets, papers, transcripts)
├── index.md                     # Landing page
└── log.md                       # Changelog (append-only)

/root/workspace/wiki-site/       # Build config & output
├── docmd.config.json            # Docmd configuration (nav, theme, SPA)
├── dist/                        # Built output (static HTML)
└── (other docmd files)

How to Build

cd /root/workspace/wiki-site
docmd build

Output goes to dist/. Verify with:

echo "Pages: $(find dist -name 'index.html' | wc -l)"

How to Deploy

The built dist/ is served statically by CT 118 (wiki.hyraxknot.com → /var/www/wiki). After building, rsync the dist there:

cd /root/workspace/wiki-site
docmd build
rsync -a --delete -e "ssh -o BatchMode=yes" dist/ root@192.168.0.70:/var/www/wiki/

The 7am wiki-daily-sync cron does this automatically (git sync → docmd build → rsync).

Configuration

Key fields in docmd.config.json:

Navigation

The nav tree in docmd.config.json defines sidebar sections. Current sections (as of 2026-06-05):

Each nav item uses { "title": "Display Name", "path": "/entities/doc-slug" } format. Path prefix must match the source directory (/entities/, /concepts/, /guides/, etc.).

Maintenance

• Build after any markdown change or nav update
• Commit wiki source changes to git: cd /root/workspace/wiki && git add -A && git commit -m "wiki: <summary>" && git push
• Daily auto-sync: wiki-daily-sync cron at 7am commits/pushes wiki changes, rebuilds the docmd site, and rsyncs dist/ → CT 118 /var/www/wiki (public wiki.hyraxknot.com)
• Weekly stale scan: Nei runs freshness audit every Sunday via wiki-maintenance skill

There is no separate hot-reload dev server — edit, build, check dist/, deploy.

Related

• Wiki Maintenance — workflow for keeping the wiki fresh
• Wiki Editing Guide — conventions for sister editors
• Caddy Routes — reverse proxy serving the wiki