Handboek MediaWiki/Sjablonen

Een sjabloon bevat teksten die in de Wiki meermaals terugkomen. In een oudere versie van de wiki-software stonden deze sjablonen naast de standaard Wiki-teksten in de MediaWiki-naamruimte, maar inmiddels is daarin een strikte scheiding aangebracht en is een eigen Sjabloon-naamruimte hiervoor beschikbaar.

Toepassingen

De sjabloonteksten kunnen op verschillende manieren worden gebruikt:

• Met {{voorbeeldsjabloon}} wordt de inhoud van een van de Sjabloon-pagina's op een pagina weergegeven
• Met {{msgnw:voorbeeldsjabloon}} gebeurt hetzelfde, maar wikicode in de tekst wordt niet geëvalueerd (zoals met <nowiki> tags)
• Met {{subst:voorbeeldsjabloon}} wordt de tekst van de sjabloon ook daadwerkelijk op de pagina geplaatst alsof je het had ingetypt; de verwijzing verdwijnt dan. Wijzigingen in het sjabloon worden dan niet doorgevoerd op de pagina waar het sjabloon is ingevoegd.
• Met {{:sjabloon:voorbeeldsjabloon}} (een dubbele punt vooraf) krijg je een gewone link naar de sjabloon-pagina: zoals bij Begin-{{{1}}}-Einde.
• Iedere pagina kan als sjabloon gebruikt worden; voor een pagina in de hoofdnaamruimte moet de naam van de pagina voorafgegaan worden door een dubbele punt {{:voorbeeldpagina}}. Voor pagina's in een andere naamruimte dan de hoofdnaamruimte of sjabloon-naamruimte moet het naamruimtevoorvoegsel mede worden vermeld.

Sjablonen met parameters

Het is ook mogelijk variabelen mee te geven aan een sjabloon, zodat bepaalde delen van de tekst van een sjabloon aan te passen zijn aan de situatie. Dit kan in het sjabloon door {{{}}} (driedubbele accolades) in te voegen.

Voorbeelden

Eenvoudig voorbeeld

We nemen Sjabloon:voorbeeldsjabloon met als inhoud:
Begin-{{{1}}}-Einde<noinclude><br><br><br> ;;Dit sjabloon wordt gebruikt in [[Handboek MediaWiki/Sjablonen]]. Aub. niet aanpassen of verwijderen [[Categorie:Sjablonen voor een bepaald boek]] </noinclude>

Syntax	Resultaat	Uitleg
{{voorbeeldsjabloon}}	Begin-{{{1}}}-Einde	Omdat er geen parameter is opgegeven krijgen we {{{1}}} te zien.
{{voorbeeldsjabloon|honderd}}	Begin-honderd-Einde	{{{1}}} wordt vervangen door "honderd"

Complex voorbeeld

We nemen Sjabloon:voorbeeldsjabloon2 met als inhoud:
Dit is een {{{1}}} voorbeeld met {{{2|meerdere}}} parameters. <br>Zo moet iedereen dit nummer {{{nummer}}} kiezen. <br>Maar niet altijd ({{{nummer2|}}})<noinclude>[[Categorie:Sjablonen]]</noinclude>

Syntax	Resultaat	Uitleg
{{voorbeeldsjabloon2}}	Dit is een {{{1}}} voorbeeld met meerdere parameters. Zo moet iedereen dit nummer {{{nummer}}} kiezen. Maar niet altijd ()	Omdat er geen parameters zijn opgegeven krijgen we enkel tekst op de plaatsen waar dit op voorhand is ingesteld.
{{voorbeeldsjabloon2|goed|verschillende|TEST}}	Dit is een goed voorbeeld met verschillende parameters. Zo moet iedereen dit nummer {{{nummer}}} kiezen. Maar niet altijd ()	Enkel {{{1}}} en {{{2}}} worden vervangen. De derde parameter ("TEST") wordt genegeerd .
{{Test2|goed|nummer=100}}	Dit is een goed voorbeeld met meerdere parameters. Zo moet iedereen dit nummer 100 kiezen. Maar niet altijd ()	Als er andere parameters worden gekozen dan {{{1}}} en volgend dan moet men de parameter (hier "nummer=") zelf toewijzen.
{{voorbeeldsjabloon2|goed|meerdere|nummer=240|nummer2=2000}}	Dit is een goed voorbeeld met meerdere parameters. Zo moet iedereen dit nummer 240 kiezen. Maar niet altijd (2000)	Hier wordt alles getoond.
{{voorbeeldsjabloon2| |goed |meerdere |nummer=240 |nummer2=2000 }}	Dit is een goed voorbeeld met meerdere parameters. Zo moet iedereen dit nummer 240 kiezen. Maar niet altijd (2000)	Dit geeft hetzelfde resultaat enkel is dit makkelijker in te vullen.

Zie ook

Zie een uitgebreidere behandeling in het Engels op m:Help:Template.