Predloga:Dokumentacija/dok

To je dokumentacijska podstran za glavno stran Predloga:Dokumentacija.
Namenjena je shranjevanju navodil, kategorizaciji in drugi vsebini, ki ni del glavne strani.

To je predloga {{dokumentacija}}. Za podrobnejša navodila kako in kdaj uporabiti to predlogo, glej w:Wikipedija:Dokumentacija predloge.

Ta predloga prikaže zeleno dok škatlo, ki jo pravkar gledate in avtomatsko vanjo naloži vsebino iz /dok podstrani. Naloži see lahko tudi vsebina iz drgih strani, če le-ta vsebuje takšna navodila.

Namen te predloge je dokumentirati predloge in druge strani, ki so transkludirane iz druh strani. Uporablja se lahko v imenskem prostoru predlog in večino drugih imenskih prostorih.

Uporaba te predloge omogoča zaščito predlog, dokumentacijo pa lahko ureja vsakdo (dodaja kategorije, medjezikovne povezave, ...).

Uporaba

Ta predloga se uporablja brez parametrov in je umeščena na koncu predloge oz. strani, ki jo dokumentiramo, znotraj<noinclude>:

<!--Zadnja vrstica kode predloge--><noinclude>

{{dokumentacija}}
<!-- Dodaj kategorije in medjezikovne povezave (interwikije) na /dok podstran, ne tukaj! -->
</noinclude>

Ta predloga potem avtomatično naloži vsebino iz /dok podstrani predloge, ki jo je uporabila.

Ta predloga lahko naloži tudi vsebino iz katerekoli druge strani. Npr.:

<!--Zadnja vrstica kode predloge--><noinclude>

{{dokumentacija|Predloga:Druga stran/dok}}
</noinclude>

Kadar se nalaga dokumentacija iz druge strani, kot lastna /dok stran, postane težavno upravljati s kategorijami in medjezikovnimi povezavami.

Vsebina se lahko naloži tudi direktno kot besedilo. Npr:

<!--Zadnja vrstica kode predloge--><noinclude>

{{dokumentacija|content=
Primer besedila dokumentacije.
}}
</noinclude>

Ko se uporabi parameter |content=, dok škatla običajno ne prikaže [uredi] [osveži] povezave v zgornjem desnem kotu. Če /dok stran obstaja, se prikaže tudi njena povezava v spodnjem delu dokumetacijske škatle.

Parameter |1= in |content= sta lahko kombinirana, takole:

<!--Zadnja vrstica kode predloge--><noinclude>

{{dokumentacija
|1=Predloga:Ena stran/dok
|content=
{{Predloga:Ena stran/dok |parameteri}}
}}
</noinclude>

Ime strani se napolni v parameter 1, ki se uporabi v povezavah za [uredi] [osveži] in za /dok povezavo v polju povezav spodaj. Toda patrameter content se uporabi za vsebino prikazano v kok škatli. Zgornja koda pomeni, da je vsebina transkludirana iz {{Predloga:Ena stran/dok|parameteri}}.