Schnelleinstieg: Das erste Projekt anlegen und öffnen

Der kürzeste Weg von „Plugin ist installiert“ zu „ein Projekt besteht, hat eine Hub-Leiste und Ihr Konto hat darin eine Rolle“. Drei Schritte, etwa zehn Minuten.

Voraussetzungen

wkdocore und wkcore sind installiert und aktiviert.
Sie dürfen Seiten anlegen und Gruppen verwalten (Benutzerverwaltung).
Die übrigen DevOps-Pakete sind freiwillig. Ein Hub, dessen Plugin fehlt, erscheint schlicht nicht — er bricht nichts ab.

Schritt 1: Die Projektwurzel festlegen

Administration → Konfiguration, Abschnitt wkdocore, Einstellung projectroot. Jeder Namensraum unmittelbar darunter ist ein Projekt.

Legen Sie das fest, bevor Sie Inhalte anlegen: Es ist die eine Einstellung, die entscheidet, was überhaupt als Projekt gilt.

Auf dieser Installation steht projectroot auf {lang}:projects und projectlangs auf de,en,hr,it,sl. Der Platzhalter {lang} wird je Eintrag ausgewertet; ein Projekt liegt hier also unter de:projects:, en:projects: und so fort. Vorhandenes Beispiel: de:projects:dwplugins.

Schritt 2: Das Projekt anlegen, indem Sie eine Seite anlegen

Legen Sie eine Seite unterhalb der Wurzel an:

de:projects:acme:start

Das ist der ganze Vorgang. Mit autodiscover — der Vorgabe — besteht das Projekt acme jetzt, abgeleitet aus dem Namensraum. Es gibt keine Anmeldung und keinen Eintrag zu pflegen.

Soll ein Projekt schon bekannt sein, bevor jemand Inhalte angelegt hat, tragen Sie seinen Schlüssel zusätzlich in knownprojects ein.

Schritt 3: Zugang über Gruppen geben

Die Mitgliedschaft steht in Gruppennamen aus roleprefix und dem Projektschlüssel:

@dwdo_acme_maintainers
@dwdo_acme_contributors
@dwdo_acme_readers

Tragen Sie Ihr Konto in Administration → Benutzerverwaltung in eine davon ein. Es gibt keinen zweiten Mitgliedschaftsspeicher, der mit den Wiki-Benutzern in Übereinstimmung gehalten werden müsste.

Die Rollen liegen über der DokuWiki-ACL, sie ersetzen sie nicht. Die ACL entscheidet, wer eine Seite sieht; die Rolle, wer die Funktionen des Projekts bedienen darf. Ohne Leserecht auf dem Namensraum nützt die Rolle nichts.

Ergebnis prüfen

Öffnen Sie de:projects:acme:start.

Über dem Inhalt steht die Hub-Leiste mit Übersicht, Dashboard, Boards, Repos, Pipelines, Wiki, Abfragen und Einstellungen — abzüglich derer, deren Plugin nicht installiert ist.
Einstellungen erscheint nur, wenn Ihr Konto mindestens die Rolle Maintainer trägt.
Fehlt die Leiste ganz, hat Ihre Vorlage keine Einhängestelle dafür und fallbacknav ist ausgeschaltet. Auf dieser Installation steht fallbacknav auf 0, weil die Vorlage wkbizway eine eigene Einhängestelle mitbringt.

Ein Hub kann aus drei ganz verschiedenen Gründen fehlen, und von der Seite aus sehen alle drei gleich aus:

Ursache	Wo Sie nachsehen
Das Plugin ist nicht installiert	Erweiterungsmanager
Der Schalter ist aus	Einstellung `disabledhubs`
Die Rolle reicht nicht	Gruppen des Kontos in der Benutzerverwaltung

Nächster Schritt

Vom Projekt zum Quelltext — derselbe Weg aus Sicht der lesenden Person.
wkdoworkitems — das erste Arbeitselement, von dem Boards, Abfragen und Dashboard leben.
wkdoado — die Verbindung zu Azure DevOps.
wkdocore — Referenz: Kontextobjekt, Rollenmodell, alle Einstellungen.