Hitri začetek: ustvarjanje in vstavljanje izrezka

Najkrajša pot od „vtičnik je nameščen“ do „isti blok HTML stoji na dveh straneh in se vzdržuje na enem mestu“. Trije koraki, približno pet minut.

Predpogoji

wksnippet je nameščen in vklopljen v upravitelju razširitev.
Prijavljeni ste kot superuser — zaslon za urejanje je pridržan skrbnikom.
Podatkovni imenik wikija je zapisljiv. Izrezek se shrani kot datoteka v <savedir>/wksnippet/, ne v mapi vtičnika; zato preživi vsako ponovno namestitev.

Korak 1: odprite zaslon

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

Korak 2: ustvarite izrezek

Dodajte nov vnos. Potrebni sta dve stvari.

Ključ — črke, števke, podčrtaj in vezaj:

contact_box

Vsebina:

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

Shranjevanje zapiše datoteko <savedir>/wksnippet/contact_box.html.

Korak 3: postavite ga na stran

Uredite poljubno wiki stran in vpišite:

{{wk:snippet>contact_box}}

Preverjanje rezultata

Okvir stoji na strani — in to ne glede na to, ali je lastna DokuWikijeva nastavitev htmlok vklopljena. Prav v tem je smisel: HTML iz upravljane datoteke namesto HTML v besedilu strani.

Dve protipreverbi:

Postavite isto vrstico na drugo stran, spremenite izrezek na zaslonu in znova naložite obe. Obe sta se spremenili.
Vpišite {{wk:snippet>neobstojeci_kljuc}} na stran. Stran se še naprej izriše; v izvorni kodi HTML stoji komentar z manjkajočim ključem. Napačen ključ ne pokvari ničesar in tudi ne izgine brez sledu.

Naslednji korak

wki18n — če naj izrezek po jezikih prikazuje različno besedilo.
wksnippet (v nemščini) — stran paketa: vse oblike oznake, pomočnik za klic iz lastne kode in zakaj allowPhp potrebuje dve neodvisni stikali.