Help:Templates/pt

= Predefinições = Se existirem textos padronizados que deseja incluir em várias páginas, a funcionalidade de predefinições do MediaWiki deve ser usada.

Criação
Predefinições são páginas wiki normais, cujo conteúdo está desenhado para ser transcluído (isto é, integrado) para dentro de outras páginas. As páginas de predefinições devem ser colocadas no espaço nominal «   :». Pode criá-las como criaria qualquer outra página.

Uso
Se criar uma predefinição com o nome «   :Nome», pode transcluir o conteúdo desta página para dentro de outras páginas. Para fazê-lo, coloque na página de destino, na posição onde deseja integrar o conteúdo da predefinição, uma destas três formas:


 *  , integra o conteúdo da predefinição na página de destino sempre que a página de destino for apresentada ao utilizador. Se a predefinição for alterada entretanto, o conteúdo na página de destino também será alterado automaticamente.


 *  , é substituído pelo conteúdo da predefinição uma única vez, quando a página de destino é gravada. O conteúdo da predefinição torna-se parte integrante do conteúdo da página de destino e pode depois ser editado nesta, separadamente do original na página da predefinição. Alterações posteriores à predefinição, não serão reflectidas na página de destino.


 *  , integra o conteúdo da predefinição na página de destino sempre que a página de destino for apresentada ao utilizador, mas de forma não interpretada pelo analisador sintáctico, isto é, como se estivesse rodeada pelo elemento  &lt;nowiki&gt; .

Na realidade, colocar entre chavetas () o nome de qualquer página da wiki, faz com que essa página seja transcluída. Se não especificar o espaço nominal da página a transcluir, o MediaWiki assume que o espaço nominal é «   :». Se especificar o espaço nominal, a página será transcluída mesmo que não esteja em «   :». Portanto:


 *   transclui a página       :Nome  


 *   também transclui a página       :Nome  </tt>


 *  </tt> transclui a página  Nome </tt>
 *  </tt> é substituído pelo conteúdo da página       :Nome  </tt>
 *  </tt> é substituído pelo conteúdo da página  Nome </tt>


 *  </tt> transclui a página       :Nome  </tt>


 *  </tt> transclui a página       :Nome  </tt>

Se o espaço nominal especificado não existir, o MediaWiki assume que o título completo é uma predefinição:


 *  </tt> transclui a página       :Xpto:Nome  </tt>

Parâmetros
Para enriquecer o mecanismo de transclusão, o MediaWiki permite que sejam passados parâmetros a uma predefinição, quando está é transcluída.

Exemplo: Imagine que quer incluir uma pequena nota de agradecimento a outros utilizadores, na página de discussão de cada um deles, como a que aparece aqui à direita. O agradecimento conterá uma razão (neste caso, «pelo teu esforço») e a assinatura de quem agradece (neste caso, «Eu»). O objectivo é que o agradecimento possa ser feito por qualquer pessoa, para agradecer qualquer coisa.

Como o aspecto do agradecimento é comum e deve ser sempre o mesmo, pode criar uma predefinição para este fim, chamada    :Thankyou/pt, por exemplo. Embora a forma seja comum a todos, o conteúdo (a razão e a assinatura) será diferente para cada um, pelo que deve passá-los como parâmetros. Ignorando os elementos de formatação, como a caixa e a imagem, o conteúdo central da predefinição é este:

Um obrigadinho... . Abraços,

Repare no uso de  </tt> e   </tt>. Esta é a forma como, dentro das predefinições, se identifica os parâmetros que foram passados. Note que, dentro da predefinição, cada parâmetro é identificado por três chavetas ( </tt>).

Ao transcluir esta predefinição, os parâmetros são passados separando-os por barras verticais (<tt>|</tt>). O MediaWiki permite que se passem parâmetros de três formas.

Parâmetros anónimos
Para passar parâmetros de forma anónima, liste os valores dos parâmetros sequencialmente:

Neste caso, a predefinição <tt> </tt> recebe os parâmetros:
 * <tt> =pelo teu esforço </tt>
 * <tt> =Eu </tt>

Este código resulta no seguinte:

Parâmetros numerados
Para passar parâmetros por número, identifique o número de cada parâmetro ao passá-lo:

Desta vez, a predefinição <tt> </tt> recebe os parâmetros:
 * <tt> =pela tua amizade </tt>
 * <tt> =Eu </tt>

embora estes tenham sido fornecidos por ordem inversa. Este código resulta no seguinte:

Parâmetros com nome
A terceira forma de identificar os parâmetros é por um nome, em vez de usar números. Neste caso, o conteúdo da predefinição seria alterado para:

Um obrigadinho... . Abraços,

Dentro da predefinição, usa-se <tt> </tt> e <tt>  </tt>. Para passar estes parâmetros por nome, identifica-se o nome de cada parâmetro ao passá-lo:

Neste caso, a predefinição <tt> </tt> recebe os parâmetros:
 * <tt> =por seres quem és </tt>
 * <tt> =Eu </tt>.

Este código resulta no seguinte:

Valores por omissão
Se transcluir a predefinição sem passar qualquer parâmetro, desta forma:

obtém o seguinte:

Como não foram passados parâmetros, a predefinição apresenta os parâmetros em si mesmos, em vez de apresentar os respectivos valores. Nestes casos, pode ser útil definir valores por omissão para os parâmetros, isto é, valores que serão usados se o parâmetro não for passado. Por exemplo, se alterar o conteúdo da predefinição para:

Um obrigadinho... . Abraços,

a transclusão da predefinição sem passar quaisquer parâmetros resulta no seguinte:

Control template inclusion
You can control template inclusion by the use of  and tags.

Anything between  and   will be processed and displayed only when the template's page is being viewed directly.

Possible applications are:
 * Categorising templates
 * Interlanguage links to similar templates in other languages
 * Explanatory text about how to use the template

The converse is. Text between  and   will be processed and displayed only when the page is being included. The obvious application is to add all pages containing a given template to a category, without putting the template itself into that category.

Note: when you change the categories applied by a template, the categorization of the pages that use that template may not be updated until some time later: this is handled by the.

Organizing templates
For templates to be effective, users need to find them and be able to use them. A simple technique is to include an example on the template page. For example:

Usage
Allows to establish a link to a subject:

Then, an editor can simply copy and paste the example to create a similar page.

Copying from one wiki to another
Templates often require CSS or other templates, so users frequently have trouble copying templates from one wiki to another. The steps below should work for most templates:

If you have import rights on the new wiki

 * 1) Go to Special:Export on the original wiki. Enter the name of the template in the big text box, check "Include templates" and click Export. This will download a .xml file.
 * 2) Go to Special:Import on the new wiki and upload the .xml file.
 * 3) Look for CSS classes (like class="foobar") in the template text. If those classes appear in "MediaWiki:Common.css" or "MediaWiki:Monobook.css" on the original wiki, copy them to "MediaWiki:Common.css" on the new wiki.
 * 4) If the template uses ParserFunctions, you have to install the.

If you don't have import rights on the new wiki

 * 1) Copy the template text to the new wiki; link to the original page in the edit summary for attribution.
 * 2) Edit the template on the new wiki, and look through the list of templates at the bottom. The ones in red will also need to be copied from the original wiki to the new wiki. You may have to repeat this process multiple times before all dependency templates have been recognized and copied.
 * 3) Look for CSS classes (like class="foobar") in the template text. If those classes appear in "MediaWiki:Common.css" or "MediaWiki:Monobook.css" on the original wiki, copy them to "MediaWiki:Common.css" on the new wiki.
 * 4) If the template uses ParserFunctions, you must install the.