🔴 Hot News: wiki/Sjabloon:Dokumentasie/toetsgevalle - สรุปดราม่าล่าสุด

Dit is die sjabloontoetsgevallebladsy vir die sandput van Sjabloon:Dokumentasie. Maak hierdie bladsy skoon om die voorbeelde by te werk.
Indien daar baie voorbeelde is van 'n ingewikkelde sjabloon, kan latere voorbeelde breek as gevolg van beperkings in Mediawiki, sien die HTML-kommentaar "NewPP limit report" in die gelewerde bladsy.

Jy kan ook 'Brei sjablone uit' gebruik om die resultate van sjabloongebruike na te gaan.

Jy kan toets hoe hierdie bladsy in die verskillende baadjies lyk met die volgende skakels:

Keulen blou
MinervaNeue (mobile)
Modern
MonoBook
Vector legacy (2010)

Dokumentasie

[wysig bron]

----
{{Dokumentasie}}
----
{{Dokumentasie|Sjabloon:Dokumentasie/toetsgevalle/toets1}}
----
{{Dokumentasie|Sjabloon:Dokumentasie/toetsgevalle/toets2}}
----
{{Dokumentasie|content=Dit is inlyndokumentasie.}}
----
{{Dokumentasie|Sjabloon:Dokumentasie/toetsgevalle/nodoc|content=Dokumentasie.}}
----
{{Dokumentasie|Sjabloon:Dokumentasie/toetsgevalle/toets1|content=Dokumentasie.}}
----

Sjabloon:Cot

Sjabloondokumentasiesien wysig geskiedenis wis kasgeheue

Hierdie sjabloon word op baie blaaie gebruik en dus sal wysigings hiervan in baie artikels merkbaar wees.
Toets enige veranderings op die sjabloon se /sandput- of /toetsgevalle-subblaaie, of in jou eie gebruikersubblad.
Oorweeg dit asb. om veranderings op die besprekingsblad te bespreek voor dit aangebring word.

Kortpad:

S:DOK

Gebruik Lua:

Module:Dokumentasie

Hierdie blad is die {{Dokumentasie}}sjabloon.

Vir meeste van die instruksies oor hoe om die sjabloon te gebruik, sien Wikipedia:Sjabloondokumentasie.

Hierdie sjabloon vertoon 'n groen dokumentasiekas nes die een wat jy nou sien, en laai outomaties vanaf 'n /doc-subblad. Dit kan ook die inhoud vanaf ander plekke laai indien dit so beveel word.

Die sjabloon is geoormerk vir die dokumentering van sjablone en ander blaaie wat getranskludeer word na ander blaaie. Dit kan gebruik word in die sjabloonnaamruimte en meeste ander naamruimtes.

Gebruik van die sjabloon laat sjablone toe om beskerm te word waar nodig, terwyl enigeen toegelaat kan word om die dokumentasie en kategorieë te wysig.

Gebruik

[wysig bron]

Normaalweg word hierdie sjabloon gebruik sonder enige parameters, geplaas onderaan die sjabloon of blad wat gedokumenteer word, binne 'n <noinclude>...</noinclude> houer:

<!--Laaste reël van jou sjabloonkode--><noinclude>
{{Dokumentasie}}
<!-- Voeg kategorieë by tot die /doc subblad en interwiki's in Wikidata, nie hier nie! -->
</noinclude>

Dan laai hierdie sjabloon outomaties die inhoud vanaf die /doc subblad of die sjabloon waarin dit gebruik word.

Die sjabloon kan ook die inhoud vanaf enige ander blad laai, soos hieronder:

<!--Laaste reël van jou sjabloonkode--><noinclude>
{{Dokumentasie|Sjabloon:Ander blad/doc}}
</noinclude>

Neem kennis dat met die laai van die dokumentasie vanaf 'n verskillende blad as die plaaslike /doc blad dit moeilik raak om die kategorieë te bewerk.

Die inhoud kan ook direk ingevoer word as teks, soos hieronder:

<!--Laaste reël van jou sjabloonkode--><noinclude>
{{Dokumentasie
 | inhoud =
(dokumentasie)
}}</noinclude>

