Utilizar Modelos (Templates)

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

Os «Modelos» (Templates) são uma maneira de reutilizar partes do conteúdo nos artigos da «Base de Dados de Conhecimento». Em vez de escrever um conjunto de instruções várias vezes, pode criá-lo e atualizá-lo num local e consultá-lo noutras páginas. As outras páginas ficarão atualizadas automaticamente com as alterações no «Modelo»!

Tradutores: quando traduzirem modelos, não traduzam o nome da página - utilizem apenas o original! Assim, se o modelo for nomeado Template:browsersettings, não traduzam quaisquer dos elementos no nome - utilizem apenas Template:browsersettings no seu idioma. Isto é importante que os modelos funcionem corretamente.

O que são os «Modelos»

Um «Modelo» é apenas uma página wiki especial cujo nome começa com "Template:". Tem todas as funcionalidades de uma página wiki: pode ser localizado, tem um histórico e compreende a marcação wiki.

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

Como criar um «Modelo»

  1. Criar um novo artigo da KB. Experimente criando um novo artigo da KB no nosso servidor de testes.
  2. Certifique-se que o nome começa com "Template:" - por exemplo, Template:aboutconfig.
  3. Defina a "Categoria" para "Template".
  4. Continue a escrever o «Modelo» da mesma maneira que o faria com qualquer artigo da «Base de Conhecimentos».

Como incluir um «Modelo» num «Artigo»

Para utilizar um modelo numa página wiki, tudo o que tem de fazer é "associar" a um modelo.

Por exemplo:

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


Em vez de criar uma ligação, o conteúdo de Template:Some Template será incluído na página atual. Qualquer marcação wiki no modelo será renderizada.

Modelos e listas numeradas

Para a maioria dos propósitos, a utilização de uma lista numerada num modelo funciona exatamente da mesma maneira que em qualquer outro documento da «Base de Conhecimento». Há uma exceção importante — se o seu modelo for uma lista numerada que será utilizada como parte de uma lista numerada maior, a numeração será interrompida.

Solução:
Não utilize "#" em qualquer dos passos e adicione <li> </li> ao redor da segunda e das etapas subsequentes, desta forma:

Isto é o primeiro passo na sua lista
<li>Isto é o segundo passo</li>
<li>Isto é o terceiro passo</li>

Depois, quando adicionar o modelo a um artigo, adicione o "#" antes do modelo:

#[[T:List]]
#Este é outro passo que não é parte do modelo

Este parece-se com isto:

  1. Este é o primeiro passo na sua lista
  2. Este é o segundo passo
  3. Este é o terceiro passo
  4. Este é outro passo que não é parte do modelo

Outra parte importante - não pode utilizar o nível de bloqueio {for} nestes modelos. Por exemplo:
Mau:
{for not fx10}
Primeiro passo - Firefox 9 e inferior
{/for}
{for fx10}
Primeiro passo - Firefox 10 e superior
{/for}
<li>Este é o segundo passo</li>

Bom:
{for not fx10}Primeiro passo - Firefox 9 e inferior{/for}{for fx10}
Primeiro passo - Firefox 10 e superior{/for}
<li>Este é o segundo passo</li>

Utilização de argumentos com um «Modelo»

Os modelos suportam a passagem de argumentos, para lhe permitir reutilizar o conteúdo que é almost o mesmo.

Digamos, por exemplo, que tinha um aviso predefinido que informava os utilizadores que um documento se aplicava apenas ao Firefox 4 e outra versão que dizia que se aplicava apenas ao Firefox 3.6. O texto destes avisos pode ser idêntico, exceto na versão do Firefox: um momento perfeito para utilizar um modelo!

Template:OnlyVersionX:

{note}Este documento ou secção aplica-se apenas ao '''Firefox {{{1}}}'''!{/note}


Depois, numa página wiki, poderia fazer isto:

[[Template:OnlyVersionX|4]]


E noutra página, poderia fazer:

[[Template:OnlyVersionX|3.6]]


Pode utilizar múltiplos argumentos ou o mesmo argumento duas vezes, também!

Template:XLikesY:

# {{{2}}} gosta de {{{1}}}.
# {{{3}}} gosta de {{{2}}}.
# Turma! Ninguém gosta de {{{2}}}!


Depois para o utilizar:

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


Isto resultaria em:

  1. Milhouse gosta de Lisa.
  2. Janey gosta de Milhouse.
  3. Turma! Ninguém gosta de Milhouse!


Manter o controlo de todos estes números pode tornar-se confuso, por isso também pode nomear argumentos para um modelo:

Template:XPrecededY:

Primeiro vem {{{first}}}, depois vem {{{second}}}.


E utilizando-o:

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


Com os argumentos nomeados, não precisa de se preocupar com a ordem quando utiliza o modelo:

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


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

Diretrizes da Base de Conhecimento

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

Estas pessoas fantásticas ajudaram a escrever este artigo:

Illustration of hands

Participar

Cresça e partilhe a sua experiência com outras pessoas. Responda a perguntas e melhore a nossa base de conhecimentos.

Saber mais