Naar inhoud springen

Sjabloon:Sjabdoc/doc

Uit Wikibooks
Dit is de documentatiepagina voor Sjabloon:Sjabdoc, daar ingevoegd.
Wanneer deze rechtstreeks wordt bekeken zullen links die gebruik maken van paginanaam-variabelen niet werken.

Deze sjabloon wordt gebruikt voor de documentatie van sjablonen. Aangezien de sjabloon ook op zichzelf is toegepast, kan hier het resultaat worden gezien.

Gebruik

[bewerken]

Plaats aan het eind van de sjabloonpagina[1]:

''[--laatste regel sjablooncode--]''<noinclude>
<!--
    Hier geen documentatie, plaats die in de /doc
-->
{{sjabdoc}}
<!--
    Plaats hier de categorieën en interwiki's.
-->
</noinclude>

Plaats de <noinclude> direct achter de sjablooncode, op dezelfde regel.

Als deze sjabloon wordt toegepast op een bestaande sjabloon, verplaats dan de documentatie naar de /doc pagina. Plaats de categorieën van het sjabloon tevens op de /doc-pagina tussen <noinclude> en </noinclude>.

Via de bewerk-link kan de /doc subpagina bewerkt worden. Als deze nog niet bestaat wordt de starttekst Sjabloon:Sjabdoc/preload automatisch geladen.

Voordeel

[bewerken]

Voordeel boven andere methoden, waaronder Sjabloon:Sjablooninfo:

  • Een sjabloon kan beveiligd worden terwijl de documentatie te bewerken blijft.

Opmerkingen

[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;.

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

Vergelijking met Sjabloon:Sjablooninfo

[bewerken]

Sjabloon:Sjablooninfo wordt standaard gebruikt en heeft de voorkeur als het sjabloon niet beveiligd is. Het heeft als voordeel dat niet persé een aparte pagina aangemaakt hoeft te worden en de documentatie en het sjabloon overzichtelijk bij elkaar te vinden zijn.

Stijl van die sjabloon:

Sjabloondocumentatie

{{{1}}}

Voetnoot

[bewerken]
  1. Let op, de Engelse Wikipedia heeft andere conventies.
Informatie afkomstig van https://nl.wikibooks.org Wikibooks NL.
Wikibooks NL is onderdeel van de wikimediafoundation.