Anlass
Das gegenwärtige Modul war ein netter Anfang, entspricht aber nciht mehr dem technischen Stand und unseren Layout-Prinzipien. Wir brauchen keine Tabs mehr innerhalb des Seiteninhalts zu setzen, da dieses durch Extensions geregelt wird. Fokus der Neu Ausrichtung sollte sein, die Handhabung der Vorlagen deutlich zu vereinfachen und einheitliche Doku-Vorlagen und Seiten zu erstellen.
Feature-Planung
Einbindung
Mit nur einem Aufruf von {{Dokumnetation}} soll in Zukunft kontextabhängig die Vorlageneinbindung gesteuert werden.
| Kontext | Verhalten |
|---|---|
| Vorlage: | Headerbox mit Documentation-plain-black.svg, Linkleiste, [[Kategorie:Vorlage mit Dokumentation]] |
| Modul: | Headerbox mit Module-info.svg, Linkleiste, [[Kategorie:Modul mit Dokumentation]] |
| /Doku-Seite zu Vorlage oder Modul | schmaler Header, automatische Kategorisierung Vorlagendokumentation / Moduldokumentation |
| ❌ anderer Namensraum | Warnbox „Nicht unterstützter Namensraum für Dokumentation“ |
Icons
- Alle Icons kommen von Commons oder werden selbst erstellt:
- Documentation-plain-black.svg für Vorlage
- Module-info.svg für Modul
- Icon steht links von „Dokumentation“ in der Kopfzeile
- Größe automatisch angepasst (ggf. per .wikonia-doku-icon-Klasse)
Parameter (optionale Verwendung)
| Parameter | Wirkung |
|---|---|
| sandbox | Link zur Sandbox anzeigen |
| demo | Link zur Demo-Seite anzeigen |
| templatedata | TemplateData-Block anzeigen (wenn vorhanden) |
| lua | Zeigt Lua-Hinweisbox ({{Dokumentation/Lua}})* |
| css | Hinweis aus Styling per CSS/UI-Gadget |
| protected | Schutzstatus |
| warnung | frei wählbare Warnhinweisbox |
* bestehende Vorlage, wird ggf. verschoben
Schutzstatus-Boxen
Gesteuer über |protected=
| Wert | Darstellung |
| (leer) | keine Box |
| teilschutz | "Nur bestätigte Benutzer" |
| templateschutz | "Nur Benutzer mit 'Template-Edit-Recht' (siehe T107) |
| vollschutz | "Nur Admins" |
Automatische KAtegorisierung
- Hauptseite erkennt Namensraum:
- [[Kategorie:Vorlage mit Dokumentation]] oder [[Kategorie:Modul mit Dokumentation]]
- /Doku-Seite:
- erkennt sich selbst anhand title.text:match("/Doku$")
- liest Basis-Titel, prüft Namespace → setzt [[Kategorie:Vorlagendokumentation]] oder [[Kategorie:Moduldokumentation]]
- Alle Kategorien werden im Lua-Output eingebaut, nicht händisch
Technische Details
- Kompaktes HTML-Markup
- Keine Emojis
- .wikonia-doku-header, .wikonia-doku-meta, .wikonia-doku-box als neue CSS-Klassen
- Farben aus --color-doku (hell für Hintergrund, abgesetzter Rahmen)