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 3da455e49c Enforce unique doc filenames and simple wiki-links (#109) 
## Summary
- Rename section index files to match their titles (tutorials.md, reference.md, how-to.md, explanation.md) so all filenames are unique
- Convert all ~47 path-based wiki-links to simple filename format across 15 files
- Update doc-filenames task to no longer skip index.md files
- Update doc-links task to reject path-based links containing '/'

This ensures all wiki-links work correctly in obsidian.nvim by making links resolvable by filename alone.

## Testing
- `mise run doc-filenames` - all unique
- `mise run doc-links` - no broken or path-based links
- `mise run doc-titles` - no duplicates

Reviewed-on: https://forge.ops.eblu.me/eblume/blumeops/pulls/109
2026-02-04 17:21:34 -08:00

1.2 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