docs: Eigene Endung .werkbaum + fünf Beispieldateien unter docs/examples/
Mit nur einem Beispiel ließ sich das Umschalten zwischen Dokumenten (D22) nicht zeigen — jeder ?sourceUrl=-Link legt genau ein Dokument an (D23), erst mehrere nacheinander geöffnete füllen den Wähler. - Neue Endung `.werkbaum` (D24, SPEC §12): macht Notationstexte zuordenbar (spätere Editor-Zuordnung, Syntax-Highlighting, Öffnen/Speichern). Konvention, kein Vertrag — `?sourceUrl=` wertet weder Endung noch Content-Type aus, `.txt` bleibt gültig. `.gitattributes` führt `*.werkbaum` als Text (LF). - docs/example-plan.txt -> docs/examples/example-plan-0.werkbaum (Inhalt bis auf die Kopfzeile unverändert); README-Links nachgezogen. - Neu, je einen anderen Aspekt zeigend: example-plan-1 (Küche: kein Software-Plan, alternativenlastig — günstigster Pfad), example-plan-2 (Konferenz: breiter Fächer, viele Beteiligte), example-plan-3 (drei Wurzeln = drei Bäume nebeneinander, dazu ein Knoten ohne Größe für das implizite-M-Badge), example-werkbaum (Werkbaum selbst: Bestand + mögliche Weiterentwicklung, destilliert aus ROADMAP/TASKS/DECISIONS). - README.md / README.de.md: Tabelle mit den fünf Live-Links samt Hinweis, dass sie nacheinander geöffnet den Dokument-Wähler füllen. Verifiziert: alle fünf parsen headless ohne Warnungen und ohne gemischte Gates (19/26/43/28/79 Knoten, 3 Wurzeln in Beispiel 3); Vitest 34/34 grün. Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
This commit is contained in:
co-authored by
Claude Opus 4.8
parent
4d0fb9edd7
commit
cdf843e2e3
+19
-6
@@ -44,15 +44,24 @@ Der Editor kann seinen Notationstext über den Query-Parameter `sourceUrl` aus
|
||||
einer externen Textdatei beziehen — praktisch zum Teilen eines Plans oder wenn
|
||||
die Quelle in Git oder einem Wiki gepflegt wird:
|
||||
|
||||
**▶ [Live-Beispiel](https://mhoennig.github.io/werkbaum/?sourceUrl=https://raw.githubusercontent.com/mhoennig/werkbaum/main/docs/example-plan.txt)**
|
||||
— lädt [`docs/example-plan.txt`](docs/example-plan.txt):
|
||||
|
||||
```
|
||||
https://mhoennig.github.io/werkbaum/?sourceUrl=https://raw.githubusercontent.com/mhoennig/werkbaum/main/docs/example-plan.txt
|
||||
https://mhoennig.github.io/werkbaum/?sourceUrl=https://raw.githubusercontent.com/mhoennig/werkbaum/main/docs/examples/example-plan-0.werkbaum
|
||||
```
|
||||
|
||||
(Das Beispiel zeigt auf den latest build 🚧; die stabile Instanz kann
|
||||
`sourceUrl` ab ihrem nächsten Produktions-Deploy.)
|
||||
Fertige Beispiele in [`docs/examples/`](docs/examples/) — **nacheinander
|
||||
öffnen**: Jedes wird ein eigenes Dokument, danach lässt sich in der
|
||||
Editor-Titelzeile zwischen allen umschalten:
|
||||
|
||||
| Beispiel | Zeigt |
|
||||
|---|---|
|
||||
| **▶ [0 · Online-Shop-Relaunch](https://mhoennig.github.io/werkbaum/?sourceUrl=https://raw.githubusercontent.com/mhoennig/werkbaum/main/docs/examples/example-plan-0.werkbaum)** | ein Softwareprojekt mit allen acht Status |
|
||||
| **▶ [1 · Neue Küche](https://mhoennig.github.io/werkbaum/?sourceUrl=https://raw.githubusercontent.com/mhoennig/werkbaum/main/docs/examples/example-plan-1.werkbaum)** | ein Plan ohne Software, viele Alternativen — gut für den Günstigster-Pfad-Schalter |
|
||||
| **▶ [2 · Community-Konferenz](https://mhoennig.github.io/werkbaum/?sourceUrl=https://raw.githubusercontent.com/mhoennig/werkbaum/main/docs/examples/example-plan-2.werkbaum)** | ein breiter Plan mit vielen Beteiligten; horizontal vs. kompakt vergleichen |
|
||||
| **▶ [3 · Drei Arbeitsstränge](https://mhoennig.github.io/werkbaum/?sourceUrl=https://raw.githubusercontent.com/mhoennig/werkbaum/main/docs/examples/example-plan-3.werkbaum)** | mehrere Wurzeln = mehrere Bäume nebeneinander |
|
||||
| **▶ [Werkbaum selbst](https://mhoennig.github.io/werkbaum/?sourceUrl=https://raw.githubusercontent.com/mhoennig/werkbaum/main/docs/examples/example-werkbaum.werkbaum)** | Bestand und mögliche Weiterentwicklung |
|
||||
|
||||
(Die Links zeigen auf den latest build 🚧; die stabile Instanz kann `sourceUrl`
|
||||
ab ihrem nächsten Produktions-Deploy.)
|
||||
|
||||
Der geladene Text wird als **eigenes Dokument** geführt, dessen **Name die URL**
|
||||
ist — eigene Dokumente bleiben unberührt, und derselbe Link aktualisiert dieses
|
||||
@@ -60,6 +69,10 @@ eine Dokument, statt Kopien anzuhäufen. Die URL ist die Quelle der Wahrheit: Si
|
||||
wird bei jedem Laden neu geholt, lokale Änderungen daran überleben ein Neuladen
|
||||
also nicht.
|
||||
|
||||
Notationsdateien tragen die Endung **`.werkbaum`** (UTF-8; siehe `docs/SPEC.md`
|
||||
§12 und D24) — Konvention, kein Vertrag: `sourceUrl` liest jede per http(s)
|
||||
erreichbare Textdatei, unabhängig von Endung und Content-Type.
|
||||
|
||||
**Einschränkung — CORS:** Der Browser lädt fremde Hosts nur, wenn sie
|
||||
`Access-Control-Allow-Origin` senden. `raw.githubusercontent.com` und
|
||||
GitLab-Raw-Links tun das; ein beliebiger Webserver oft nicht. Scheitert das
|
||||
|
||||
Reference in New Issue
Block a user