3 167
edições
Mudanças
m
Correção ortográfica.
{{Informativo aprovado|[[WikipédiaWikihelp:Esplanada/propostas/Oficializar artigos informativos (30mai2012)]]}}
[[Ajuda:Guia Prático/Predefinições|Predefinições]] são uma característica muito poderosa do [[MediaWiki]], mas podem ser confusas para novos usuários e até mesmo usuários experientes podem ter dificuldade em entender as mais complexas. Predefinições devem ser acompanhadas de [[documentação]] para melhor usabilidade.
* '''Usage examples''': specify the exact wikitext that should be used and the result that it produces. The wikitext can be enclosed in a {{nowrap|<code><nowiki><code>…</code></nowiki></code>}} container, to make it clear and <code>easy to copy, like this</code>. If the template can be used in several different ways, with or without optional parameters, for example, provide a range of examples. A good way to do so is to transclude the template itself into the documentation a few times (i.e., use live examples), with different parameters each time and list the parameters used in each case.
* '''Related templates''': if the template is one of a series of templates, include links to these – in particular, ensure that every template in the series is linked from each of the others, as this makes navigation easier. (A separate navigation template may be useful for this purpose, see: [[Template:Protection templates]]).
* '''[[WikipediaWikihelp:Categorization|Categories]]''' and '''[[WikipediaWikihelp:InterWikimedia links|InterWikimedia links]]''', where applicable. Like the documentation, these must be within a {{nowrap|<code><nowiki><noinclude>…</noinclude></nowiki></code>}} container. Many template categories are available, see: [[:Category:Wikipedia Wikihelp templates]] to browse through them.
Template documentation is often placed in a [[WikipediaWikihelp:Subpages|subpage]] of the template itself, which is then [[WikipediaWikihelp:Transclusion|transcluded]] at the end of the template page. This separates the often complex template code from the documentation, making the documentation easier to edit. It also allows templates to be [[WikipediaWikihelp:Protection policy|protected]] where necessary, while allowing anyone to edit the documentation. This method is sometimes referred to as the “template doc page pattern”.
Documentation of any sort on a template page should always be enclosed by a {{nowrap|<code><nowiki><noinclude>…</noinclude></nowiki></code>}} container, so that it does not show up when the template is used on another page. Text on the template page itself adds to the amount of text which must be processed when displaying the template, which is [[WikipediaWikihelp:Template limits|limited]] for performance reasons. Placing the documentation in a subpage avoids this (MediaWiki developers have <span class="plainlinks">[http://enwiki.wikipediairchelp.orgcom.br/wwiki/index.php?title=WikipediaWikihelp:Village_pump_(technical)&diff=prev&oldid=69888944 recommended]</span> it for this reason).
-->
== Ver também ==
*[[WikipediaWikihelp:Namespace predefinição]] - lista de predefinições organizadas (incompleta)
*[[:Categoria:!Predefinições]] - categorias com todas as predefinições
*[[Ajuda:Guia de edição/Como criar predefinições|Ajuda:Como criar predefinições]] - Ensina como criar uma predefinição.
[[Categoria:!Instruções de predefinições| ]]
[[Categoria:!Artigos informativos|Documentação da predefinição]]
[[Categoria:!Recursos da WikipédiaWikihelp]]
</noinclude>