Help:Sjabloon: verschil tussen versies

Uit LinuxMintNL WiKi
Ga naar: navigatie, zoeken
(Aangevuld en aangepast)
(aangepast)
 
Regel 2: Regel 2:
  
 
== Wat is ==
 
== Wat is ==
Een sjabloon is een bijzondere wikitekst die wordt uitgevoerd als programma als de sjabloonnaam tussen dubbele kromme haken {{ }} wordt geplaatst.
+
Een sjabloon is een bijzondere wikitekst die als programma wordt uitgevoerd als de sjabloon-naam tussen dubbele kromme haken {{ }} wordt geplaatst.
  
Het bestaat in principe uit twee delen:
+
De sjabloon-naam bestaat uit twee delen: '''Sjabloon: Naam'''. (let op de dubbele punt)
*De sjabloon tekst
+
 
:Het deel waar de sjabloon code staat vermeld.
+
De sjabloon-inhoud bestaat gewoonlijk uit twee delen: sjabloon tekst of code - uitleg voor gebruik.
*De uitleg voor gebruik
 
:De gebruiksaanwijzing voor de plaatsing en de invulling van eventuele code.
 
  
 
== Waar ==
 
== Waar ==
Het wordt gebruikt op plaatsen waar regelmatig terugkerende teksten of code moet worden geplaatst.<br />
+
Het wordt gebruikt om regelmatig terugkerende taken uit te voeren.<br />
Zie bijvoorbeeld de welkomsttekst op de gebruikers overleg pagina.
+
Zie bijvoorbeeld de vensters op de Hoofdpagina die door sjablonen iedere maand wordt aangepast. De sjablonen zoeken de tekst of afbeelding die bij de maand passen. Hierdoor hoeft de Hoofdpagina niet iedere maand te worden herschreven.
  
Ook is het handig om met een sjabloon vergelijkingen te onderzoeken, verwijzingen te tonen of infoboxen te plaatsen.
+
Ook is het handig om met een sjabloon [[Help:Doorverwijzing|verwijzingen]] te tonen, [[Sjabloon:KopDun|infoboxen]] te plaatsen of [[Sjabloon:Bgn|vergelijkingen]] te onderzoeken.
  
 
== Hoe ==
 
== Hoe ==
 +
We houden sjablonen netjes met ''<nowiki>__NOEDITSECTION__</nowiki>'' doordat geen onnodige bewerkknopjes verschijnen.
 +
 +
We gebruiken ''code <nowiki><noinclude></nowiki>'' om de code van de rest te scheiden.
 +
Vanaf hier wordt niets meer door het sjabloon gebruikt, maar is wel zichtbaar op de sjabloon-pagina.
 +
 
Elke pagina kan als sjabloon dienen als het wordt geplaatst met <nowiki>{{:Paginanaam}}</nowiki>.
 
Elke pagina kan als sjabloon dienen als het wordt geplaatst met <nowiki>{{:Paginanaam}}</nowiki>.
Dit mag echter alleen met hoge uitzondering voor tekstdelen worden gebruikt.
+
Dit mag echter alleen met hoge uitzondering omdat wiki-code in deze vorm problemen kan veroorzaken.
Programma of wiki-code in deze vorm in het sjabloon kan problemen geven.
+
 
 +
===Naam===
 +
Een sjabloon-pagina wordt aangemaakt met het formaat ''Sjabloon:naam'' en bestaat uit twee delen.
 +
:Het soort bestand '''Sjabloon:'''Naam. (let op de dubbele punt)
 +
:De naam Sjabloon:'''Naam'''.  
  
Een sjabloonpagina wordt aangemaakt met het formaat ''Sjabloon:naam'' en bestaat uit twee delen.
+
===Inhoud===
*Als eerste naamdeel ''Sjabloon:''
+
De sjabloon-inhoud bestaat gewoonlijk uit twee delen:
*Als tweede naamdeel de ''naam'' van het sjabloon.
+
;Het eerste deel.
:Voorbeeld: ''Sjabloon:Standaard''
+
:De sjabloon code of tekst die moet worden uitgevoerd.
Plaats daarna de sjabloon tekst en/of wikicode in de artikelruimte.
 
  
Aan het eind van de laatste regel komt aansluitend. <nowiki><noinclude></nowiki><br />
+
:;Code afsluiten
Dit is om lege regels onder het geplaatste sjabloon te voorkomen en de paginaopmaak te vereenvoudigen.
+
:Aan het eind van de code, direct na het laatste karakter, komt ''<nowiki><noinclude></nowiki><br />''
 +
:Dit is om lege regels onder het geplaatste sjabloon te voorkomen en de paginaopmaak niet te verstoren.
  
