Help:Gebruik van sjablonen

Sjablonen stellen je in staat om met een eenvoudige aanroep teksten en/of wiki-opmaak en/of html-opmaak in de tekst op te nemen. Een sjabloon wordt ingevoegd door de naam van het sjabloon tussen twee paar tegenovergestelde accolades. Je kunt eventueel ook parameters meegeven, zodat je bijvoorbeeld de kleur of de tekst kunt aanpassen.

Een voorbeeld: het menu dat je hier rechts in beeld ziet, is aangeroepen met een heel kort stukje tekst:

{{Helpmenu}}

Het stelt iedereen dus in staat om iets ingewikkelds, dat vaker wordt gebruikt, met een eenvoudige aanroep toe te passen.

Sjablonen toepassen

Aanroepen

De sjablonen kunnen op verschillende manieren worden aangeroepen:

Met {{blabla}} wordt de inhoud van de Sjabloon-pagina [[Sjabloon:blabla]] in een pagina opgenomen. De pagina wordt dus zo opgebouwd dat dat wat er op [[Sjabloon:blabla]] staat in plaats komt te staan van {{blabla}}.
Met {{msgnw:blabla}} wordt de tekst die je te zien krijgt als je in het bewerkscherm van het sjabloon zit weergegeven.
Met {{subst:blabla}} wordt de tekst van de sjabloon ook daadwerkelijk op de pagina geplaatst alsof je het had ingetypt; de verwijzing verdwijnt dan.
Het is een afspraak om alleen de pagina's in de naamruimte Sjabloon toe te passen als sjabloon op inhoudelijke pagina's. Maar feitelijk kan iedere pagina als sjabloon gebruikt worden. Voor een pagina in de sjabloon-naamruimte gebruik je gewoon de naam van het sjabloon {{Sjabloonnaam}} Voor een pagina in de hoofdnaamruimte moet de naam van de pagina voorafgegaan worden door een dubbele punt {{:Sjabloonnaam}}. Voor pagina's in een andere naamruimte dan de hoofdnaamruimte of sjabloon-naamruimte moet het naamruimtevoorvoegsel mede worden vermeld. Voor bijvoorbeeld iets als je persoonlijke handtekening is het wel gebruikelijk om dan een sjabloon in je persoonlijke naamruimte te maken en die te gebruiken waardoor je iets krijgt als: {{Gebruiker:Jan/Handtekening}}.

Parameters

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. Je roept in het tekstvenster een sjabloon aan met bijvoorbeeld: {{Sjabloonnaam|parameter1=dingetje}}. Het stukje tekst dingetje wordt dan dus als parameter gebruikt om de sjabloon Sjabloonnaam op te bouwen.

Wanneer overigens de parameternamen 1, 2, 3 enz. zijn gebruikt, dan kun je bij de aanroep volstaan met {{Sjabloonnaam|dingetje1|dingetje2|dingetje3}}, waarbij dingetje1 staat voor parameter 1 enz.

Eenvoudig voorbeeld

Kijk bijvoorbeeld eens naar Sjabloon:Navigatie. Deze sjabloon stelt je in staat een bladerfunctie tussen verschillende hoofdstukken van een boek te maken. Je zou hem bijvoorbeeld kunnen toepassen in het hoofdstuk Verwijswoorden in het boek Nederlands met als hoofdstukken Zij of zei, Verwijswoorden en Jou of jouw

Je schrijft dan het volgende in het tekstvenster:

 {{Sjabloon:Navigatie
 |Boek    =Nederlands
 |vorige  =Zij of zei
 |huidige =Verwijswoorden
 |volgende=Jou of jouw}}

Dan krijg je het volgende te zien als je de pagina opslaat:

← Zij of zei

Gebruik van sjablonen

Jou of jouw →

Sjabloon:Navigatie is dus gemaakt met 4 parameters: Boek, vorige, huidige, volgende. Let overigens op hoofdlettergebruik bij de parameternamen, anders gaat het mis.

Overzichten van sjablonen

Er zijn 2 belangrijke overzichten van sjablonen. We geven ze hieronder weer.

Overzichten met toelichting

