Help:Sjabloon

(Doorverwezen vanaf Help:Template)
Ga naar: navigatie, zoeken
Richtlijnen voor inhoud
Opmaken van inhoud wordt gedaan met Sjablonen. Er zijn 2 soorten, sjablonen voor een specifieke soort artikelen en sjablonen voor opmaak van zich herhalende inhoud in artikelen.

Gebruik

Sjablonen worden gebruikt om herhaaldelijk terugkerende boodschappen in te voegen in pagina's op een consistente manier, om standaardtekst toe te voegen, om navigatieboxen toe te voegen en om cross-language overdraagbaarheid van teksten te verschaffen.

De inhoud van een sjabloon kan in een pagina worden ingevoegd door het typen van {{naam van sjabloon}}.

Sjablonen dienen gebruikt te worden om

  • belangrijke meldingen of boodschappen weer te geven
  • een consistente look te bekomen doorheen de wiki
  • het bewerken te vergemakkelijken wanneer dezelfde tekst herhaald wordt in een groot aantal pagina's
  • een artikel te markeren wanneer er een onderhoudsoperatie wordt uitgevoerd

Sjablonen dienen niet gebruikt te worden om

  • lijsten te creĆ«ren met links naar onderlinge artikelen wanneer een categorie of een Zie ook lijst dezelfde functie kan uitoefenen.

Gestandaardiseerde sjablonen

Zie Standaard sjablonen voor een lijst van standaard sjabloon-berichten.

We hebben ook standaard sjabloonpagina's voor verschillende doeleinden:

Dit artikel is nog maar gedeeltelijk vertaald. Als u mee wilt helpen met vertalen lees dan Wiki vertalen naar het Nederlands.

Creating new templates

Waarschuwing: If possible, do not create new template apart from new navigation bar.

Please observe these rules when creating a new template which is absolutely required:

  • Template title must start with Template:.
  • Templates are case sensitive, except the first letter.
  • Template name must follow the naming conventions. In short, only the first letter is uppercase and CamelCase is not allowed.
  • Template can be moved to a new name. The redirect target will be included instead of the redirect page itself.
  • Template can be used within other templates.
  • Icon size should be 32px.
    • In rare case when template is larger, use then 48px or 64px.
    • If icon takes too much space in tables, then put style="width:32px" in cell before icon and size will be reduced to 32px.
  • Template width should be width:100% of page width. If it should be smaller then check text flow around the template.
  • Text position should be placed on the left. Text that is not aligned to start from the same position is harder to read as eyes have to locate begin, and if that happens on every line, it makes very unpleasant experience.

For other questions regarding templates, refer to Wikipedia Help:Template article. See also ParserFunctions to access to other advanced functioning help pages.

Template documentation

Every template must be documented in separate /doc subpage. For instance, the documentation of Template:Info is on Template:Info/doc subpage. Template documentation source should look like:

* '''Code:''' <code><nowiki>{{</nowiki>[[Template:Info|Info]]|Info text<nowiki>}}</nowiki></code>
* '''Description:''' Add important information.
* '''Where:''' Anywhere
* '''Related templates:''' [[Template:Warning|Warning]], [[Template:Forbidden|Forbidden]]
<noinclude>
[[Category:Template documentation]]
</noinclude>

The Code: tag explains what code the editor has to write to use the template, eventually with arguments. Code:, together with Description: and Where: are mandatory tags in template documentation, while Related templates: is optional and should be used only if it makes sense for given template. Do not forget to add the documentation into Categorie:sjabloondocumentatie using <noinclude> tags.

To display the template documentation on the template page, following code snippet has to be appended to the template:

<noinclude>
{{{{PAGENAME}}/doc}}
</noinclude>

There is one exception to the rule that every template has be documented using /doc subpage. These exceptions are boilerplate templates, which are not intended to be transcluded into other pages, but rather substituted when creating new page. Examples of such pages are Template:Article, Template:Userpage or Template:Portal.

Template categorization

Every template should be put into one or more subcategories of Category:Sjablonen. If you don't know to which category your new template belongs or if you think that you need new template category, you should ask on the wiki mailing list first.

Zie ook Niet-gecategoriseerde sjablonen.


External links