Sjabloon:Sjablooninfo: verschil tussen versies

Uit Wiki Sports Hall of Fame Suriname
Ga naar: navigatie, zoeken
(Normale lettergrootte. Beter leesbaar; caption, kader en achtergrond zorgen voor voldoende scheiding van sjablooninhoud.)
 
(100 tussenliggende versies door 34 gebruikers niet weergegeven)
Regel 1: Regel 1:
 
__NOEDITSECTION__
 
__NOEDITSECTION__
 
+
<div class="sjabdocnoot" style="color:grey; text-align:center; margin-top:1em;"><small>'''De sjabloonbeschrijving hieronder wordt niet afgebeeld wanneer het sjabloon wordt geplaatst.'''</small></div>
<div style="clear:both; color:grey; text-align:center;">'''De sjabloonbeschrijving hieronder wordt niet afgebeeld wanneer het sjabloon wordt geplaatst.'''</div>
+
<div class="toccolours template-documentation" style="background: #FFFFEE; border: 1px solid #FFDAB9;font-size:100%;">
<div class="toccolours" style="background: #FFFFEE; border: 1px solid #FFDAB9;">
+
{{#ifeq:{{NAMESPACE}}|Module|{{#ifexist:{{FULLPAGENAME}}/doc|{{{!}} align="right"
 +
{{!}} [[/doc|bekijk documentatie]]
 +
{{!}}} }}}}
 
{{{1}}}
 
