Brzi početak: stvaranje i umetanje isječka

Najkraći put od „dodatak je instaliran“ do „isti HTML blok stoji na dvije stranice, a održava se na jednome mjestu“. Tri koraka, otprilike pet minuta.

• wksnippet je instaliran i uključen u upravitelju proširenja.
• Prijavljeni ste kao superuser — zaslon za uređivanje namijenjen je samo administratorima.
• Direktorij za spremanje wikija je zapisiv. Isječak se pohranjuje kao datoteka u <savedir>/wksnippet/, a ne u mapi dodatka; zato preživljava svaku ponovnu instalaciju dodatka.

Administracija → WvdS Snippets, izravno /doku.php?do=admin&page=wksnippet.

Dodajte novi unos. Potrebno je dvoje.

Ključ — slova, znamenke, podvlaka i spojnica:

contact_box

Sadržaj:

<div class="contact-box">
  <h3>Kontakt</h3>
  <p>info@example.com</p>
</div>

Spremanje zapisuje datoteku <savedir>/wksnippet/contact_box.html.

Uredite bilo koju wiki stranicu i upišite:

{{wk:snippet>contact_box}}

Okvir stoji na stranici — i to neovisno o tome je li uključena vlastita DokuWiki postavka htmlok. U tome i jest smisao: HTML iz upravljane datoteke umjesto HTML-a u tekstu stranice.

Dvije protuprovjere:

• Postavite isti redak na drugu stranicu, promijenite isječak na zaslonu i ponovno učitajte obje. Obje su se promijenile.
• Upišite {{wk:snippet>nepostojeci_kljuc}} na stranicu. Stranica se i dalje prikazuje; u HTML izvoru stoji komentar s imenom nedostajućeg ključa. Pogrešan ključ ne lomi ništa, ali ni ne nestaje bez traga.

• wki18n — ako isječak treba prikazivati različit tekst po jeziku.
• wksnippet (njemački) — stranica paketa: svi oblici oznake, pomoćnik za poziv iz vlastitog koda i zašto allowPhp treba dvije nezavisne sklopke.