Schnelleinstieg: Die Vorlage aktivieren und einen Bereich trennen

Der kürzeste Weg von „Vorlage ist installiert“ zu „das Wiki trägt das Hausbild, und Seitenbereich und Wiki-Bereich sehen unterschiedlich aus“. Drei Schritte, etwa zehn Minuten.

Voraussetzungen

Die Vorlage liegt als lib/tpl/wkbizway im Wiki. Der Ordnername ist der Name der Vorlage und muss genau stimmen.
Sie sind als Superuser angemeldet.

Eine Vorlage liefert Aussehen, nie Struktur. Werkbank, Regionen und die Weiterleitungen gehören wkfluentui und laufen auch unter der mit DokuWiki ausgelieferten Vorlage. Der Grund ist bauartbedingt: DokuWiki bindet eine Vorlage erst ein, nachdem die Aktion aufgelöst ist — eine Vorlage kann deshalb nicht umleiten.

Schritt 1: Die Vorlage aktivieren

Administration → Konfiguration, Einstellung template:

template = wkbizway

Schritt 2: Das Farbschema wählen

Administration → Konfiguration, Abschnitt tpl»wkbizway, Einstellung Farbschema.

Zur Wahl stehen die Schemata, die als Datei unter css/schemes/ der Vorlage liegen — derzeit riviera, night und white. Ein Schema ist eine Datei mit Token-Überschreibungen; ein neues entsteht, indem eine weitere Datei dort abgelegt wird.

Schritt 3: Den Seitenbereich vom Wiki-Bereich trennen

Die Vorlage kennt zwei Leseflächen: das Seiten-Layout für die Außendarstellung und das Wiki-Layout für die Arbeitsflächen. Welche Seite welches bekommt, entscheidet eine Namensraumliste.

Setzen Sie im Abschnitt tpl»wkbizway:

enableAreaProfiles = 1

und tragen Sie unter Namensräume mit Seiten-Layout je Zeile einen Namensraum ein, zum Beispiel:

de:site
en:site

Eine Seite gehört dazu, wenn sie im Namensraum oder darunter liegt; bei mehreren Treffern gewinnt der längste. Alles Übrige bekommt das Wiki-Layout. Leere Zeilen und Zeilen mit # werden übergangen.

Bereichsprofile auszuschalten schaltet sofort für alle Seiten auf das Seiten-Layout zurück, nicht auf das Wiki-Layout.

Ergebnis prüfen

Öffnen Sie eine Seite unterhalb eines der eingetragenen Namensräume, etwa de:site:start. Sie zeigt das Seiten-Layout.
Öffnen Sie eine Seite außerhalb, etwa de:wiki:start. Sie zeigt das Wiki-Layout — mit linker Aktionsleiste, Dokument-Navigation und Seiten-Inhaltsverzeichnis, sofern diese drei Schalter im selben Abschnitt eingeschaltet sind.
Wechseln Sie das Farbschema und laden Sie neu: Die Farben ändern sich, die Anordnung nicht. Genau diese Trennung ist der Vertrag.

Nächster Schritt

wkbizway — Referenz: alle Einstellungen der Vorlage, Landing-Bausteine, Kopf- und Fußbereich.
wkfluentui — die Werkbank, die unabhängig von der Vorlage funktioniert.
Styles-Contract — der Token-Vertrag --wk-*: wer sie definiert und wer sie nur liest.