Wikibooks:Gewone sjablonen en navigatietabellen, voor meldingen als "Dit is een doorverwijspagina" en de onderdelen van de hoofdpagina en voor elementen die op verschillende pagina's gebruikt kunnen worden, zoals een inhoudsopgave van een boek.
Wikibooks:Zakelijke sjablonen, voor de sjablonen die bedoeld zijn voor gebruikersboodschappen.
Wikibooks:Sjablonen voor het aangeven van de licentiestatus van media, sjablonen die de licentiestatus van media aangeven.
Alle sjablonen alfabetisch

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

Overzichten op basis van categorie

Wanneer een sjabloon wordt gemaakt, dan hoort (liefst onder aan de pagina) een categorie te worden meegegeven met de code [[Category:Sjablonen|{{PAGENAME}}]]. Helaas gebeurt dat niet altijd, maar dan komt een sjabloon niet in dit overzicht terecht. Dit overzicht vind je op Categorie:Sjablonen.

Sjablonen aanmaken

Je maakt een sjabloon aan door op een willekeurige pagina een verwijzing naar de sjabloonpagina die je wil gaan gebruiken aan te maken. Om het netjes te houden kun je het beste een pagina maken met de naam: [[Sjabloon:Sjabloonnaam]], waarbij je voor "Sjabloonnaam" de door jou gewenste naam invult. Je slaat de pagina op en klikt op de ontstane link zodat je de gelegenheid krijgt een nieuwe pagina aan te maken. In dit geval een sjabloonpagina.

Sjabloontekst

Alles wat je op die pagina schrijft zal bij een aanroep van de sjabloon gebruikt worden in de plaats van je aanroepcode (bijv. {{Sjabloonnaam}}). Dit kan ook een ingewikkeld stuk HTML-code zijn.

Parameters

Parameters voeg je in met driedubbele accolades. Bijv. {{{parameter}}}. Bij de aanroep van bijv. {{Sjabloonnaam|parameter1=dingetje}} zal in plaats van {{{parameter1}}} de tekst dingetje worden gebruikt.

Wil je een parameter een default waarde meegeven, gebruik dan bijv. {{{parameter|default}}}. Schrijf je bijv. {{{parameter|}}}, dan is de default waarde dus "leeg".

Toelichting

De meeste sjablonen kennen ook een stukje toelichtende tekst. Alles wat tussen <noinclude> en </noinclude> staat, wordt niet gebruikt als sjabloontekst en komt zodoende niet terecht op de pagina's waar het sjabloon is ingevoegd.

Categorie

Verder is het belangrijk om onder aan de pagina te vermelden dat het hier om een pagina van de categorie sjabloon gaat. Je schrijft daar: <noinclude>[[Category:Sjablonen|{{PAGENAME}}]]</noinclude>. Dat zorgt ervoor dat je sjabloon onder de categorie Sjablonen valt met als indexeringsnaam de paginanaam. Zo is je sjabloon als zodanig terug te vinden. Let op: Het gebruik van noinclude-tags is hier nodig, omdat anders alle pagina's waar het sjabloon wordt toegepast in de gebruikte categorie terecht komen!

Zoals je ziet is {{PAGENAME}} een sjabloon dat zoals de naam zegt de paginanaam plaatst.

Je kunt ook naar een subcategorie van Sjablonen verwijzen (zie Categorie:Sjablonen). Dat vergroot de vindbaarheid misschien nog meer.

Complexe voorbeelden

Kijk vooral naar andere sjablonen om te zien hoe ze zijn gemaakt. Zoek er een uit op Categorie:Sjablonen en ga naar het tabblad "bewerken", dan zie je hoe ze in elkaar zitten. Sla uiteraard niets op zodat je niets wijzigt.
Als je er niet uit komt is er in de Lerarenkamer altijd wel iemand te vinden die je kan helpen.

Hieronder staat nog een overzicht met voorbeelden van alle eigenschappen van sjablonen.

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|}}})

Syntax van de aanroep	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 .
{{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.
{{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, maar is overzichtelijker in het bewerkingsscherm en daardoor makkelijker in te vullen.