Daarna volgt de uitleg en de categorisatie, afgesloten met <nowiki></noinclude></nowiki>.
+
;Uitleg voor gebruik
 +
:Na de codeafsluiting volgt de gebruiksaanwijzing voor plaatsing en invullen van eventuele extra code.
 +
:Gebruik hiervoor [[Sjabloon:Sjablooninfo|Sjabloon info]] zoals dat ook in [[:Sjabloon:Standaard]] wordt gebruikt.
  
Zie voor een voorbeeld [[Sjabloon:Standaard]] dat bij plaatsing met <nowiki>{{Standaard}}</nowiki> het volgende toont.
+
:;Sjabloon afsluiten
 +
:Als laatste volgt de categorisatie en wordt afgesloten met <nowiki></noinclude></nowiki>.
  
{{Standaard}}
+
== Voorbeeld ==
 +
Zie [[Sjabloon:Standaard]] dat door <nowiki>{{Standaard}}</nowiki> het volgende toont.
  
== Zie ook ==
+
<center>'''''Sjabloon code begin'''''</center>
*[[Sjabloon:Sjablooninfo|Sjabloon info]]
+
* Doel
 +
:Samenstellen van een standaard voor sjablonen
 +
* Invullen
 +
:Plaats de code tussen <nowiki>__NOEDITSECTION__ en <noinclude></nowiki>
 +
:Vul de sjablooninfo in.
 +
Zie voor meer uitleg [[Help:Sjabloon]].
 +
<center>'''''Sjabloon code einde'''''</center>
  
 
[[Categorie:Snelcursus]]
 
[[Categorie:Snelcursus]]

Huidige versie van 17 feb 2017 om 00:38

Sjablonen kunnen worden gebruikt om veel voorkomende teksten of handelingen te herhalen.

Wat is

Een sjabloon is een bijzondere wikitekst die als programma wordt uitgevoerd als de sjabloon-naam tussen dubbele kromme haken {{ }} wordt geplaatst.

De sjabloon-naam bestaat uit twee delen: Sjabloon: Naam. (let op de dubbele punt)

De sjabloon-inhoud bestaat gewoonlijk uit twee delen: sjabloon tekst of code - uitleg voor gebruik.

Waar

Het wordt gebruikt om regelmatig terugkerende taken uit te voeren.
Zie bijvoorbeeld de vensters op de Hoofdpagina die door sjablonen iedere maand wordt aangepast. De sjablonen zoeken de tekst of afbeelding die bij de maand passen. Hierdoor hoeft de Hoofdpagina niet iedere maand te worden herschreven.

Ook is het handig om met een sjabloon verwijzingen te tonen, infoboxen te plaatsen of vergelijkingen te onderzoeken.

Hoe

We houden sjablonen netjes met __NOEDITSECTION__ doordat geen onnodige bewerkknopjes verschijnen.

We gebruiken code <noinclude> om de code van de rest te scheiden. Vanaf hier wordt niets meer door het sjabloon gebruikt, maar is wel zichtbaar op de sjabloon-pagina.

Elke pagina kan als sjabloon dienen als het wordt geplaatst met {{:Paginanaam}}. Dit mag echter alleen met hoge uitzondering omdat wiki-code in deze vorm problemen kan veroorzaken.

Naam

Een sjabloon-pagina wordt aangemaakt met het formaat Sjabloon:naam en bestaat uit twee delen.

Het soort bestand Sjabloon:Naam. (let op de dubbele punt)
De naam Sjabloon:Naam.

Inhoud

De sjabloon-inhoud bestaat gewoonlijk uit twee delen:

Het eerste deel.
De sjabloon code of tekst die moet worden uitgevoerd.
Code afsluiten
Aan het eind van de code, direct na het laatste karakter, komt <noinclude>
Dit is om lege regels onder het geplaatste sjabloon te voorkomen en de paginaopmaak niet te verstoren.
Uitleg voor gebruik
Na de codeafsluiting volgt de gebruiksaanwijzing voor plaatsing en invullen van eventuele extra code.
Gebruik hiervoor Sjabloon info zoals dat ook in Sjabloon:Standaard wordt gebruikt.
Sjabloon afsluiten
Als laatste volgt de categorisatie en wordt afgesloten met </noinclude>.

Voorbeeld

Zie Sjabloon:Standaard dat door {{Standaard}} het volgende toont.

Sjabloon code begin
  • Doel
Samenstellen van een standaard voor sjablonen
  • Invullen
Plaats de code tussen __NOEDITSECTION__ en <noinclude>
Vul de sjablooninfo in.

Zie voor meer uitleg Help:Sjabloon.

Sjabloon code einde