Help:Gebruik van sjablonen

Sjablonen kunnen op verschillende manieren worden gebruikt:

• Met {{Sjabloonnaam}} wordt een verwijzing naar een sjabloon op de pagina geplaatst, en de geëvalueerde inhoud wordt getoond. Op deze wijze worden sjablonen vrijwel overal op het project gebruikt.
• Met {{msgnw:Sjabloonnaam}} wordt de wikicode niet geëvalueerd maar letterlijk getoond (vergelijkbaar met <nowiki>-tags). Dit wordt vrijwel niet gebruikt.
• Met {{subst:Sjabloonnaam}} wordt de inhoud van de sjabloon ook daadwerkelijk op de pagina geplaatst alsof je het had ingetypt; de verwijzing verdwijnt dan. Dit wordt alleen gebruikt in bijzondere situaties of indien dit wordt voorgeschreven in de sjabloonuitleg.
• Met [[Sjabloon:Welkom]] krijg je een gewone link naar de sjabloon-pagina, dus: Sjabloon:Welkom.
• Iedere pagina kan als sjabloon gebruikt worden; hiervan zijn twee varianten:
  • Je kunt een willekeurige pagina net als een sjabloon invoegen door de naam ervan tussen dubbele accolades te plaatsen. In dit geval moet in de hoofdnaamruimte de naam van de pagina (incl. naamruimtevoorvoegsel, indien van toepassing) worden voorafgegaan door een dubbele punt: {{:Paginanaam}}, om aan te geven dat je niet een sjabloon uit de sjabloon-naamruimte bedoelt.
  • Er is een speciale manier om te verwijzen naar subpagina's, waarmee in dit geval pagina's worden bedoeld met een schuine streep in de naam, waarbij het gedeelte tot de schuine streep de naam van de 'hoofdpagina' is. In dit geval hoef je tussen de accolades alleen het gedeelte vanaf de schuine streep te vermelden. Deze manier wordt bijvoorbeeld gebruikt op Wikipedia:Samenvoegen om de subpagina's met samenvoegvoorstellen uit een bepaalde maand hierin volledig op te nemen. Zo is met de code {{/201501}} de pagina Wikipedia:Samenvoegen/201501 ingevoegd.

Het is ook mogelijk parameters 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 de sjabloon door {{{}}} in te voegen. Tussen de accolades moet een volgnummer staan, te beginnen met 1, zoals {{{1}}}.

Sjablonen met parameters die rechtstreeks gebruikt worden op artikelen moeten in principe gebruik maken van TemplateData voor de visuele tekstverwerker. Aan de hand daarvan kunnen gebruikers die de visuele tekstverwerker gebruiken de parameters van de sjablonen correct invullen. Aan sjablonen die rechtstreeks alleen buiten de artikelnaamruimte worden gebruikt, voegen we geen TemplateData-code toe, omdat de visuele tekstverwerker alleen in de artikelnaamruimte functioneert en we overbodige code trachten te vermijden.

Een handige functie is het negeren van velden zodat deze leeg kunnen worden gelaten of zelfs niet worden opgegeven (handig als je achteraf een nieuw veld in de sjabloon zet). Zie voor het gebruik hiervan Help:Parserfuncties.

Soms is een artikel of sjabloon erg ingewikkeld geworden door het gebruik van geneste sjablonen, parameters, tabellen en parserfuncties. Om problemen hierin op te sporen kun je de functie Speciaal:ExpandTemplates/(Sjablonen substitueren) gebruiken. Vul in het bovenste veld van deze pagina de titel van de te vertalen pagina in, in het onderste veld de tekst van die pagina (vanuit het bewerkingsvenster). Na aanklikken verschijnt de tekst waarin alle sjablonen zijn omgezet in wiki-tekst zonder sjablonen.

Om een tabel te maken wordt er veelvuldig van een verticaal streepje gebruik gemaakt, dat ook wel een sluisteken wordt genoemd. Veel sjablonen zijn opgebouwd uit een of meerdere tabellen en veel onderdelen zijn optioneel gemaakt door middel van parserfuncties, die zelf ook gebruik maken van sluistekens. Wanneer er binnen een parserfunctie een (gedeelte van een) tabel wordt ingevoegd, moeten alle sluistekens tussen de accolades van een parserfunctie die niet van de parserfunctie zelf zijn, vervangen worden door {{!}}. Hiermee kan er een verticaal streepje worden toegepast in een parameter van een parserfunctie, zonder dat deze dan beschouwd wordt als het einde van de parameter.

  Opmerking Om een verticale balk in te voegen als leesbare tekst kan beter de HTML-code "|" gebruikt worden, of "<nowiki>|</nowiki>".

Stap 1: Hier wordt "tekst" getoond, als de parameter '1' niet leeg is:

{{#if:{{{1|}}}| 
tekst 
}}

Stap 2: Om conditioneel een nieuwe rij aan een tabel toe te voegen kan niet de volgende code gebruikt worden, omdat de verticale balken op de 2e en 3e regel geïnterpreteerd worden alsof ze behoren bij de #if:-functie:

{{#if:{{{1|}}}| 
|-    <!-- nieuwe rij in de tabel -->
|     <!-- nieuwe cel in de tabel -->
}}

Stap 3: Het gebruik van dit sjabloon i.p.v. een verticale balk maakt het wel mogelijk:

{{#if:{{{1|}}}| 
{{!}}-    <!-- nieuwe rij in de tabel -->
{{!}}     <!-- nieuwe cel in de tabel -->
}}

Om kleurcoderingen in RGB-codes op te geven is in de uiteindelijke codering een notatie als "#123456" nodig. In dit format kleurcoderingen als parameter voor een sjabloon meegeven lukt niet, omdat het hekje als wikicodering gelezen wordt en vervangen wordt door "1. ". Hoewel er geen expliciete foutmeldingen volgen doet de code dan niets. Om in een sjabloon een regel als <span style="color:{{{kleur|}}}; "> te kunnen gebruiken, leidt met

|kleur = #123456

tot:
<span style="color:<1. 123456; ">
Een browser kan daar geen kleur van maken. Wel werkt het als het hekje in het sjabloon wordt opgenomen: <span style="color:#{{{kleur|}}}; ">

|kleur = 123456

dit leidt nu tot:
<span style="color:#123456; ">

In een oudere versie van de software stonden deze sjablonen naast de systeemberichten in de MediaWiki-naamruimte, maar in 2004 is daarin een strikte scheiding aangebracht, en is een eigen Sjabloon-naamruimte hiervoor beschikbaar.

  Zie Wikipedia:Geschiedenis#Geschiedenis van sjablonen voor het hoofdartikel over dit onderwerp.

Er zijn verschillende soorten standaardteksten:

• Wikipedia:Sjablonen voor gebruikersboodschappen, voor meldingen als "Dit is een doorverwijspagina" en de onderdelen van de hoofdpagina;
• Wikipedia:Sjablonen voor artikelboodschappen;
• Help:Sjablonen voor afbeeldingen, sjablonen die extra functionaliteit bieden voor bestanden;
• Alle sjablonen.

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