Sjabloon:Sjabdoc

Uit Wikipedia, de vrije encyclopedie
Naar navigatie springen Naar zoeken springen
Sjabloondocumentatie​[bekijk] [bewerk] [ververs] [geschiedenis]

Deze sjabloon wordt gebruikt voor de documentatie van sjablonen. Het plaatst de documentatie in een omrande, gele box, zoals die waar je nu naar kijkt. Het sjabloon wordt voornamelijk gebruikt voor de documentatie van sjablonen, maar kan ook voor andersoortige documentatie, in andere naamruimten gebruikt worden.

Voor uitleg over de inhoud van sjabloondocumentatie, zie Wikipedia:Sjabloondocumentatie.

Gebruik[brontekst bewerken]

Het sjabloon wordt gebruikt met één parameter waarin de documentatie wordt geplaatst, aan het eind van de sjabloonpagina:[1]

<!-- Laatste regel sjablooncode. --><noinclude>
{{Sjabdoc|1=
<!--
    Plaats hier de documentatie.
-->
}}

[[Categorie:Wikipedia:Sjablonen ...]]
</noinclude>

Plaats de <noinclude> direct achter de sjablooncode, op dezelfde regel. Dit voorkomt mogelijk ongewenste witruimte op plekken waar het sjabloon gebruikt wordt.

Plaats categorieën buiten het sjabloon, maar bínnen de <noinclude>-tags.

Opmerkingen[brontekst bewerken]

Een verticale streep ("|") mag in de documentatie alleen binnen 2- en 3-voudige accolades voorkomen, omdat de hele tekst als parameterwaarde wordt gebruikt. Gebruik daarom in de overige gevallen &#124; of het magic word {{!}}.

Als de documentatie <includeonly>- of <noinclude>-tags binnen <nowiki>-tags bevat, vervang dan < door &lt;.

Aparte docpagina[brontekst bewerken]

Hoewel het niet is aanbevolen, kan het soms wenselijk zijn om de documentatie op een aparte pagina te hebben staan. Gebruikelijk is het in dat geval om die op een subpagina van het sjabloon te plaatsen met de naam /doc. Zie Wikipedia:Sjabloondocumentatie voor wanneer je een /doc-subpagina het best kunt gebruiken en wat de voor- en nadelen daarvan zijn.

Sjabdoc wordt dan gebruikt zonder parameters:

<!-- Laatste regel sjablooncode. --><noinclude>
{{Sjabdoc}}

[[Categorie:Wikipedia:Sjablonen ...]]
</noinclude>

Als de subpagina bestaat wordt de inhoud ervan automatisch in de box getranscludeerd. Daarnaast worden er bovenaan vier links getoond ( [bekijk] [bewerk] [ververs] [geschiedenis] ) die linken naar de /doc-pagina.

Als de documentatie op een andere pagina staat dan de /doc-subpagina, kan |pagina= gebruikt worden, als volgt:

{{Sjabdoc|pagina=Sjabloon:Naam van gedeelde docpagina}}

Dit is met name handig voor gedeelde documentatie. Ook hier verschijnen er vier links.

Kop[brontekst bewerken]

Met |kop= kan een alternatieve kop gekozen worden. In de sjabloon- en modulenaamruimte is de kop standaard Sjabloondocumentatie respectievelijk Moduledocumentatie. In alle andere naamruimten is deze standaard Documentatie.

Als deze parameter wel gedefinieerd is, maar leeg is, wordt de gehele kop weggelaten (inclusief afbeelding en eventuele links).

Parameteroverzicht[brontekst bewerken]

1
De documentatie.
pagina
De volledige naam van een pagina waarvan de inhoud in de box getranscludeerd moet worden. Als het de /doc-subpagina betreft, laat deze dan leeg.
kop
Kop bovenaan de box.

Zie ook[brontekst bewerken]

Voetnoot[brontekst bewerken]

  1. Let op: de Engelstalige Wikipedia heeft andere conventies.