Met gebruik van die |inhoud=parameter, vertoon die doc-kas normaalweg nie die [wysig] en [skrap]-skakels links in die boonste regterhoek nie. Neem kennis dat indien die /doc-blad bestaan, 'n skakel steeds vertoon sal word in die kas onderaan die doc-kas.

Parameter |1= en die |inhoud= parameter kan ook gekombineer word, soos hieronder:

<!--Laaste reël van jou sjabloonkode--><noinclude>
{{Dokumentasie|1=Sjabloon:Enige blad/doc
| inhoud =
{{Sjabloon:Enige blad/doc |parameters}}
}}</noinclude>

Dan word die bladnaam wat as parameter 1 gevoer word gebruik vir die [wysig]- en [skrap]-skakels en vir die /doc-skakel in die skakelkas onder die doc-kas. Maar die inhoud parameter word gebruik vir die inhoud wat in die doc kas vertoon word. Die boonste kode beteken dat die inhoud ingetrek word as {{Sjabloon:Enige blad/doc|parameters}}. In hierdie voorbeeld word 'n parameter ook die /doc-blad gevoer wat hier gelaai word.

Beste praktyk

[wysig bron]

Die dokumentasiekode moet onderaan die sjabloonkode gevoeg word, met geen spasie voor <noinclude> nie - dit sal ekstra spasies tot gevolg hê in die blaaie waar die sjabloon gebruik word.

Kategorieë wat van toepassing is op die sjabloon self moet aan die onderkant van die /doc-sublad gevoeg word, binne <includeonly>...</includeonly> merkers. Interwiki-skakels wat op die sjabloon van toepassing is moet gelys word by d:|Wikidata]] (meer by Wikipedia:Wikidata). Vir meer ingewikkelde gevalle sien Wikipedia:Sjabloondokumentasie#Kategorieë en interwiki-skakels.

Indien die dokumentasieblad <includeonly>- of <noinclude>-merkers bevat as deel van die sigbare dokumentasieteks, vervang die "<" met "<".

Opskrif

[wysig bron]

Indien binne die sjabloonnaamruimte, sal die sjabloon die volgende opskrif wys:

Sjabloondokumentasie

In meeste ander naamruimtes, soos "Wikipedia:", sal dit die volgende opskrif wys:

Dokumentasie

Maar indien op Lêerblaaie (afbeelding) sal dit die volgende wys:

Opsomming

Die opskrif-parameter kan gebruik word om die opskrif te verander. Byvoorbeeld:

{{Dokumentasie|opskrif=Inligtingkasdokumentasie}}

Indien die opskrif-parameter leeg gelos word maar gedefinieer word, sal geen opskrif vertoon word nie asook geen [wysig] [skrap]-skakels nie. Byvoorbeeld:

{{Dokumentasie |opskrif=}}

Die opskrifstyl-parameter kan opsionele CSS-waardes gevoer word. Sonder aanhalingstekens " " maar met kommapunte ; aan die einde van elke stelling. Byvoorbeeld:

heading-style=font-size:150%;color:red;

Skakelkas

[wysig bron]

Onder die groot doc-kas is 'n klein skakelkas wat metadata oor die dokumentasie vertoon. Die skakelkas vertoon verskillende items afhangend van wat aan die parameters vir die sjabloon gevoer word en watter naamruimte gebruik word. In sekere gevalle word die skakelkas glad nie vertoon nie.

Om die skakelkas te verberg, voeg die parameter |skakelkas=af by.

Jou kan ook pasgemaakte teks in die skakelkas plaas, deur die |skakelkas=-parameter te definieer. Byvoorbeeld: |skakelkas=Hierdie dokumentasie word outomaties gegenereer deur [[Sjabloon:Inligtingskas]]

Outomatiese funksies

[wysig bron]

Indien die dokumentasieblad nog nie bestaan nie, sluit die [skep]-skakel 'n vooraflaaiblad in, sodat as daarop geklik word 'n voorafingevulde dokumentasieblad met die basiese dokumentasiebladformaat in die redigeerder oopgemaak word. Vooraflaaiteks word ook gebruik vir die /sandput en /toetsgevalle se [skep]-skakels.

