Avvio rapido: creare e aprire il primo progetto

Il percorso più breve da «il plugin è installato» a «un progetto esiste, porta una barra di hub e il vostro account vi ha un ruolo». Tre passi, circa dieci minuti.

Prerequisiti

wkdocore e wkcore sono installati e attivati.
Potete creare pagine e gestire gruppi.
Gli altri pacchetti DevOps sono facoltativi. Un hub il cui plugin manca semplicemente non compare — non rompe nulla.

Passo 1: stabilire la radice dei progetti

Amministrazione → Configurazione, sezione wkdocore, impostazione projectroot. Ogni namespace immediatamente al di sotto è un progetto.

Stabilitelo prima di creare contenuti: è l'unica impostazione che decide che cosa valga come progetto.

In questa installazione projectroot vale {lang}:projects e projectlangs vale de,en,hr,it,sl. Il segnaposto {lang} viene risolto per ciascuna voce, quindi un progetto sta sotto de:projects:, it:projects: e così via. Esempio esistente: de:projects:dwplugins.

Passo 2: creare il progetto creando una pagina

Creare una pagina sotto la radice:

it:projects:acme:start

È l'intera procedura. Con autodiscover — il valore predefinito — il progetto acme ora esiste, ricavato dal namespace. Non c'è registrazione né voce da mantenere.

Se un progetto deve essere noto prima che qualcuno ne crei il contenuto, aggiungete il suo slug anche a knownprojects.

Passo 3: concedere l'accesso tramite gruppi

L'appartenenza si esprime in nomi di gruppo composti da roleprefix e dallo slug del progetto:

@dwdo_acme_maintainers
@dwdo_acme_contributors
@dwdo_acme_readers

Inserire il proprio account in uno di essi in Amministrazione → Gestione utenti. Non esiste un secondo archivio di appartenenze da tenere allineato con gli utenti del wiki.

I ruoli stanno sopra l'ACL di DokuWiki, non la sostituiscono. L'ACL decide chi vede una pagina; il ruolo chi può operare le funzioni del progetto. Senza permesso di lettura sul namespace il ruolo non vale nulla.

Verifica del risultato

Aprire it:projects:acme:start.

Sopra il contenuto sta la barra degli hub con Panoramica, Dashboard, Board, Repository, Pipeline, Wiki, Query e Impostazioni — meno quelli il cui plugin non è installato.
Impostazioni compare solo se il vostro account porta almeno il ruolo Manutentore.
Se la barra manca del tutto, il vostro template non ha un punto d'aggancio e fallbacknav è disattivato. In questa installazione fallbacknav vale 0, perché il template wkbizway porta un proprio punto d'aggancio.

Un hub può mancare per tre ragioni del tutto diverse, e dalla pagina tutte e tre si somigliano:

Causa	Dove verificare
Il plugin non è installato	gestore delle estensioni
L'interruttore è spento	impostazione `disabledhubs`
Il ruolo non basta	i gruppi dell'account nella gestione utenti

Passo successivo

Dal progetto al codice sorgente — lo stesso percorso dal lato di chi legge.
wkdoworkitems — il primo elemento di lavoro, di cui vivono board, query e dashboard.
wkdoado — la connessione ad Azure DevOps.
wkdocore (in tedesco) — la pagina del pacchetto: oggetto di contesto, modello dei ruoli, tutte le impostazioni.