Hitri začetek: ustvarjanje in vstavljanje izseka

Najkrajša pot od »vtičnik je nameščen« do »isti izsek je na dveh straneh in se vzdržuje na enem mestu«. Trije koraki, približno pet minut.

• wksnippet je nameščen in vklopljen v upravitelju razširitev.
• Prijavljeni ste kot skrbnik (superuser) – zaslon za urejanje je pridržan skrbnikom.
• V podatkovno mapo wikija je mogoče pisati. Izsek se shrani kot datoteka v <savedir>/wksnippet/, ne v mapo vtičnika; zato preživi vsako ponovno namestitev vtičnika.

Skrbništvo → Izseki, neposredno /doku.php?do=admin&page=wksnippet.

V vrstici ukazov izberite Nov izsek. V stranskem predalu pod Ključ vpišite ime in izberite Ustvari. Dovoljene so črke, števke, vezaj in podčrtaj; ključ postane ime datoteke.

Stranski predal Nov izsek vpraša samo za ključ. Nato se odpre urejevalnik novega izseka. Vanj vpišite izvorno kodo HTML in izberite Shrani:

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

Shranjevanje zapiše datoteko <savedir>/wksnippet/contact_box.html. Pod urejevalnikom je pri Uporaba oznaka, ki jo vstavite v naslednjem koraku.

Uredite poljubno stran wikija in vpišite:

{{wk:snippet>contact_box}}

Okvir je na strani – ne glede na to, ali je DokuWikijeva nastavitev htmlok vklopljena. Prav to je namen paketa: HTML iz upravljane datoteke namesto HTML v besedilu strani.

Dva preizkusa:

• Isto vrstico vstavite še na drugo stran, izsek spremenite na zaslonu in znova naložite obe strani. Spremenili sta se obe.
• Na stran vpišite {{wk:snippet>neobstojeci_kljuc}}. Stran se še vedno izriše; v izvorni kodi HTML je komentar z manjkajočim ključem. Napačen ključ torej ničesar ne pokvari in tudi ne izgine brez sledi.

• wksnippet – referenca: vse oblike oznake, pomočnik za uporabo iz lastne kode in zakaj allowPhp potrebuje dve neodvisni stikali.
• wki18n – če naj izsek v vsakem jeziku prikazuje drugačno besedilo.