Naar inhoud springen

Help:Gebruik van sjablonen

Uit Wikipedia, de vrije encyclopedie
Meer informatie over hoe sjablonen op Wikipedia worden toegepast staat op Wikipedia:Sjablonen.
Overzicht hulppagina's

Zie ook Regels en richtlijnen
Zie ook Artikelen bewerken

Overzicht beheerpagina's
Sjablonen in Wikipedia

Algemeen

Sjablonen voor:

Een sjabloon bevat artikelonderdelen (zoals tabellen, teksten, opmaakelementen, ...) die in de Nederlandstalige Wikipedia op veel plaatsen terugkomen. Zie over sjablonen ook: Wikipedia: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.

Sjablonen met parameters

[bewerken | brontekst 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. 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.

Eenvoudig voorbeeld

[bewerken | brontekst 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 | brontekst 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 | brontekst 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 | brontekst 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 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 Opmerking Om een verticale balk in te voegen als leesbare tekst kan beter de HTML-code "&VerticalLine;" 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 -->
}}

Hekje / Hashtag

[bewerken | brontekst bewerken]

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.

Standaardteksten in de Sjabloon-naamruimte

[bewerken | brontekst 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:

Meta (en)