{{{1}}}
</div>
+
</div><noinclude>{{Sjablooninfo|1=
  
<noinclude>
+
== Doel ==
{{sjablooninfo|1=
+
;Doel
+
 
Dit sjabloon kan worden gebruikt voor het toevoegen van informatie over het doel en gebruik van een sjabloon op Wikipedia. Tevens dient het ervoor om een scheiding aan te brengen tussen een sjabloon en de informatie over het gebruik die niet wordt meegenomen als een sjabloon wordt geplaatst.  
 
Dit sjabloon kan worden gebruikt voor het toevoegen van informatie over het doel en gebruik van een sjabloon op Wikipedia. Tevens dient het ervoor om een scheiding aan te brengen tussen een sjabloon en de informatie over het gebruik die niet wordt meegenomen als een sjabloon wordt geplaatst.  
  
;Gebruik
+
== Gebruik ==
Het sjabloon kan worden gebruikt met één parameter en dient tussen &lt;noinclude&gt;&lt;/noinclude&gt; gezet te worden.
+
Het sjabloon kan worden gebruikt met één parameter en dient tussen &lt;noinclude&gt; en &lt;/noinclude&gt; gezet te worden. De &lt;noinclude&gt; dient direct achter het laatste teken te komen en niet op een eigen regel omdat dat meestal opmaakproblemen geeft. Op de plaats van de puntjes dient de sjablooninformatie ingevoegd te worden:
<pre><nowiki>&lt;noinclude&gt;
+
<pre>&lt;noinclude&gt;{{Sjablooninfo|1=
{{</nowiki>sjablooninfo|1=
+
== Doel ==
Uitleg doel
+
...
en gebruik
+
van het sjabloon
+
<nowiki>}}
+
&lt;/noinclude&gt;</nowiki></pre>
+
  
Voorgesteld wordt om in de sjablooninformatie de volgende onderdelen altijd te gebruiken:
+
== Gebruik ==
*Doel
+
...
*Gebruik
+
En als het van toepassing is ook:
+
*Standaardwaarden
+
*Gerelateerde sjablonen
+
Voor overzichtelijkheid kunnen de kopjes het beste worden voorafgegaan door een puntkomma (;).
+
 
}}
 
}}
 +
&lt;/noinclude&gt;</pre>
  
[[categorie:Sjablonen opmaak|Sjablooninfo]]
+
Standaard gebruiken we daar altijd de volgende onderdelen:
[[categorie:Sjablonen over Wikipedia|Sjablooninfo]]
+
* ''Doel''
 +
* ''Gebruik''
 +
En eventueel:
 +
* ''Voorbeeld''
  
[[fr:Modèle:Info modèle]]
+
In de sectie ''Gebruik'' wordt er een leeg parameteroverzicht getoond die gebruikers eenvoudig kunnen kopiëren en plakken in het artikel om het aldaar in te vullen.
 +
 
 +
=== Andere kopjes ===
 +
Naast deze parameters komen in de sjabloonuitleg ook andere kopjes voor waar die zinvol zijn, waaronder bijvoorbeeld:
 +
* Kopjes met specifieke uitleg over bepaalde parameters van het sjabloon
 +
* ''Aanbeveling'' - hoe een sjabloon gebruikt dient te worden
 +
* ''Categorieën'' - welke categorieën worden er wanneer ingevoegd
 +
* ''Parameteroverzicht'' - geeft een overzicht van de parameters met uitleg, omschrijving en meer
 +
* ''TemplateData'' - onder dit kopje wordt code toegevoegd om de sjabloonmodule ([[Wikipedia:Visuele tekstverwerker#TemplateData|TemplateData]]) van de [[Wikipedia:Visuele tekstverwerker|visuele tekstverwerker]] te laten werken
 +
* ''Gebruikte afbeeldingen'' - toont met behulp van [[Sjabloon:Ontlinkte afbeelding]] de in het sjabloon gebruikte afbeeldingen die linken naar iets anders dan de bestandspagina
 +
* ''Gebruikte sjablonen'' - overzicht van hulpsjablonen die in de broncode van het sjabloon ingevoegd zijn
 +
* ''Zie ook'' - geeft relevante links en verwante sjablonen), ''Referenties'' (toont de referenties die een sjabloon soms mede invoegt in een artikel
 +
 
 +
=== Tabel ===
 +
Op zich gebruiken we meestal eerder een opsomming, maar indien er binnen dit sjabloon een tabel ingevoegd moet worden dienen alle [[Pipe (teken)|pipes]] van de tabel vervangen te worden door {{tl|!}}, omdat anders deze pipes gezien worden als het begin van een nieuwe parameter.
 +
 
 +
== Vergelijking met Sjabloon:Sjabdoc ==
 +
'''Sjabloon:Sjablooninfo''' heeft de voorkeur bij gebruik omdat bij het wijzigen van het sjabloon meteen de documentatie aangepast kan worden, maar heeft in sommige gevallen een alternatief: [[Sjabloon:Sjabdoc]]. Dit sjabloon werkt met aparte /doc pagina's, zie [[Sjabloon:Sjabdoc#Voordeel|voordeel]].
 +
Stijl van dat sjabloon:
 +
{{sjabdoc}}
 +
 
 +
}}
 +
<!--
 +
[[Categorie:Wikipedia:Sjablonen sjabloondocumentatie| ]]
 +
[[Categorie:Wikipedia:Sjablonen opmaak|Sjablooninfo]] -->
 
</noinclude>
 
</noinclude>

Huidige versie van 6 jul 2016 om 10:19

De sjabloonbeschrijving hieronder wordt niet afgebeeld wanneer het sjabloon wordt geplaatst.

{{{1}}}

De sjabloonbeschrijving hieronder wordt niet afgebeeld wanneer het sjabloon wordt geplaatst.

Doel

Dit sjabloon kan worden gebruikt voor het toevoegen van informatie over het doel en gebruik van een sjabloon op Wikipedia. Tevens dient het ervoor om een scheiding aan te brengen tussen een sjabloon en de informatie over het gebruik die niet wordt meegenomen als een sjabloon wordt geplaatst.

Gebruik

Het sjabloon kan worden gebruikt met één parameter en dient tussen <noinclude> en </noinclude> gezet te worden. De <noinclude> dient direct achter het laatste teken te komen en niet op een eigen regel omdat dat meestal opmaakproblemen geeft. Op de plaats van de puntjes dient de sjablooninformatie ingevoegd te worden:

<noinclude>{{Sjablooninfo|1=
== Doel ==
...

== Gebruik ==
...
}}
</noinclude>

Standaard gebruiken we daar altijd de volgende onderdelen:

  • Doel
  • Gebruik

En eventueel:

  • Voorbeeld

In de sectie Gebruik wordt er een leeg parameteroverzicht getoond die gebruikers eenvoudig kunnen kopiëren en plakken in het artikel om het aldaar in te vullen.

Andere kopjes

Naast deze parameters komen in de sjabloonuitleg ook andere kopjes voor waar die zinvol zijn, waaronder bijvoorbeeld:

  • Kopjes met specifieke uitleg over bepaalde parameters van het sjabloon
  • Aanbeveling - hoe een sjabloon gebruikt dient te worden
  • Categorieën - welke categorieën worden er wanneer ingevoegd
  • Parameteroverzicht - geeft een overzicht van de parameters met uitleg, omschrijving en meer
  • TemplateData - onder dit kopje wordt code toegevoegd om de sjabloonmodule (TemplateData) van de visuele tekstverwerker te laten werken
  • Gebruikte afbeeldingen - toont met behulp van Sjabloon:Ontlinkte afbeelding de in het sjabloon gebruikte afbeeldingen die linken naar iets anders dan de bestandspagina
  • Gebruikte sjablonen - overzicht van hulpsjablonen die in de broncode van het sjabloon ingevoegd zijn
  • Zie ook - geeft relevante links en verwante sjablonen), Referenties (toont de referenties die een sjabloon soms mede invoegt in een artikel

Tabel

Op zich gebruiken we meestal eerder een opsomming, maar indien er binnen dit sjabloon een tabel ingevoegd moet worden dienen alle pipes van de tabel vervangen te worden door Sjabloon:Tl, omdat anders deze pipes gezien worden als het begin van een nieuwe parameter.

Vergelijking met Sjabloon:Sjabdoc

Sjabloon:Sjablooninfo heeft de voorkeur bij gebruik omdat bij het wijzigen van het sjabloon meteen de documentatie aangepast kan worden, maar heeft in sommige gevallen een alternatief: Sjabloon:Sjabdoc. Dit sjabloon werkt met aparte /doc pagina's, zie voordeel. Stijl van dat sjabloon: Sjabloon:Sjabdoc