Quickstart: activate the template and separate an area

The shortest way from “the template is installed” to “the wiki carries the house look, and the site area and the wiki area look different”. Three steps, about ten minutes.

Prerequisites

The template is in the wiki as lib/tpl/wkbizway. The folder name is the template's name and must match exactly.
You are signed in as superuser.

A template supplies appearance, never structure. The workbench, its regions and the redirects belong to wkfluentui and work under the template DokuWiki ships with too. The reason is structural: DokuWiki loads a template only after the action has been resolved — a template therefore cannot redirect.

Step 1: activate the template

Admin → Configuration, setting template:

template = wkbizway

Step 2: choose the colour scheme

Admin → Configuration, section tpl»wkbizway, setting Color scheme.

The choices are the schemes present as files under the template's css/schemes/ — currently riviera, night and white. A scheme is a file of token overrides; a new one comes into being by putting another file there.

Step 3: separate the site area from the wiki area

The template knows two reading surfaces: the site layout for the outward face and the wiki layout for the working surfaces. A namespace list decides which page gets which.

Set in section tpl»wkbizway:

enableAreaProfiles = 1

and enter one namespace per line under Namespaces that use the site layout, for example:

de:site
en:site

A page belongs to one when it sits in it or below it; with several matches the longest wins. Everything else uses the wiki layout. Blank lines and lines starting with # are ignored.

Switching area profiles off reverts every page at once to the site layout, not to the wiki layout.

Check the result

Open a page below one of the listed namespaces, en:site:start say. It shows the site layout.
Open a page outside them, en:wiki:start say. It shows the wiki layout — with the left action rail, the doc navigation and the page table of contents, provided those three switches in the same section are on.
Change the colour scheme and reload: the colours change, the arrangement does not. That separation is exactly the contract.

Next step

wkfluentui — the workbench, which works independently of the template.
wkbizway (German) — the package page: every template setting, landing components, header and footer.
Styles contract (German) — the --wk-* token contract.