Schnelleinstieg: Den ersten Blogeintrag veröffentlichen

Der kürzeste Weg von „Plugin ist installiert“ zu „ein Beitrag steht in der Liste“. Vier Schritte, etwa zehn Minuten. Der Bildschirm Neuen Beitrag anlegen nimmt Ihnen dabei den Metadatenblock ab, den Sie sonst von Hand schreiben müssten.

Voraussetzungen

wkblog ist installiert und aktiviert — und zusammen mit ihm wkcore und wksqliteds. Beide sind erforderlich, nicht optional: Die Blog-Maschine läuft auf benannten SQL-Routinen, die wksqliteds bereitstellt und wkcore veröffentlicht. Es gibt keinen Rückfall auf eingebettetes SQL.
Sie sind als Superuser angemeldet.
Sie dürfen in dem Namensraum Seiten anlegen, in dem der Blog liegen soll.

Schritt 1: Den Bildschirm öffnen

Administration → Blogs verwalten (WvdS Blog), direkt /doku.php?do=admin&page=wkblog.

Schritt 2: Den Beitrag anlegen

Wählen Sie Neuen Beitrag anlegen (/doku.php?do=admin&page=wkblog&admin=newpost) und füllen Sie aus:

Feld	Was hinein gehört
Titel	Die Überschrift des Beitrags. Aus ihr wird der Seitenname gebildet, wenn Sie keinen Slug angeben.
Ziel-Namespace (Sichtbarkeit)	Der Namensraum, in dem die Seite entsteht, zum Beispiel `de:site:blog`. Er entscheidet zugleich, wer den Beitrag sehen darf — über die gewöhnliche DokuWiki-ACL.
Blog-Vorlage	Der Blog, zu dem der Beitrag gehört.
Status	`Veröffentlicht` für diesen Durchgang.

Wählen Sie Anlegen und bearbeiten.

Schritt 3: Den Text schreiben

Sie stehen jetzt im Seiteneditor. Oben steht bereits der Metadatenblock, den der Bildschirm geschrieben hat, etwa:

<wk:blog type="post" status="published" blog="default" />

Schreiben Sie darunter den Beitrag und speichern Sie.

Beachten Sie, was hier nicht passiert ist: Sie haben nichts in eine Datenbank geschrieben. Sie haben eine Seite geschrieben; der Index folgt ihr beim ersten Rendern.

Schritt 4: Die Liste anlegen

Legen Sie die Startseite des Blogs an, zum Beispiel de:site:blog:start, und schreiben Sie:

<blog>
blog: default
limit: 10
sortby: created
</blog>

Ergebnis prüfen

Die Listenseite zeigt Ihren Beitrag mit Titel und Anrisstext.
Der Beitrag selbst öffnet sich als gewöhnliche Wiki-Seite — mit Versionsgeschichte, Unterschieden, Suche und Berechtigungen, weil er eine ist.
Gegenprobe für die Belastbarkeit des Index: Blog neu indizieren im Verwaltungsbildschirm. Der Beitrag ist danach unverändert da, denn er stand die ganze Zeit in der Seite. Ein Indexproblem hat deshalb die Antwort „neu aufbauen“ und nicht „wiederherstellen“.

Nächster Schritt

wkblog — Referenz: alle Attribute des Metadatenblocks, Listenarten, ~~READMORE~~, geplante Beiträge, Kommentare.
wkopengraph — damit ein geteilter Beitrag eine ordentliche Vorschaukarte bekommt. wkblog schreibt dieselben Seitenmetadaten, ein eigener <og>-Block ist dafür nicht nötig.
wksqliteds — der Unterbau, auf dem die Routinen laufen.