Avvio rapido: attivare il template e separare un'area

Il percorso più breve da «il template è installato» a «il wiki porta l'aspetto di casa e l'area del sito e l'area wiki appaiono diverse». Tre passi, circa dieci minuti.

Prerequisiti

Il template è nel wiki come lib/tpl/wkbizway. Il nome della cartella è il nome del template e deve coincidere esattamente.
Siete autenticati come superuser.

Un template fornisce l'aspetto, mai la struttura. Il workbench, le sue regioni e i reindirizzamenti appartengono a wkfluentui e funzionano anche con il template fornito da DokuWiki. La ragione è costruttiva: DokuWiki carica un template solo dopo che l'azione è stata risolta — un template non può quindi reindirizzare.

Passo 1: attivare il template

Amministrazione → Configurazione, impostazione template:

template = wkbizway

Passo 2: scegliere lo schema di colori

Amministrazione → Configurazione, sezione tpl»wkbizway, impostazione Schema di colori.

Le scelte sono gli schemi presenti come file sotto css/schemes/ del template — attualmente riviera, night e white. Uno schema è un file di override dei token; uno nuovo nasce depositando un altro file lì.

Passo 3: separare l'area del sito da quella wiki

Il template conosce due superfici di lettura: il layout del sito per la facciata esterna e il layout wiki per le superfici di lavoro. Quale pagina riceve quale, lo decide un elenco di namespace.

Impostare nella sezione tpl»wkbizway:

enableAreaProfiles = 1

e inserire sotto Namespace con il layout del sito un namespace per riga, per esempio:

de:site
it:site

Una pagina vi appartiene se si trova nel namespace o al di sotto; con più corrispondenze vince la più lunga. Tutto il resto riceve il layout wiki. Le righe vuote e quelle che iniziano con # vengono ignorate.

Disattivare i profili di area riporta tutte le pagine in un colpo solo al layout del sito, non a quello wiki.

Verifica del risultato

Aprire una pagina sotto uno dei namespace elencati, per esempio it:site:start. Mostra il layout del sito.
Aprire una pagina al di fuori, per esempio it:wiki:start. Mostra il layout wiki — con la barra delle azioni a sinistra, la navigazione dei documenti e l'indice della pagina, se quei tre interruttori nella stessa sezione sono attivi.
Cambiare lo schema di colori e ricaricare: i colori cambiano, la disposizione no. È esattamente quella separazione il contratto.

Passo successivo

wkfluentui — il workbench, che funziona indipendentemente dal template.
wkbizway (in tedesco) — la pagina del pacchetto: tutte le impostazioni del template, i componenti della landing, intestazione e piè di pagina.
Styles-Contract (in tedesco) — il contratto sui token --wk-*.