coulomb/shard-wiki
Archived
2
0
Fork 0
generated from coulomb/repo-seed
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

research: ikiwiki deep dive (compile-to-static, git-distributed); UC-79

Browse Source 
SHARD-WP-0003 T4. Wiki compiler: git-canonical Markdown source -> static HTML
(derived publish/projection, not the canonical store). Two new insights atop
the git-IS-store home case: compile-to-static = clean canonical-source vs
derived-output separation (attach source repo, UC-37/UC-56), and a third
federation flavor -- git replication + XML-RPC change-ping (pinger), beside
fedwiki fork/journal (UC-72) and Wikibase SERVICE (UC-74). UC-79. Enriched
UC-31/56/37/33. Marks T4 done. Feeds SHARD-WP-0002 T4/T6/T14.

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
This commit is contained in:
Bernd Worsch
2026-06-14 20:40:29 +02:00
parent 188643b0f5
commit ee805d5af7
6 changed files with 229 additions and 6 deletions
Download Patch File Download Diff File Expand all files Collapse all files

15
research/260614-ikiwiki-deep-dive/README.md Normal file
View File

@@ -0,0 +1,15 @@
# 260614 — ikiwiki deep dive
Deep dive on **ikiwiki** (Joey Hess): a **wiki compiler** — it compiles a **VCS-backed**
(usually **git**) tree of Markdown source into **static HTML**, supports **distributed**
operation (clone/edit/push between wiki instances, change **pings**), and treats web edits as
commits to the same repo.
- `findings.md` — the compiler model, git-distributed federation + pinger, static output,
capability profile, INTENT mapping, UC seed (UC-79), architecture notes for SHARD-WP-0002,
open questions, sources, traceability.
Catalog yield: UC-79 (attach a git-backed **compile-to-static** wiki — git Markdown source
is the shard, compiled static HTML is a derived publish/projection; participate in
git-distributed clone federation with change-pings). Enriched UC-31/56/37/33. Feeds
SHARD-WP-0002 T4 (federation), T6 (publish/projection).