Help:Gebruik van sjablonen

Uit Wikipedia, de vrije encyclopedie
Ga naar: navigatie, zoeken
Nuvola single chevron right.svg Meer informatie over hoe sjablonen op Wikipedia worden toegepast staat op Wikipedia:Sjablonen.
Overzicht hulppagina's
Wikipedia Hulppagina's

Zie ook Regels en richtlijnen
Zie ook Artikelen bewerken

Overzicht beheerpagina's
Sjablonen in Wikipedia

Een sjabloon bevat teksten die in de Nederlandstalige Wikipedia op veel plaatsen terugkomen. Zie over sjablonen ook: Wikipedia:Sjablonen.

Toepassingen[bewerken]

Sjablonen kunnen op verschillende manieren worden gebruikt:

  • Met {{blabla}} 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:blabla}} wordt de wikicode niet geëvalueerd (zoals met <nowiki> tags), maar letterlijk getoond. Dit wordt vrijwel niet gebruikt.
  • Met {{subst:blabla}} 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: zoals bij Sjabloon:Welkom.
  • 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: {{:paginanaam}}. Voor pagina's in een andere naamruimte dan de hoofdnaamruimte of sjabloon-naamruimte moet het naamruimtevoorvoegsel mede worden vermeld.

Sjablonen met parameters[bewerken]

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.

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.

Voorbeelden[bewerken]

Eenvoudig voorbeeld[bewerken]

We nemen Sjabloon:Test met als inhoud:
Begin-{{{1}}}-Einde<noinclude>

[[Categorie:Wikipedia:Sjablonen beheerpagina|Test]] </noinclude>

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

Complex voorbeeld[bewerken]

We nemen Sjabloon:Test2 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:Wikipedia:Sjablonen beheerpagina|test2]] </noinclude>

Syntax Resultaat Uitleg
{{Test2}} 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.
{{Test2|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, omdat er geen genummerde derde parameter in de tekst is opgenomen. Een parameter met een naam, zoals 'nummer', wordt pas ingevuld als 'nummer' een waarde krijgt door het '=' teken te gebruiken (zie hieronder).
{{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.
{{Test2|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. NB: Voor complexe parameterwaarden kan worden gekozen om '1=' en '2=' te gebruiken. Dit staat ook toe om anonieme parameterwaarden te husselen en een '=' te gebruiken in de parameterwaarde.
{{Test2

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

Extra functionaliteiten[bewerken]

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.

Sjablonen substitueren - ExpandTemplates[bewerken]

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 edit-scherm). Na aanklikken verschijnt de tekst waarin alle sjablonen zijn omgezet in wiki-tekst zonder sjablonen.

Geschiedenis[bewerken]

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

Nuvola single chevron right.svg Zie Wikipedia:Geschiedenis#Geschiedenis van sjablonen voor het hoofdartikel over dit onderwerp.

Standaardteksten in de Sjabloon-naamruimte[bewerken]

Er zijn verschillende soorten standaardteksten:

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

Pagina's op de Nederlandse Wikipedia en zusterprojecten met informatie over sjablonen, parserfuncties en magic words: