Help:Templates/nl

Als u standaardtekst heeft die u in verschillende pagina's wilt opnemen, kunt u daarvoor sjablonen gebruiken. Anders dan bij extensies en mediabestanden is er voor sjablonen geen centrale bewaarplaats. Sjablonen kunnen nieuw worden geschreven of, om dubbel werk te voorkomen, worden geëxporteerd uit een andere wiki, bijvoorbeeld Wikipedia, en dan in de bestemde wiki worden geïmporteerd.

Aanmaken
Sjablonen zijn standaard wiki-pagina's waarvan de inhoud ontworpen is om te worden transcluded (ingebed) in andere pagina's. Sjablonen volgen de conventie dat de naam wordt voorafgegaan door " ", wat het aan die namespace toewijst. Daarnaast kun je ze als iedere andere wiki-pagina aanmaken.

Het meest eenvoudige gebruik van sjablonen gaat als volgt. Maak een pagina aan met de naam "Template:Welkom" met de volgende inhoud:

Hallo! Welkom bij de wiki.

U heeft uw eerste sjabloon gemaakt! Als u dan de volgende code gebruikt:

in een andere pagina, dan wordt "Hallo! Welkom bij de wiki." getoond in plaats van. De inhoud van het sjabloon is "ingebed" in de getoonde pagina.

U kunt  op elk punt op elke pagina plaatsen waar u iemand wilt verwelkomen. Stel dat dat op 100 pagina's wordt gedaan. Als u dan de inhoud van het sjabloon wijzigt naar:

Hallo allemaal! Welkom op onze mooie wiki.

en dan al die 100 pagina's opnieuw bezoekt waar het sjabloon gebruikt wordt, dan ziet u nu de nieuwe begroeting in plaats van de vorige. U past dus de inhoud van mogelijk heel veel pagina's aan zonder ze zelf per stuk te wijzigen, dit omdat de tekst van het sjabloon wordt overgenomen (transcluded) in deze pagina's.

Dit is de basis van het werken met sjablonen. Maar er zijn natuurlijk enkele aanvullende functies beschikbaar om het nog krachtiger te maken. Meestal zal het sjabloon een Engelse naam hebben, dus bijvoorbeeld Welcome, de Nederlandse naam wordt dan Welcome/nl. De tekst is dan een vertaling van de Engelse tekst.

Gebruik
Sjablonen kunnen op andere pagina's op de volgende manieren gebruikt worden:


 * : als boven beschreven, deze link (ook wel sjabloonaanroep genoemd) wordt automatisch vervangen door de huidige inhoud van het sjabloon Template:Name (ook wel transclusie genoemd) op het moment dat de betreffende pagina wordt geladen (dus bij het bekijken door een lezer van de wiki). Omdat de sjabloonaanroep in de bron van de pagina blijft staan zal een volgende wijziging van Template:Name worden gezien op een pagina die de sjabloonaanroep bevat. Ook wordt de pagina getoond op het overzicht met verwijzingen naar het sjabloon.
 * : als dit wordt gebruikt dan wordt dit type sjabloon eenmalig en blijvend vervangen in de broncode van de pagina die het sjabloon Template:Name gebruikt op het moment dat de pagina met de link wordt opgeslagen. Dat betekent, dat de inhoud van Template:Name wordt gebruikt om de sjabloonaanroep te vervangen. Er wordt geen link onderhouden tussen de pagina en het sjabloon, beide kunnen dus zonder gevolg voor de ander worden gewijzigd. In feite is er weinig verschil tussen het vervangen van de inhoud op deze manier en het eenvoudigweg "handmatig" typen in de bron van de pagina.
 * : dit is toegevoegd om het mogelijk te maken dat er een recursieve vervanging wordt gedaan als sjablonen aanroepen naar andere sjablonen of parserfuncties bevatten. Zie de helppagina over het vervangen in de Engelse Wikipedia voor meer informatie.
 * : dit toont de inhoud van het sjabloon in een vorm die de ruwe wiki syntaxis toont (zoals dat doet) bij het weergeven van de pagina die dit sjabloon bevat.

Een gewone wiki-pagina kan ook als sjabloon gebruikt worden, eenvoudig door de betreffende namespace aan te geven:


 * transclude de pagina van sjabloon, gelijkwaardig aan
 * transclude de pagina Talk:Pagename
 * transclude de pagina Pagename in de main namespace.
 * vervangt zichzelf met de inhoud van de pagina Pagename

Als de aangegeven namespace niet bestaat, dan wordt aangenomen dat de hele titel een sjabloon is:


 * transclude Template:Foo:Bar

Parameters
Om het mechanisme van transclusion nog meer te versterken, staat MediaWiki parameters toe bij de aanroep van een sjabloon. Hiermee kan het sjabloon door de schrijver van het artikel worden aangestuurd afhankelijk van de context.

Neem aan dat u een klein bedankje wilt plaatsen in de overlegpagina van andere gebruikers, zoals:

Het bedankje heeft dan een reden (voor al uw inzet) en een afzender (Frank Alberts). Het doel is dat iedereen, iedereen om een reden moet kunnen bedanken.

Een voordeel is dat een bedankje er overal (waar dan dit sjabloon wordt gebruikt) hetzelfde uitziet. U kunt bijvoorbeeld een sjabloon aanmaken. Het bedankje ziet er hetzelfde uit, maar de reden en degene die bedankt verschillen omdat het parameters zijn. Geef ze dan ook door als parameters. Als we de overige elementen even overslaan en het veld formatteren en de afbeelding plaatsen, dan is de inhoud van het (vertaalde) sjabloon ongeveer zo:

Let op het gebruik van  en. Dat is hoe de parameters in het sjabloon bekend zijn. Opvallend is dat elke parameter tussen drie accolades   staat. Dit is anders dan het normale gebruik van de sjabloonnaam.

Als het sjabloon op een pagina wordt gebruikt, dan vult u de waarden van de parameters in, gescheiden door een verticale streep. In de MediaWiki kunt u parameters op drie manieren doorgeven: Anoniem, Nummer en Naam.



Anonieme parameters
Om de parameters anoniem door te geven vult u ze in volgorde in:

In dit geval ontvangt het   sjabloon parameters   en , resultaat:

De volgorde is zeer belangrijk voor de werking van het sjabloon. Als u ze in deze volgorde doorgeeft:

dan is het resultaat:



Genummerde parameters
Om de parameter op nummer door te geven, identificeer elke parameter bij het doorgeven:

Het sjabloon  krijgt nu de parameters   en , ze staan in de verkeerde volgorde maar worden op nummer doorgegeven, dus het resultaat is:


 * Voorbeelden:

Resultaat:



Parameters met een naam
de derde manier om parameter door te geven is doorgeven op naam. De inhoud van het sjabloon wordt dan:

Een klein bedankje... voor. knuffel van

In het sjabloon gebruiken we  en   om de paramter te identificeren, in plaats van een nummer. Om deze parameters door te geven op naam, wordt het:

In dit geval krijgt het sjabloon  de parameters   en , het resultaat:

Parameters op naam zijn hoofdlettergevoelig, dus:

Resultaat:

Het voordeel van het gebruik van een naam in uw sjabloon, naast dat het flexibel is bij de volgorde van doorgeven, is dat het uw sjabloon beter leesbaar maakt als er veel parameters zijn.



Standaardwaarden
Als u een sjabloon gebruikt maar u geeft niet de benodigde parameters mee, zoals hier:

in het voorbeeld met genummerde parameters krijgt u het volgende:

Omdat er geen argumenten zijn meegegeven, gebruikt het sjabloon de parameters zelf, in plaats van de waarde. U kunt ook standaardwaarden voor een parameter aangeven, die worden dan gebruikt als de parameter niet wordt meegegeven.Voorbeeld met als inhoud van het sjabloon:

dan geeft de  aan dat als de parameter   niet wordt meegegeven, dat dan de waarde   wordt gebruikt. Bij de andere parameter gaat het op dezelfde manier. Met dit sjabloon krijgen we bij een aanroep van het sjabloon zonder meegegeven parameters:

Vaak wordt een standaardwaarde gebruikt om een alternatieve naam van de parameter te noemen. Voorbeeld, bij, het sjabloon zoekt eerst naar een parameter met de naam "a". Als die ontbreekt dan wordt de parameter met de naam "b" gebruikt. Als zowel "a" als "b" ontbreken, dan is er geen uitvoer.

Evaluatie
In het algemeen worden de parameters van een sjabloon vervangen in sjabloon als de tokens worden uitgewerkt. Ze worden pas geëvalueerd bij het gebruik.

Dit heeft gevolgen. Om te beginnen, als je een  hebt, die   bevat, en een   die   bevat, en   op een pagina zet, wordt mytemplate niet transcluded, omdat tokens als "|" niet toegevoegd kunnen worden door een sjabloon en de speciale betekenis kunnen behouden in een sjabloon. U kunt sjablonen gebruiken om de naam van de parameter of sjabloon te sturen, maar u kunt geen aanroep van een sjabloon splitsen tussen verschillende sjablonen.

Het tweede gevolg is de eliminatie van dode code. (Code die nooit wordt uitgevoerd.) Als u een sjabloon aanroep doet als  en Template:Foo bevat niet , dan wordt de displaytitle''  niet gebruikt, omdat het alleen wordt bekeken als het nodig is, er is geen parameter om er in te zetten. dus wordt het niet geëvalueerd. Dit speelt voornamelijk bij het gebruik van Extension:ParserFunctions, het kan vooral worden opgemerkt in combinatie met het magische woord , dat per taal verschilt.

Aanroepen van een sjabloon die starten met het magisch woord  of met   worden geëvalueerd in een afzonderlijke eerste verwerking die alleen wordt gedaan bij het opslaan, samen met ~ en links met de verticale streep (pipe) truc. Als ze dan niet kunnen worden geëvalueerd, dan wordt de  genegeerd en worden de   behandeld alsof het een normaal sjabloon is.

Veel parser-functies, tags en transcluded speciale pagina's worden niet direct ingevoegd zoals sjablonen maar worden vervangen door een "strip marker". Dit betekent dat u de resultaten niet kunt manipuleren met parser-functies als padleft: en vergelijkbare functies in extensies, die zien de 'strip marker' in plaats van het resultaat van de parser-functie.



Recursie in sjablonen
Het gebruiken van een sjabloon in het sjabloon zelf zorgt er niet voor dat de MediaWiki in een oneindige lus terecht komt. MediaWiki stopt met een recursie als de naam van het sjabloon vet is. Voorbeeld, als de inhoud van Template:Aaaa is, dan toont het "a a Template loop detected:  Template:Aaaa z z".



Verboden idioom (taalschat)
Deze beveiliging sluit het mogelijk handig gebruik van sjabloon uit waar het sjabloon zelf de eigen aanroep argumenten normaliseert. In dit verboden voorbeeld kan  worden aangeroepen als   en als. Op de eerste manier, roept het zichzelf aan met de structuur van het tweede argument (verkregen met parserfuncties), die daarna een verenigd pad van verwerking volgen.



Als  aangepast is voor recursie in   en   is een identieke handmatige kopie van   dan werkt deze manier goed als de beveiliging van de recursie dynamisch werkt en niet statisch.

Een manier voor de MediaWiki software om deze regel wat losser te maken zou het eisen zijn dat elke recursieve aanroep een verschillend aantal argumenten heeft en er maximaal een recursieve aanroep is met een gelijk aantal argumenten. Dat zou een sterke beveiliging zijn tegen een oneindige reeks aanroepen waardoor bruikbare manieren als hier beschreven toch gebruikt kunnen worden.

Als het verwerkingspad eenvoudig is, dan is een simpele oplossing alleen een sjabloon te gebruiken voor elke aanroepconventie op een gescheiden if/else tak, waarbij de logica dubbel in het verwerkingspad zit. Als het meer complex is, kan elke aanroepstructuur in een implementatie sjabloon worden gezet met een standaard aanroepstructuur die het uiteindelijke sjabloongedrag geeft.



Parameters met een tabel
Aangezien het pipe-teken en het gelijkheidsteken  verschillende betekenissen hebben in sjabloonaanroepen en wikitabellen, moet men, om tabelopmaak te gebruiken in de waarde van een sjabloonparameter, over het algemeen die tekens escapen (d.w.z. ze beschermen tegen interpretatie als sjabloonopmaak) met behulp van speciale reeksen:


 * the built-in magic word  provides an "escaped" version of   since MediaWiki 1.24
 * the built-in magic word  provides an "escaped" version of   since MediaWiki 1.39

Before the introduction of these magic words, many wikis used templates to accomplish the same things. On such a wiki, the magic words take precendence over the same-named templates.

Example table
Table code:

Escaped table code:

Note that the first left-brace is interpreted as a literal left-brace character because it is immediately followed by the   magic word. Similarly, the last right-brace is interpreted as a literal right-brace character because it is immediately preceeded by the same magic word. However, in some cases these brace characters do cause problems, so some wikis provide templates for escaping these characters, as well:


 * the template call  might provide an "escaped" version of
 * the template call  might provide an "escaped" version of

Some wikis go even further and provide other convenience templates like and. On such a wiki, the code can be simplified a bit to this form:



Controle sjabloon inclusie
Standaard wordt de gehele inhoud van het sjabloon getoond, zowel als het sjabloon wordt getoond als wanneer het via een pagina waarin dat sjabloon wordt gebruikt, gaat. U kunt wel bepalen welke delen van een sjabloon worden getoond en toegevoegd met gebruik van de tags, en.

Alles tussen en  wordt alleen getoond als de pagina van het sjabloon wordt getoond, dus niet als het sjabloon in een pagina is gebruikt. Dit is handig als u tekst of code wilt toevoegen in een sjabloon die u alleen in de sjabloon pagina wilt tonen, zoals:


 * Categorieën links bij het categoriseren van het sjabloon zelf
 * interlanguage links naar vergelijkbare sjablonen in een andere taal
 * Uitleg over hoe een sjabloon te gebruiken

Op een vergelijkbare manier wordt alles tussen en  verwerkt en getoond alleen als het sjabloon op een pagina wordt gebruikt en niet op de sjabloon-pagina zelf, dat kan nuttig zijn als:


 * Categoriseer pagina's die het sjabloon includen. NB: bij het wijzigen van de categorieën die aan een sjabloon zijn toegekend op deze manier kan het wijzigen wat later plaatsvinden: dit wordt afgehandeld in via de . Om het herindelen direct te forceren voor een bepaalde pagina, open die pagina voor wijzigen en sla de pagina zonder wijziging op.
 * Het er zeker van zijn dat de sjablooncode niet uitgevoerd wordt bij het bekijken van de sjabloon-pagina zelf. Dit is omdat het parameters verwacht en uitvoering zonder parameters geen goed resultaat zal geven.

Alles buiten en  wordt verwerkt en normaal getoond; zowel als de sjabloon-pagina wordt getoond als een pagina wordt getoond waarin dat sjabloon wordt gebruikt. De aandacht gaat naar wat er binnen die tags staat.

Alles buiten de tags wordt weggelaten bij de transclusie. Ook secties binnen includeonly worden overgeslagen bij de transclusie als ze tenminste niet ook de tags onlyinclude gebruiken. De aandacht gaat naar wat er buiten die tag staat.

Deze tags kunnen ook genest worden.

De drie gedeeltelijke transclusie tags maken elke combinatie mogelijk wat er verwerkt en opgebouwd wordt voor weergave. Ook commentaar vervult een rol.



Sjablonen organiseren
Om een sjabloon nuttig te maken moet een schrijver van een artikel het sjabloon kunnen vinden en kunnen opzoeken hoe het gebruikt kan worden.

Om te zoeken kan een schrijver:
 * 1) Klik op  ' > '
 * 2) In de lijst ', kies Template en klik op '.

Om informatie te geven over het gebruik, voeg op de sjabloon-pagina een voorbeeld toe zoals deze:

Gebruik
Welkom gebruikers:

Een schrijver kan de aanroep van het sjabloon dan simpel kopiëren en in het eigen artikel gebruiken.

Tijdens het bewerken van een pagina is er een lijst met alle gebruikte sjablonen beschikbaar onder het bewerkingsformulier, in een inklapbare sectie met de titel "" (ook wel "" of "" genoemd, afhankelijk van de context). Deze lijst bevat een handige koppeling naar de pagina van de sjabloon en informatie over de beveiligingsstatus. Omgeleide sjablonen worden cursief weergegeven, waarbij het omleidingsdoel als een afzonderlijk lijstitem wordt toegevoegd.



Linken naar een sjabloon
Een sjabloon-pagina kan naar elke wiki-pagina linken, dit gaat op dezelfde manier. Voorbeeld, de link Template:Navbar wordt gegenereerd door de wikicode  te gebruiken.

Op veel wiki's kan Template:Tl worden gebruikt voor een link naar een sjabloon geformatteerd op een manier die de "dubbele accolades" wikicode toont die nodig is om het sjabloon te transcluden zonder dat dan ook te doen. Voorbeeld, de code  kan worden gebruikt om de link Navbar te maken.

Deze constructie wordt meestal gebruikt bij het refereren aan sjablonen in de sjabloondocumentatie, help-pagina's en overleg-pagina's. Dit effect kan ook worden bereikt met gebruik van, maar bij manier   is minder tikwerk nodig. Op elke wiki met het sjabloon Tl, kan het wel/geen uitvoer opleveren van tekst in een "code-element" of als monospace-type. Indien niet (zoals op deze wiki), kan een ander sjabloon met een vergelijkbare naam dat doen. Een voorbeeld staat in de "See also" section of our Template:Tl documentation.



Van een wiki naar een andere wiki kopiëren
Bij een sjabloon is vaak CSS of een ander sjabloon verplicht, zodat gebruikers vaak moeilijkheden hebben bij het kopiëren van sjablonen van de ene wiki naar een andere wiki. Hieronder een uitleg die voor de meeste sjablonen wel zal werken.

MediaWiki code
Als u mag importeren (u heeft het recht importupload) op de nieuwe wiki:


 * 1) Ga naar Special:Export op de originele wiki en download een xml-bestand met de complete geschiedenis van alle benodigde sjablonen, dit gaat als volgt:
 * 2) * Vul de naam van het sjabloon in het grote tekstveld, bijvoorbeeld "Template:Welcome". Let goed op het gebruik van hoofdletters en speciale tekens. Het exporteren kan lukken met een niet helemaal goede naam maar het xml-bestand bevat dan niet de gegevens die het moet bevatten.
 * 3) * Selecteer het veld "".
 * 4) * Selecteer het veld "".
 * 5) * Klik op "".
 * 6) Ga naar Special:Import op de nieuwe wiki en upload het xml-bestand.

Als u op de nieuwe wiki niet mag importeren:


 * 1) Ga in de originele wiki naar het sjabloon wat u wilt kopiëren. Ga naar de pagina om het te bewerken en kopieer alle wikitext
 * 2) Op de nieuwe wiki, ga naar de pagina met dezelfde naam als het gekopieerde sjabloon. Kies aanmaken/bewerken plak de tekst. In de wijziging samenvatting van het sjabloon link naar de originele pagina voor de toeschrijving.
 * 3) Terug naar de originele wiki op het bewerkscherm, onder het wijzigveld, kijk naar de  lijst "Sjablonen op deze pagina gebruikt". Voer voor elk genoemd sjabloon deze instructies uit, als die sjablonen nog niet bekend zijn op de nieuwe wiki. Kijk ook of er in de overgezette sjablonen nog gebruikte sjablonen zijn die nog onbekend zijn op de nieuwe wiki. Dit gaat door totdat u geen op de nieuwe wiki onbekende sjablonen meer vindt in deze sjablonen.

