Avvio rapido: pubblicare il primo articolo del blog

Il percorso più breve da «il plugin è installato» a «un articolo compare nell'elenco». Quattro passi, circa dieci minuti. La schermata Aggiungi articolo scrive al vostro posto il blocco di metadati che altrimenti andrebbe digitato a mano.

Prerequisiti

wkblog è installato e attivato — e con esso wkcore e wksqliteds. Entrambi sono obbligatori, non facoltativi: il motore del blog gira su routine SQL nominate che wksqliteds fornisce e wkcore pubblica. Non esiste un ripiego con SQL incorporato.
Siete autenticati come superuser.
Potete creare pagine nel namespace in cui starà il blog.

Passo 1: aprire la schermata

Amministrazione → Gestisci i blog (WvdS Blog), direttamente /doku.php?do=admin&page=wkblog.

Passo 2: creare l'articolo

Scegliere Aggiungi articolo (/doku.php?do=admin&page=wkblog&admin=newpost) e compilare:

Campo	Che cosa vi va
Titolo	Il titolo dell'articolo. Se non indicate uno slug, il nome della pagina ne deriva.
Namespace di destinazione (visibilità)	Il namespace in cui nasce la pagina, per esempio `it:site:blog`. Decide anche chi può vedere l'articolo — tramite la normale ACL di DokuWiki.
Modello di blog	Il blog a cui l'articolo appartiene.
Stato	Pubblicato per questo giro.

Scegliere Crea e modifica.

Passo 3: scrivere il testo

Vi trovate ora nell'editor della pagina. In cima c'è il blocco di metadati scritto dalla schermata, all'incirca:

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

Scrivere l'articolo sotto di esso e salvare.

Notate che cosa non è successo: non avete scritto in un database. Avete scritto una pagina; l'indice l'ha seguita alla prima resa.

Passo 4: creare l'elenco

Creare la pagina iniziale del blog, per esempio it:site:blog:start, e scrivere:

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

Verifica del risultato

La pagina di elenco mostra il vostro articolo con titolo e anteprima.
L'articolo stesso si apre come una normale pagina wiki — con cronologia delle revisioni, confronti, ricerca e permessi, perché lo è.
Controprova di quanto l'indice sia sacrificabile: Reindicizza il blog nella schermata di amministrazione. L'articolo resta invariato, perché è sempre stato nella pagina. Un problema di indice ha quindi come risposta «ricostruire», non «recuperare».

Passo successivo

wkopengraph (solo in inglese) — perché un articolo condiviso abbia una scheda di anteprima decente. wkblog scrive gli stessi metadati di pagina, quindi un blocco <og> separato non serve.
wksqliteds (solo in inglese) — lo strato su cui girano le routine.
wkblog (in tedesco) — la pagina del pacchetto: tutti gli attributi del blocco di metadati, i tipi di elenco, ~~READMORE~~, gli articoli programmati, i commenti.