Sjabloon:Sjablooninfo: verschil tussen versies
(Versie 38981147 van Stratoprutser (overleg) ongedaan gemaakt. feitelijk onjuist, stamt uit 2006, was in 2008 al verouderd, beschrijft huidige situatie) |
(+toevoeging gedeelte met andere vaak-gebruiktekopjes, waaronder TemplateData en meer) |
||
| Regel 9: | Regel 9: | ||
== Doel == | == 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 == | == Gebruik == | ||
| − | + | Het sjabloon kan worden gebruikt met één parameter en dient tussen <noinclude></noinclude> gezet te worden. | |
<pre><noinclude>{{Sjablooninfo|1= | <pre><noinclude>{{Sjablooninfo|1= | ||
Uitleg doel | Uitleg doel | ||
en gebruik | en gebruik | ||
| − | van | + | van het sjabloon |
}} | }} | ||
</noinclude></pre> | </noinclude></pre> | ||
| Regel 26: | Regel 26: | ||
* Voorbeeld | * 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. | ||
| + | |||
| + | 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 [[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 het sjabloon {{tl|!}}, omdat anders deze pipes gezien worden als het begin van een nieuwe parameter. | 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 het sjabloon {{tl|!}}, omdat anders deze pipes gezien worden als het begin van een nieuwe parameter. | ||
== Vergelijking met Sjabloon:Sjabdoc == | == Vergelijking met Sjabloon:Sjabdoc == | ||
| − | '''Sjabloon:Sjablooninfo''' heeft de voorkeur bij gebruik, maar heeft in sommige gevallen een alternatief: [[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: | Stijl van dat sjabloon: | ||
{{sjabdoc}} | {{sjabdoc}} | ||
Versie van 17 sep 2013 om 06:53
{{{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.
Gebruik
Het sjabloon kan worden gebruikt met één parameter en dient tussen <noinclude></noinclude> gezet te worden.
<noinclude>{{Sjablooninfo|1=
Uitleg doel
en gebruik
van het sjabloon
}}
</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.
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 het sjabloon 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