Zo kopieert u alle nodige code, het zal genoeg zijn voor enkele sjablonen. Merk op dat alleen pagina-elementen verwerkt bij het opbouwen van de pagina worden geëxporteerd, dat betekent dus dat bijvoorbeeld documentatie subpagina's niet worden geëxporteerd. Indien het niet werkt, controleer dan of er rode links genoemd worden bij "Pagina's opgenomen in de huidige versie van deze pagina", onderaan het wijzigingsveld. Als die er zijn herhaal dan de eerder genoemde stappen voor deze pagina's en kopieer de code in de modules.

Naar het succesvol importeren van het sjabloon en alle gelinkte sjablonen van de andere wiki, kunt u het aanpassen als het nodig is voor uw eigen wiki. Dat zou kunnen zijn, een eigen logo, het snoeien van onnodige categorieën en het bekijken van rode links.

Extensies
Een extensie die vaak in sjablonen wordt gebruikt is ParserFunctions. Bezoek pagina en kijk of een van de genoemde functies wordt gebruikt in de sjablonen die u heeft gekopieerd. Als dat zo is, installeer dan de extensie als die nog niet is geïnstalleerd. U heeft voor het installeren de rechten van een systeembeheerder nodig op de server van uw MediaWiki installatie.

Er kan ook afhankelijkheid zijn in de sjablonen, vooral op Wikipedia, door Lua. Als er   in de code van het sjabloon zit, dam lijkt dat waarschijnlijk. Als het wordt gebruikt, installeer dan (als die er nog niet is) de extensie, hiervoor zijn weer de rechten van een sysbeheerder nodig. Bekijk die pagina voor meer instructies over het installeren en het gebruik.



CSS en JavaScript code
Naast MediaWiki code maken veel sjablonen ook veel gebruik van CSS en sommige vertrouwen op het werken van JavaScript. Als de overgezette sjablonen niet zoals verwacht werken, controleer dan deze punten. Om de benodigde CSS en JavaScript over te zetten zult u wel weer beheerdersrechten nodig hebben, want u wijzigt systeemberichten in de "MediaWiki:" namespace.


 * 1) Kijk naar het gebruik van CSS classes (teksten als   ) in de tekst van het sjabloon. Indien die classes in "MediaWiki:Common.css" of "MediaWiki:Monobook.css" staan op de originele wiki, kopieer die classes naar "MediaWiki:Common.css" in  de nieuwe wiki en controleer of het sjabloon nu goed werkt.
 * 2) als het gekopieerde sjabloon nog altijd niet op de gewenste manier werkt, controleer dan of er code in "MediaWiki:Common.js" of "MediaWiki:Monobook.js" is op de originele wiki. Als die er is, probeer dan die te kopiëren naar "MediaWiki:Common.js" op de nieuwe wiki. Normaal is het een goed idee om allen code te kopiëren uit code die u vertrouwd en die code eerst te bekijken om te zien welk deel relevant is. Let op het aanwezige commentaar dat mogelijk aanwijzingen geeft over de  functionaliteit van dat deel van de code.



Zie ook


Gebruik sjablonen in het algemeen

 * w:Help:Template – wat meer details dan hier
 * m:Help:Template – bevat een veel uitgebreider handleiding over hoe de sjabloonfunctie werkt
 * m:Help:Advanced templates beschrijft de nog meer geavanceerde technieken zoals dynamische sjabloon aanroepen en variabele parameter namen



Speciale constructies in sjablonen

 * – opvallende zaken die u in sommige sjablonen kan tegenkomen
 * – Nog meer opvallende zaken met functies als #if en #switch
 * – gids voor het gebruik van parser-functies in sjablonen



Overige informatie

 * – een voorbeeld met een speciaal gebruik van een sjabloon
 * – Gebruik van sjablonen als begintekst van een pagina
 * m:Help:Embed page, inbedden van pagina's van namespaces anders dan.
 * – Gebruik van sjablonen als begintekst van een pagina
 * m:Help:Embed page, inbedden van pagina's van namespaces anders dan.
 * m:Help:Embed page, inbedden van pagina's van namespaces anders dan.

<span id="External_links">

Externe links

 * Miraheze template repository - MediaWiki sjablonen bedoeld voor algemeen gebruik.