Intern · Version v1.21 · 01.11.2025

HBW Architektur & Leitplanken

Fixstern für Redaktion & Betrieb: So bauen, benennen und veröffentlichen wir das Handbuch. Diese Seite dokumentiert die Konventionen nach Anweisungen v1.11 und dient als Referenz für Importer-Header, URL-Regeln, Seitentypen, Versionierung, QA und Workflow.

1) Informationsarchitektur (IA)

• Top‑Level (öffentlich): /grundlagen/ · /theorie/ · /praxis/ · /synthese/ · /bibliothek/ · /glossar/
• Intern: /intern/ (Projektboard, Linkcheck, Architektur/Spezifikationen, Updates‑Log)
• Konzept: /konzept/ (Gesamtkonzept, Leitidee, Fundament, Aufbau/Pyramide, Theorie/Praxis/Synthese‑Konzepte)
• Navigationsregel: Hauptmenü nur öffentliche Routen; Intern bleibt ausgeblendet.

2) URL-, Slug- & Anker-Konventionen

• Slugs klein, sprechend; Umlaute umschreiben: ä→ae, ö→oe, ü→ue, ß→ss; keine Leerzeichen/Unterstriche.
• Interne Links ab Root (z. B. /praxis/atmung-kohaerenz/ · /glossar/#vorhersagefehler).
• HTML immer als Fragment (kein Doctype/Head); keine Inline‑JS/Styles im Body.

3) Seitentypen & Vorlagen

3.1) Standard‑Artikel (One‑Pager)

<!-- HWB
{
  "schema": 1,
  "version": "vX.Y",
  "updated": "YYYY-MM-DDThh:mm:ss+01:00",
  "permalink": "/bereich/{slug}/",
  "post_type": "page",
  "status": "publish",
  "title": "{Titel}",
  "parent": "/bereich"
}
-->
<p class="meta muted hbw-version">{Bereich} · Version vX.Y · TT.MM.JJJJ</p>
<h1>{Titel}</h1>
… Inhalt in wenigen Kapiteln, dichte Absätze …
<h2>Weiterführend</h2>
<ul>
  <li><a href="/glossar/#begriff">Glossar: Begriff</a></li>
  <li><a href="/bibliothek/dossiers/…">Dossier</a></li>
  <li><a href="/lesepfade/">Lesepfade</a></li>
</ul>

3.2) Glossar

Anker je Begriff (kebab‑case, umgeschriebene Umlaute). Kurzdefinition + ggf. 1–3 Belege. Beispiel: /glossar/#no-report-paradigma.

3.3) Praxis‑Hub

Volltexte/Varianten/Kontraindikationen im Hub; Theorie‑Artikel dürfen max. eine Mini‑Probe (≈ 250 W) inline einbinden und verlinken dann auf den passenden Praxis‑Anker.

3.4) Bibliothek / Dossier

Permalink: /bibliothek/dossiers/{slug}/. Bausteine: Kontext · Schlüsselpaper (DOIs) · ggf. kurze Grafik · Links zu Artikeln.

4) Versionierung & Sichtbarkeit

• Schrittgrößen: +0.01 Patch · +0.1 Ausbau · +1 Major. Nie senken; immer ≥ live.
• Sichtbare .hbw-version auf jeder Seite (Datum/Version) **für alle** sichtbar.
• Kein Rückbau: Wortzahl/Tiefe ≥ vorher (Interlinks, Glossar, Lesepfade, Praxis‑Links).

5) Arbeitsablauf

1. Live lesen → Diff bilden → additiv erweitern (Text/Beispiele/Links).
2. Frontmatter: version erhöhen, updated setzen; .hbw-version im Body aktualisieren.
3. Upload → Mini‑Importer auslösen → /intern/updates/ prüfen.
4. Delta‑Log im Dokumentende pflegen.

6) QA & Definition of Done

• Header vollständig (schema, version, updated, permalink, post_type, status, title).
• Slug‑Regel eingehalten; interne Links/Anker getestet; „Weiterführend“ am Ende vorhanden.
• One‑Pager‑Stil; Ton: warm, du; keine Überschriftsinflation.
• Nach Import: Permalink korrekt (kein -2), Autor korrekt, Version sichtbar.

7) Upload & Import (Kurz)

• Upload: *.html, *.css, *.md, *.php nach wp-content/updates_ki_html/; Flag RUN_IMPORT.flag setzen.
• Importer Mini v0.3.4 (Frontend‑Trigger) verarbeitet FIFO; richtet sich ausschließlich nach permalink.
• Log & Kontrolle: /intern/updates/.

8) Fehlerbilder & Sofortmaßnahmen

• „-2“-Duplikate: Frontmatter‑Permalink prüfen; Duplikat löschen; Datei erneut importieren.
• Verschwundene Top‑Level‑Seite: Parent im WP auf „(keine)“; neu importieren.
• „Last write wins“: Im Upload‑Ordner nur die neueste Datei pro Seite bereithalten; erneut hochladen.

9) Checklisten

Vor Upload

• [ ] Header vollständig · version erhöht · updated gesetzt
• [ ] Dateiname führt zu Permalink; Slug‑Regel eingehalten
• [ ] Interne Links/Anker getestet; kein Längen‑/Tiefenrückschritt
• [ ] Datei als Downloadlink bereitgestellt (keine Fragmente)

Nach Import

• [ ] /intern/updates/ zeigt Eintrag (Version neu→alt); Zielseite ok; Autor korrekt
• [ ] Keine neuen -2/-3‑Duplikate

10) Maschinenlesbarer IA‑Block (Referenz)

<!--HBW-IA
{
  "areas": [
    { "slug": "grundlagen", "path": "/grundlagen/" },
    { "slug": "theorie",    "path": "/theorie/" },
    { "slug": "praxis",     "path": "/praxis/" },
    { "slug": "synthese",   "path": "/synthese/" },
    { "slug": "bibliothek", "path": "/bibliothek/" },
    { "slug": "glossar",    "path": "/glossar/" }
  ],
  "internal": ["/intern/projektboard/","/intern/linkcheck/","/intern/hbw-architektur/","/intern/updates/"],
  "rules": {
    "slug": "lowercase, ae/oe/ue/ss, no spaces",
    "doctype": "fragment-only",
    "visible_version": true,
    "weiterfuehrend_at_end": true
  }
}
HBW-IA-->

Weiterführend

• Projektboard
• Interner Linkcheck
• Importer‑Log