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»!
Tabela de conteúdos
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.
Como criar um «Modelo»
- Criar um novo artigo da KB. Experimente criando um novo artigo da KB no nosso servidor de testes.
- Certifique-se que o nome começa com "Template:" - por exemplo, Template:aboutconfig.
- Defina a "Categoria" para "Template".
- 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:
- Este é o primeiro passo na sua lista
- Este é o segundo passo
- Este é o terceiro passo
- 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:
- Milhouse gosta de Lisa.
- Janey gosta de Milhouse.
- 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.