Brontekst bekijken van Sjabloon:Documentatie/doc

{{Doc subpagina}}
<!-- Sjabloondocumentatie hieronder -->
{{sjvw|Sjabdoc|Sjablooninfo}}
Deze sjabloon wordt gebruikt voor de documentatie van pagina's, vooral van sjablonen. Het plaatst de documentatie in een omrande, gele box<includeonly>, zoals die waar je nu naar kijkt</includeonly>. Het sjabloon wordt voornamelijk gebruikt voor de documentatie van sjablonen, maar kan ook voor andersoortige documentatie, in andere [[Help:Naamruimte|naamruimten]] gebruikt worden.

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

== Gebruik ==
Het sjabloon wordt gebruikt met één parameter waarin de documentatie wordt geplaatst, aan het eind van de sjabloonpagina:<ref>Let op: de Engelstalige Wikipedia heeft andere conventies.</ref>

<syntaxhighlight lang="html+handlebars">
<!-- Laatste regel sjablooncode. --><noinclude>
{{Documentatie|1=
<!--
    Plaats hier de documentatie.
-->
}}

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

Plaats de <code>&lt;noinclude></code> 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 <code>&lt;noinclude></code>-tags.

=== Opmerkingen ===
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 <code>&amp;#124;</code> of het [[mw:Help:Magic_words/nl#Anders|''magic word'']] <code><nowiki>{{!}}</nowiki></code>.

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

== Aparte docpagina ==
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 <kbd>/doc</kbd>. Zie [[Wikipedia:Sjabloondocumentatie#Als subpagina|Wikipedia:Sjabloondocumentatie]] voor wanneer je een <kbd>/doc</kbd>-subpagina het best kunt gebruiken en wat de voor- en nadelen daarvan zijn.

Documentatie wordt dan gebruikt zonder parameters:

<syntaxhighlight lang="html+handlebars">
<!-- Laatste regel sjablooncode. --><noinclude>
{{Documentatie}}

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

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

Als de documentatie op een andere pagina staat dan de <kbd>/doc</kbd>-subpagina, kan {{para|pagina}} gebruikt worden, als volgt:

<syntaxhighlight lang="html+handlebars">
{{Documentatie|pagina=Sjabloon:Naam van gedeelde docpagina}}
</syntaxhighlight>

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

== Kop ==
Met {{para|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 [[Bestand:Test Template Info-Icon - Version (2).svg|x16px|alt=]] en eventuele links).

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

== Zie ook ==
* [[Wikipedia:Sjabloondocumentatie]] - Uitleg over de opbouw van sjabloondocumentatie.
* {{tl|Doc subpagina}} - Te plaatsen op <kbd>/doc</kbd>-subpagina's. Geeft aan dat de inhoud van die pagina documentatie is en linkt naar het gedocumenteerde sjabloon.
* [[:Categorie:Wikipedia:Sjablonen sjabloondocumentatie]] - Sjablonen die gebruikt kunnen worden voor de documentatie.
* {{en}} Uitleg [[meta:Help:Template#Noinclude, includeonly, and onlyinclude|<code>&lt;noinclude></code>]]-tags.
* [[Sjabloon:Documentatie/preload]]

== Voetnoot ==
{{References}}