Wanneer die sjabloon in 'n /sandput-subblad gebruik word sal dit outomaties die Sandputkennisgewing byvoeg.

Onderwerpnaamruimtes vs. bespreeknaamruimtes

[wysig bron]

Terminologie: Onderwerpnaamruimtes is die teenoorgestelde van bespreeknaamruimtes. Byvoorbeeld "Sjabloon:" is die onderwerpruimte van "Sjabloonbespreking:".

Hierdie sjabloon word normaalweg in 'n onderwerpnaamruimte geplaas, binne <noinclude>-merkers. In sommige gevalle is die sjabloon nodig op die besprekingsblad:

Binne die Mediawiki-naamruimte, sedert <noinclude> gereeld nie werk in stelselboodskappe nie, en sedert die Mediawiki-naamruimte skoon gehou moet word vir goeie werkverrigting.

Indien op besprekingsblaaie geplaas word, word die sjabloon normaalweg naby aan die bokant van die blad geplaas en sonder <noinclude>...</noinclude>-merkers.

Die /doc-, /sandput- en /toetsgevalle-blaaie sal normaalweg in die onderwerpnaamspasie voorkom, behalwe by naamspasies wat nie die MediaWiki subbladkenmerk ingeskakel het nie: Hoof, Lêer, Mediawiki en Kategorie. (Tans word slegs die /sandput- en /toetsgevalle-skakels vertoon vir Gebruiker-, Gebruikerbesprekings-, Sjabloon- en Sjabloonbesprekingsnaamruimtes.) Daar is ook 'n hele aantal ander tegniese redes hoekom die /doc-blad onder die besprekingsblad gestoor moet word vir daardie (en slegs daardie) naamruimtes.

Die sjabloon wys outomaties sy [skep]-skakel vir die /doc, /sandput en /toetsgevalle na die korrekte naamruimte.

Toets

[wysig bron]

Jy kan die uitset vir 'n gegewe blad simuleer deur die |blad=-parameter te gebruik. Byvoorbeeld, indien jy die kode |blad=Sjabloon:Inligtingskas gebruik, sal die sjabloon optree asof dit op die blad Sjabloon:Inligtingskas is, met die vertoon van die dokumentasie vanaf Sjabloon:Inligtingskas/doc daarby ingesluit en ook onder andere die skakel na Sjabloon:Inligtingskas/sandput. Die parameter is handig vir toetsdoeleindes en word intensief gebruik op die moduletoetsgevalleblad.

Tegniese besonderhede

[wysig bron]

Die vooraflaaiblad vir die /doc se [skep]-skakel is Sjabloon:Dokumentasie/vooraflaai. Die vooraflaaiblaaie vir die /sandput en /toetsgevalle se [skep]-skakels is Sjabloon:Dokumentasie/vooraflaaisandput en Sjabloon:Dokumentasie/vooraflaaitoetsgevalle.

Vir meer inligting, sien die besprekingsblad.

Volledige sintaks

[wysig bron]

{{Dokumentasie}}

{{Dokumentasie
 | inhoud =
}}

{{Dokumentasie
| [roete na dokumentasieblad]
| opskrifstyl = 
| opskrif = 
| skakelkas = 
}}

Sien ook

[wysig bron]

{{Dokumentasie subblad}}, 'n kennisgewing wat boaan 'n /doc-subblad geplaas word om sy rol te verduidelik asook om 'n skakel te verskaf na die blad wat gedokumenteer word.
Wikipedia:Sjabloondokumentasie is 'n selfhelpgids tot sjabloondokumentasie.
Wikipedia:Sjabloonsandputte en -toetsgevalle verduidelik die gebruik van die /sandput- en /toetsgevalle-subblaaie en sluit meer inligting in oor die toets van sjablone.

