Como usar Templates

Contributors Contributors Última atualização:
This is a machine-generated translation of the English article. It has not been reviewed by a human, and may contain errors. If you would like to revise this content, you can start here.

Templates são uma forma de reutilizar trechos de conteúdo em artigos da Base de Conhecimento. Em vez de escrever um conjunto de instruções várias vezes, você pode criá-lo e atualizá-lo em um só lugar e depois fazer referência a ele em outras páginas. As outras páginas permanecerão atualizadas automaticamente com as alterações no Template!

Localizers: when localizing templates, do not translate the name of the page - just use the original one! So, if the template is named Template:browsersettings, do not translate any of the elements in the name - just use Template:browsersettings in your locale. This is important to have the templates function properly.

O que são Templates

Um Template é apenas uma página wiki especial cujo nome começa com "Template:". Tem todas as características de uma página wiki: pode ser traduzida, tem uma história, entende marcação wiki.

Os templates estão listados em nesta página. Uma lista alfabética dos templates existentes pode ser encontrada aqui.

Como fazer um Template

  1. Crie um novo artigo da Base de Conhecimento. Experimente criar um novo artigo da Base de Conhecimento em nosso servidor de teste.
  2. Certifique-se que o nome comece com "Template:" - por exemplo, Template:aboutconfig.
  3. Defina a categoria para "Template".
  4. Continue a escrever o template da mesma forma que faria com qualquer outro artigo da Base de Conhecimento

Como inserir um Template em um Artigo

Para usar um template em uma página wiki, tudo que você tem a fazer é um "link" para o template.

Por exemplo:

[[Template:Some Template]] ou [[T:Some Template]]


Em vez de criar um link, o conteúdo de Template:Some Template será incluído na página atual. Qualquer marcação wiki no template será preservada.

Templates e listas numeradas

Para a maioria dos propósitos, usar uma lista numerada em um template funciona exatamente da mesma forma que em qualquer outro documento da Base de Conhecimento. Há uma exceção importante — se seu template for uma lista numerada que será usada como parte de uma lista numerada maior, a numeração irá quebrar.

Solução:
Não use "#" em nenhum dos passos e Adicione <li> </li> ao redor do segundo passo e dos subsequentes, assim:

This is the first step in your list
<li>This is the second step</li>
<li>This is the third step</li>

Então, ao adicionar o template a um artigo, adicione o "#" antes do template:

#[[T:List]]
#This is another step that's not part of the template

Ele será parecido com este:

  1. This is the first step in your list
  2. This is the second step
  3. This is the third step
  4. This is another step that's not part of the template

Outra parte importante - você não pode usar block level {for} nestes templates. Por exemplo:
Bad:
{for not fx10}
First step - Firefox 9 and lower
{/for}
{for fx10}
First step - Firefox 10 and higher
{/for}
<li>This is the second step</li>

Good:
{for not fx10}First step - Firefox 9 and lower{/for}{for fx10}
First step - Firefox 10 and higher{/for}
<li>This is the second step</li>

Usando argumentos com um Template

Templates suportam a passagem de argumentos, para permitir que você reutilize conteúdo que é quase o mesmo.

Digamos, por exemplo, que você tenha um aviso padrão informando aos usuários que um documento se aplica somente ao Firefox 4 e outra versão que se aplica somente ao Firefox 3.6. O texto desses avisos pode ser idêntico, exceto pela versão do Firefox: o momento perfeito para usar um template!

Template:OnlyVersionX:

{note}Este documento ou seção só se aplica ao '''Firefox {{{1}}}'''!{/note}


Então, em uma página wiki, você poderia usar isso:

[[Template:OnlyVersionX|4]]


E, em outra página, você pode usar:

[[Template:OnlyVersionX|3.6]]


Você pode usar vários argumentos ou o mesmo argumento duas vezes, também!

Template:XLikesY:

# {{{2}}} likes {{{1}}}.
# {{{3}}} likes {{{2}}}.
# Class! Nobody likes {{{2}}}!


Em seguida, use:

[[Template:XLikesY|Lisa|Milhouse|Janey]]


Isto resultaria em:

  1. Milhouse likes Lisa.
  2. Janey likes Milhouse.
  3. Class! Nobody likes Milhouse!


Acompanhar todos esses números pode se tornar confuso, então você também pode nomear os argumentos para um template:

Template:XPrecededY:

Primeiro vem {{{first}}}, em seguida {{{second}}}.


And using it:

[[Template:XPrecededY|first=love|second=marriage]]


Com argumentos nomeados, você não precisa se preocupar com a ordem quando você usa o template:

[[Template:XPrecededY|second=marriage|first=love]]


Ambos os exemplos de utilização de Template:XPrecededY terão o mesmo resultado.

Diretrizes da Base de Conhecimento

Para ver mais diretrizes sobre contribuição na Base de Conhecimento, clique aqui.

Essas pessoas ajudaram a escrever este artigo:

Illustration of hands

Torne-se um voluntário

Desenvolva e compartilhe sua especialidade com outras pessoas. Responda perguntas e aprimore nossa base de conhecimento.

Saiba mais