Vikipedija:Šablono dokumentacija

Dėmesio! Straipsnis šiuo metu yra aktyviai redaguojamas. Prašome nedaryti straipsnio pakeitimų, kol šis pranešimas yra rodomas. Tokiu būdu išvengsime redagavimo konfliktų. Norėdami sužinoti kas dirba prie straipsnio ir kada prasidėjo redagavimo sesija, skaitykite redagavimo istoriją.

Šablonai yra labai galinga MediaWiki funkcija, tačiau gali būti neaiški ir naujiems naudotojams, ir patyrusiems, jeigu jie naudoja sudėtingesnius šablonus. Dėl to šablonai turėtų būti pateikiami kartu su dokumentacija, kad būtų aiškiau, kaip juos reikia naudoti.

Šablono dokumentacija turėtų paaiškinti, ką šablonas daro ir kaip jį reikia naudoti. Ji turėtų būti paprasta, kad naudotojas be jokių šablono sintaksės žinių galėtų jį naudoti teisingai, ypač to reikia, jeigu šablonas yra plačiai naudojamas.

Kas turėtų būti dokumentacijoje

• Šablono tikslas: ką jis daro (jeigu tai ne akivaizdu).
• Šablono parametrai: ar jie numeruojami, pavadinami ar nebūtini, jeigu taip, kokie būtų pagal nutylėjimą ir kokį tada jie turėtų efektą.
• Šablono naudojimo pavyzdžiai: reikia nurodyti tikslų šablono vikitekstą, kuris turėtų būti naudojamas. Vikitekstas bus parodytas dokumentacijoje jį apgaubus <code>…</code> žyme. Tokiu atveju jį bus galima labai lengvai kopijuoti tiesiai iš pačio šablono puslapio.
• Susiję šablonai: jeigu šablonas yra šablonų grupės narys, reikėtų įtraukti nuorodas į juos.
• Kategorijos: kaip ir dokumentacija, kategorijos šablone turi būti apgaubtos po <noinclude>…</noinclude> žyme arba po <includeonly>…</includeonly> žyme, jeigu yra pateikiamos dokumentacijos puslapyje. Šablonų kategorijas galite rasti Kategorija:Šablonai puslapyje.

Šablono dokumentacija dažnai yra įdedama į šablono subpuslapį, kuris tada yra įtraukiamas šablono puslapio pabaigoje. Tai dažnai atskiria sudėtingą šablono kodą nuo dokumentacijos, be to, dokumentaciją tada tampa lengviau keisti.

Bet kokio šablono dokumentacija turėtų būti apgaubta <noinclude>…</noinclude> žyme, taip ji nepasirodys puslapyje, kuriame šablonas yra naudojamas.

Kaip reikia sukurti dokumentacijos subpuslapį

{{Documentation subpage}}
<!-- KATEGORIJAS ir INTERVIKI prašome rašyti į puslapio pabaigą -->

=== Panaudojimas ===

<includeonly>
<!-- KATEGORIJAS ir INTERVIKI prašome rašyti čia -->

</includeonly>