eblume/blumeops
1
1
Fork 0
Code Issues Pull requests Projects Releases 83 Packages Wiki Activity Actions
blumeops/docs/reference/services/kiwix.md
Erich Blume 4ccb7b9a26 Fix wiki-links to use filename-based resolution (#90) 
## Summary
- Quartz's "shortest" path mode resolves wiki-links by **filename**, not frontmatter title
- Previous PR used title-based links like `[[Grafana Alloy]]` which looked for non-existent `Grafana-Alloy.md`
- Now using filename-based links like `[[alloy|Grafana Alloy]]` which correctly resolve

## Changes
- Rename zk duplicate files with `-log` suffix (e.g., `argocd.md` → `argocd-log.md`)
- Rename `reference/storage/postgresql.md` to `postgresql-storage.md`
- Convert all 175 wiki-links from `[[Title]]` to `[[filename|Title]]` format
- Rename `doc-card-titles` task to `doc-filenames` (checks filename uniqueness, not titles)
- Update pre-commit hook for renamed task

## Deployment and Testing
- [x] Pre-commit hooks pass
- [x] `mise run doc-filenames` shows no duplicate filenames
- [ ] Verify wiki-links work correctly in Quartz build

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Reviewed-on: https://forge.ops.eblu.me/eblume/blumeops/pulls/90
2026-02-03 15:30:42 -08:00

1.3 KiB
Raw Blame History

title tags
Kiwix
service
knowledge

Kiwix

Offline Wikipedia and ZIM archive server.

Quick Reference

Property Value
URL https://kiwix.ops.eblu.me
Tailscale URL https://kiwix.tail8d86e.ts.net
Namespace kiwix
Image ghcr.io/kiwix/kiwix-serve:3.8.1
Storage NFS from [[sifaka

Architecture

Component Purpose
kiwix-serve Serves ZIM files on port 80
torrent-sync Sidecar syncing ZIM torrents to [[transmission
zim-watcher CronJob (hourly) to restart on new ZIMs

Configured Archives

  • Wikipedia top 1M English articles with images
  • Project Gutenberg (60,000+ books)
  • iFixit repair guides
  • Stack Exchange (SuperUser, Math, etc.)
  • LibreTexts textbooks
  • DevDocs developer documentation

Full list: argocd/manifests/kiwix/configmap-zim-torrents.yaml

Adding Archives

  1. Edit configmap-zim-torrents.yaml
  2. Add torrent URL from https://download.kiwix.org/zim/
  3. Sync: argocd app sync kiwix
  4. Torrent-sync adds to transmission
  5. zim-watcher restarts kiwix when download completes

Related