Help:Gebruik van sjablonen: verschil tussen versies

Verwijderde inhoud Toegevoegde inhoud
Koos Jol (overleg | bijdragen)
k →‎Sjablonen aanmaken: meer kleine aanpassingen
Koos Jol (overleg | bijdragen)
+ extra voorbeeld van Help:Sjablonen
Regel 8:
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 <nowiki>{{blabla}}</nowiki> wordt de inhoud van de Sjabloon-pagina <nowiki>[[Sjabloon:blabla]]</nowiki> in een pagina opgenomen. De pagina wordt dus zo opgebouwd dat dat wat er op <nowiki>[[Sjabloon:blabla]]</nowiki> staat in plaats komt te staan van <nowiki>{{blabla}}</nowiki>.
Regel 16:
* Het is een afspraak om alleen de pagina's in de naamruimte ''Sjabloon'' toe te passen als sjabloon. Maar feitelijk kan ''iedere'' pagina als sjabloon gebruikt worden. Voor een pagina in de sjabloon-naamruimte gebruik je gewoon de naam van het sjabloon <nowiki>{{Sjabloonnaam}}</nowiki> Voor een pagina in de hoofdnaamruimte moet de naam van de pagina voorafgegaan worden door een dubbele punt <nowiki>{{:Sjabloonnaam}}</nowiki>. Voor pagina's in een andere naamruimte dan de hoofdnaamruimte of sjabloon-naamruimte moet het naamruimtevoorvoegsel mede worden vermeld.
 
== 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: <nowiki>{{Sjabloonnaam|parameter1=dingetje}}</nowiki>. 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 <nowiki>{{Sjabloonnaam|dingetje1|dingetje2|dingetje3}}</nowiki>, waarbij ''dingetje1'' staat voor parameter ''1'' enz.
 
====Eenvoudig voorbeeld====
== Voorbeelden ==
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''
 
Regel 44:
[[:Sjabloon:Navigatie]] is dus gemaakt met 4 parameters: ''Boek'', ''vorige'', ''huidige'', ''volgende''. Let overigens op hoofdlettergebruik bij de parameternamen, anders gaat het mis.
 
====Complex voorbeeld====
= Overzichten van sjablonen =
{| {{prettytable}}
!We nemen [[Sjabloon:Test2]] met als inhoud:
|-
|{{msgnw:Test2}}
|}
{| {{prettytable}}
! Syntax
! width=35% | Resultaat
! Uitleg
|-
| <nowiki>{{Test2}}</nowiki>
| {{Test2}}
| Omdat er geen parameters zijn opgegeven krijgen we enkel tekst op de plaatsen waar dit op voorhand is ingesteld.
|-
| <nowiki>{{Test2|goed|verschillende|TEST}}</nowiki>
| {{Test2|goed|verschillende|TEST}}
| Enkel <nowiki>{{{1}}}</nowiki> en <nowiki>{{{2}}}</nowiki> worden vervangen. De derde parameter ("TEST") wordt genegeerd .
|-
| <nowiki>{{Test2|goed|nummer=100}}</nowiki>
| {{Test2|goed|nummer=100}}
| Als er andere parameters worden gekozen dan <nowiki>{{{1}}}</nowiki> en volgend dan moet men de parameter (hier "nummer=") zelf toewijzen.
|-
| <nowiki>{{Test2|goed|meerdere|nummer=240|nummer2=2000}}</nowiki>
| {{Test2|goed|meerdere|nummer=240|nummer2=2000}}
| Hier wordt alles getoond.
|-
| <nowiki>{{Test2|</nowiki> </br>
<nowiki>|goed</nowiki> </br>
<nowiki>|meerdere</nowiki> </br>
<nowiki>|nummer=240</nowiki> </br>
<nowiki>|nummer2=2000</nowiki> </br>
<nowiki>}}</nowiki>
| {{Test2|goed|meerdere|nummer=240|nummer2=2000}}
| Dit geeft hetzelfde resultaat, maar is overzichtelijker in het bewerkingsscherm en daardoor makkelijker in te vullen.
|}
 
= =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.
Regel 54 ⟶ 91:
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 <nowiki>[[Category:Sjablonen|{{PAGENAME}}]]</nowiki>. 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: <nowiki>[[Sjabloon:Sjabloonnaam]]</nowiki>, 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. <nowiki>{{Sjabloonnaam}}</nowiki>). Dit kan ook een ingewikkeld stuk HTML-code zijn.
 
== =Parameters ===
Parameters voeg je in met driedubbele accolades. Bijv. <nowiki>{{{parameter}}}</nowiki>. Bij de aanroep van bijv. <nowiki>{{Sjabloonnaam|parameter1=dingetje}}</nowiki>zal in plaats van <nowiki>{{{parameter1}}}</nowiki> de tekst ''dingetje'' worden gebruikt.
 
== =Toelichting ===
De meeste sjablonen kennen ook een stukje toelichtende tekst. Alles wat tussen <tt>&lt;noinclude&gt;</tt> en <tt>&lt;/noinclude&gt;</tt> 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: <nowiki><noinclude>[[Category:Sjablonen|{{PAGENAME}}]]</noinclude></nowiki>. 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 ander alle pagina's waar het sjabloon wordt toegepast in de gebruikte categorie terecht komen!
 
Regel 76 ⟶ 113:
Je kunt ook naar een subcategorie van ''Sjablonen'' verwijzen (zie [[:Categorie:Sjablonen]]). Dat vergroot de vindbaarheid misschien nog meer.
 
== =Voorbeelden ===
Kijk vooral naar andere sjablonen om te zien hoe ze zijn gemaakt. Zoek er een uit op [[:Categorie:Sjablonen]] en ga er een bewerken, dan zie je hoe ze in elkaar zitten. Sla uiteraard niets op als je niets hebt bewerkt.<br />
Als je er niet uit komt is er in de [[Wikibooks:Lerarenkamer|Lerarenkamer]] altijd wel iemand te vinden die je kan helpen.
Informatie afkomstig van https://nl.wikibooks.org Wikibooks NL.
Wikibooks NL is onderdeel van de wikimediafoundation.