Die bostaande dokumentasie is ingesluit vanaf Sjabloon:Dokumentasie/doc. (wysig | geskiedenis)
Redigeerders kan eksperimenteer in hierdie sjabloon se sandput (wysig | verskil) en toetsgevalle (wysig) blaaie.
Plaas asseblief kategorieë op die /doc-subbladsy. Subbladsye vir die sjabloon.

Sjabloon:Cob

Sjabloondokumentasiesien wysig geskiedenis wis kasgeheue

toets1

[wysig bron]

toets1

Die bostaande dokumentasie is ingesluit vanaf Sjabloon:Dokumentasie/toetsgevalle/toets1. (wysig | geskiedenis)
Redigeerders kan eksperimenteer in hierdie sjabloon se sandput (wysig | verskil) en toetsgevalle (wysig) blaaie.
Subbladsye vir die sjabloon.

Sjabloondokumentasiesien wysig geskiedenis wis kasgeheue

toets2

[wysig bron]

toets2

Die bostaande dokumentasie is ingesluit vanaf Sjabloon:Dokumentasie/toetsgevalle/toets2. (wysig | geskiedenis)
Redigeerders kan eksperimenteer in hierdie sjabloon se sandput (wysig | verskil) en toetsgevalle (wysig) blaaie.
Subbladsye vir die sjabloon.

Sjabloondokumentasie

Dit is inlyndokumentasie.

Sjabloondokumentasieskep wis kasgeheue

Dokumentasie.

Redigeerders kan eksperimenteer in hierdie sjabloon se sandput (wysig | verskil) en toetsgevalle (wysig) blaaie.
Subbladsye vir die sjabloon.

Sjabloondokumentasiesien wysig geskiedenis wis kasgeheue

Dokumentasie.

Dokumentasie/sandput

[wysig bron]

----
{{Dokumentasie/sandput}}
----
{{Dokumentasie/sandput|Sjabloon:Dokumentasie/toetsgevalle/toets1}}
----
{{Dokumentasie/sandput|Sjabloon:Dokumentasie/toetsgevalle/toets2}}
----
{{Dokumentasie/sandput|content=Dit is inlyndokumentasie.}}
----
{{Dokumentasie/sandput|Sjabloon:Dokumentasie/toetsgevalle/nodoc|content=Dokumentasie.}}
----
{{Dokumentasie/sandput|Sjabloon:Dokumentasie/toetsgevalle/toets1|content=Dokumentasie.}}
----

Sjabloon:Cot

Sjabloondokumentasiesien wysig geskiedenis wis kasgeheue

{{ Script error: The function "contentTitle" does not exist.}}

Sjabloon:Cob

Sjabloondokumentasiesien wysig geskiedenis wis kasgeheue

{{ Script error: The function "contentTitle" does not exist.}}

Sjabloondokumentasiesien wysig geskiedenis wis kasgeheue

{{ Script error: The function "contentTitle" does not exist.}}

Sjabloondokumentasie

Dit is inlyndokumentasie.

Sjabloondokumentasieskep wis kasgeheue

Dokumentasie.

Redigeerders kan eksperimenteer in hierdie sjabloon se sandput (wysig | verskil) en toetsgevalle (wysig) blaaie.
Subbladsye vir die sjabloon.

Sjabloondokumentasiesien wysig geskiedenis wis kasgeheue

Dokumentasie.

Notas

[wysig bron]

For {{File mover granted}}:

Produksie Dokumentasie

[wysig bron]

{{Dokumentasie|page=Template:File mover granted|notest=y}}

Sjabloondokumentasieskep wis kasgeheue

Redigeerders kan eksperimenteer in hierdie sjabloon se sandput (skep | spieël) en toetsgevalle (skep) blaaie.
Plaas asseblief kategorieë op die /doc-subbladsy. Subbladsye vir die sjabloon.

Sandput Dokumentasie

[wysig bron]

{{Dokumentasie/sandput|page=Template:File mover granted|notest=y}}

Sjabloondokumentasieskep wis kasgeheue

Redigeerders kan eksperimenteer in hierdie sjabloon se sandput (skep | spieël) en toetsgevalle (skep) blaaie.
Plaas asseblief kategorieë op die /doc-subbladsy. Subbladsye vir die sjabloon.