Spezifikation

Dieses Kapitel definiert die exakten Erkennungsregeln und Datenstrukturen, ko‑konstruiert zwischen Ahoiiiiiiii (menschlicher Kurator) und Geniestreich (KI‑Cokurator/Assistenz / Skript‑Generator).

Begriffe

  • Kapitelnummer (X)
  • laufende Nummer (Y)
  • Beitragsnummer (X.Y) = Kapitelnummer + ‘.’ + laufende Nummer
  • Referenznummer (n) = Zahl in “[n]”
  • Quickinfo: Beschreibungstext ab Referenzstart bis vor der ersten URL

Beitragserkennung (Quellenverzeichnis & Kapiteldateien)

  1. H2-Überschrift beginnt mit “##”.
  2. Enthält das Wort “Beitrag” (Groß-/Kleinschreibung egal).
  3. Erste Sequenz “Ziffern ‘.’ Ziffern” nach dem Wort “Beitrag” → Beitragsnummer X.Y.
  4. Alles andere (Gedanke, sonstige Überschriften) bleibt unverarbeitet.

Referenzblock im Quellenverzeichnis

  • Start: eigener Absatz exakt “[n]” → Beginn einer Referenznummer n.
  • Quickinfo: Danach folgende Absätze OHNE URL bis zum ersten Absatz MIT URL.
  • URL: Nur die erste gefundene (Markdown-Link oder nackte http/https). Weitere URLs bis zur nächsten Referenz ignoriert.
  • Ende eines Referenzblocks: Nächstes “[m]” oder nächste H2 oder Dateiende.

Kapitel-Verarbeitung

  • Finde Beitrag X.Y analog zur Erkennung oben.
  • Im aktiven Beitrag:
    • Fließtext: jedes “[n]” mit URL im Mapping → Link mit href=url, title=Quickinfo.
    • “[n]” ohne URL im Mapping → bleibt Text (Warnung / Severity abhängig von Phase).
    • Fußabsatz, der mit “[n]” beginnt: Alle vorhandenen Links darin erhalten title=Quickinfo, href=URL.

Nicht-Ziele

  • Keine automatische Reparatur fehlerhafter Headings.
  • Keine Erkennung von Bandtiteln oder Nicknames als strukturrelevante Marker.
  • Keine Mehrfach-URL-Verwendung pro Referenz.

Datenmodell

Mapping: beitragsnummer -> refNr -> { qi: String, url: String|undefined }

Revisionen:

  • 2025-11-09 Initialfassung
  • 2025-11-09 Terminologie vereinheitlicht