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
bewerkenAanroepen
bewerkenDe 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
bewerkenHet 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
bewerkenKijk 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:
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
bewerkenEr zijn 2 belangrijke overzichten van sjablonen. We geven ze hieronder weer.
Overzichten met toelichting
bewerken- 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
bewerkenWanneer 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
bewerkenJe 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
bewerkenAlles 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
bewerkenParameters 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
bewerkenDe 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
bewerkenVerder 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
bewerkenKijk 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.
|
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.
|
Enkel {{{1}}} en {{{2}}} worden vervangen. De derde parameter ("TEST") wordt genegeerd . |
{{Test2|goed|nummer=100}} | Dit is een goed voorbeeld met meerdere parameters.
|
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.
|
Hier wordt alles getoond. |
{{Test2| |goed |
Dit is een goed voorbeeld met meerdere parameters.
|
Dit geeft hetzelfde resultaat, maar is overzichtelijker in het bewerkingsscherm en daardoor makkelijker in te vullen. |