Fergelyk refyzjes
Como usar Templates
Refyzje 121210:
Refyzje 121210 troch user917725 op
Refyzje 308817:
Refyzje 308817 troch SumoBot op
Kaaiwurden:
Gearfetting sykresultaten:
Como usar Templates
Como usar Templates
Ynhâld:
Os Templates são uma forma de reutilização de partes do conteúdo de artigos da base de conhecimento. Em vez de escrever um conjunto de instruções várias vezes, você pode criar e atualizá-lo em um só lugar, e, em seguida, se referem a ele em outras páginas. As outras páginas receberao automaticamente as atualizações!
{warning}'''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.{/warning}
__TOC__
=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.
{note}A lista de Templates criados pode ser vista [/pt-BR/kb/category/60 '''aqui'''].{/note}
=Como fazer um Template=
#[/pt-BR/kb/new Crie um novo artigo da Base de Conhecimento]. Experimente [https://support.allizom.org/pt-BR/kb/new criar um novo artigo da Base de Conhecimento em nosso servidor de teste].
#Certifique-se que o nome começe com "Template:" - por examplo, [/en-US/kb/Template:aboutconfig Template:aboutconfig].
#Defina a categoria para "Template".
#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 examplo:
<code><nowiki>[[Template:Algum Template]]</nowiki></code>
or
<code><nowiki>[[T:Algum Template]]</nowiki></code>
Em vez de criar um link, o conteúdo de '''Template:Algum Template''' será incluído na página atual. Qualquer marcação wiki no template será presevada.
=Templates e listas numeradas=
Para a maioria dos propósitos, usando lista numerada em um modelo funciona exatamente da mesma maneira como acontece em qualquer outro documento da Base de Conhecimento. Há uma exceção importante — '''se o seu modelo é uma lista numerada que será usada como parte de uma lista maior numeração, a numeração vai quebrar.'''
'''Solução:'''<br>
'''Não''' use "#" em qualquer um dos passos e '''Do''' add <nowiki><li></nowiki> <nowiki></li></nowiki> em torno dos segundo e subsequentes passos, como esta:
<code>Este é o primeiro passo para a sua lista<br>
<nowiki><li></nowiki>Esta é a segunda etapa<nowiki></li></nowiki><br>
<nowiki><li></nowiki>Esta é a terceira etapa<nowiki></li></nowiki><br></code>
Então, quando a adição do modelo para um artigo, adicione o "#" antes do template:
<code><nowiki>#</nowiki><nowiki>[[</nowiki>T:List]]<br>
<nowiki>#</nowiki>Este é mais um passo que não faz parte do template</code>
Ele será parecido com este:
#Este é o primeiro passo para a sua lista
#Esta é a segunda etapa
#Esta é a terceira etapa
#Este é mais um passo que não faz parte do template
Outra peça importante - você não pode usar [[How to use For#w_inline-and-block-level-contexts|block level <nowiki>{</nowiki>for}]] nestes templates. por examplo:<br>
'''Ruim:'''<br>
<code><nowiki>{</nowiki>for not fx10}<br>
Primeiro passo - Firefox 9 e menor<br>
<nowiki>{</nowiki>/for}<br>
<nowiki>{</nowiki>for fx10}<br>
Primeiro passo - Firefox 10 e maior<br>
<nowiki>{</nowiki>/for}<br>
<nowiki><li></nowiki>Esta é a segunda etapa<nowiki></li></nowiki></code>
'''Bom:'''<br>
<code><nowiki>{</nowiki>for not fx10}Primeiro passo - Firefox 9 e menor<nowiki>{</nowiki>/for}<nowiki>{</nowiki>for fx10}<br>
Primeiro passo - Firefox 10 e maior<nowiki>{</nowiki>/for}<br>
<nowiki><li></nowiki>Esta é a segunda etapa<nowiki></li></nowiki></code>
= Usando argumentos com um Template =
Templates suportam argumentos, para que você reutilize o conteúdo que é ''almost'' the same.
Digamos, por exemplo, você tem um aviso padrão em um documento que se aplicar apenas ao Firefox 4, e outra versão desse documento que só se aplica ao Firefox 3.6. O texto dessas notificações podem ser idênticos, exceto para o versão Firefox: um momento perfeito para usar um template!
'''Template:OnlyVersionX''':
{<!-- -->note}Este documento ou seção só se aplica ao <nowiki>'''Firefox {{{1}}}'''</nowiki>!{<!-- -->/note}
Então, em uma página wiki, você poderia usar isso:
<nowiki>[[Template:OnlyVersionX|4]]</nowiki>
E, em outra página, você pode usar:
<nowiki>[[Template:OnlyVersionX|3.6]]</nowiki>
Você pode usar vários argumentos, ou duas vezes o mesmo argumento, também!
'''Template:XLikesY''':
<pre><nowiki># {{{2}}} likes {{{1}}}.
# {{{3}}} likes {{{2}}}.
# Class! Nobody likes {{{2}}}!</nowiki></pre>
Em seguida, use:
<nowiki>[[Template:XLikesY|Lisa|Milhouse|Janey]]</nowiki>
Isto resultaria em:
<blockquote>
# Milhouse likes Lisa.
# Janey likes Milhouse.
# Class! Nobody likes Milhouse!
</blockquote>
Manter o controle de todos esses números pode ser confuso,então você também pode usar ''nome'' argumentos para um template:
'''Template:XPrecededY''':
Primeiro vem {{{first}}}, em seguida {{{second}}}.
And using it:
<nowiki>[[Template:XPrecededY|first=love|second=marriage]]</nowiki>
Com argumentos nomeados, você não precisa se preocupar com a ordem quando você usa o
template:
<nowiki>[[Template:XPrecededY|second=marriage|first=love]]</nowiki>
Ambos os exemplos de utilização '''Template:XPrecededY''' terá o mesmo resultado.
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!
{warning}'''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.{/warning}
__TOC__
=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.
{note}Os templates estão listados em [/pt-BR/contributors/kb-overview?category=60 nesta página]. Uma lista alfabética dos templates existentes pode ser encontrada [/pt-BR/kb/category/60 aqui].{/note}
=Como fazer um Template=
#[/pt-BR/kb/new Crie um novo artigo da Base de Conhecimento]. Experimente [https://support.allizom.org/pt-BR/kb/new criar um novo artigo da Base de Conhecimento em nosso servidor de teste].
#Certifique-se que o nome comece com "Template:" - por exemplo, [/en-US/kb/Template:aboutconfig Template:aboutconfig].
#Defina a categoria para "Template".
#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:
<code><nowiki>[[Template:Some Template]]</nowiki></code>
ou
<code><nowiki>[[T:Some Template]]</nowiki></code>
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:'''<br>
'''Não''' use "#" em nenhum dos passos e '''Adicione''' <nowiki><li></nowiki> <nowiki></li></nowiki> ao redor do segundo passo e dos subsequentes, assim:
<code>This is the first step in your list<br>
<nowiki><li></nowiki>This is the second step<nowiki></li></nowiki><br>
<nowiki><li></nowiki>This is the third step<nowiki></li></nowiki><br></code>
Então, ao adicionar o template a um artigo, adicione o "#" antes do template:
<code><nowiki>#</nowiki><nowiki>[[</nowiki>T:List]]<br>
<nowiki>#</nowiki>This is another step that's not part of the template</code>
Ele será parecido com este:
#This is the first step in your list
#This is the second step
#This is the third step
#This is another step that's not part of the template
Outra parte importante - você não pode usar [[How to use For#w_inline-and-block-level-contexts|block level <nowiki>{</nowiki>for}]] nestes templates. Por exemplo:<br>
'''Bad:'''<br>
<code><nowiki>{</nowiki>for not fx10}<br>
First step - Firefox 9 and lower<br>
<nowiki>{</nowiki>/for}<br>
<nowiki>{</nowiki>for fx10}<br>
First step - Firefox 10 and higher<br>
<nowiki>{</nowiki>/for}<br>
<nowiki><li></nowiki>This is the second step<nowiki></li></nowiki></code>
'''Good:'''<br>
<code><nowiki>{</nowiki>for not fx10}First step - Firefox 9 and lower<nowiki>{</nowiki>/for}<nowiki>{</nowiki>for fx10}<br>
First step - Firefox 10 and higher<nowiki>{</nowiki>/for}<br>
<nowiki><li></nowiki>This is the second step<nowiki></li></nowiki></code>
= 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 <nowiki>'''Firefox {{{1}}}'''</nowiki>!{<!-- -->/note}
Então, em uma página wiki, você poderia usar isso:
<nowiki>[[Template:OnlyVersionX|4]]</nowiki>
E, em outra página, você pode usar:
<nowiki>[[Template:OnlyVersionX|3.6]]</nowiki>
Você pode usar vários argumentos ou o mesmo argumento duas vezes, também!
'''Template:XLikesY''':
<pre><nowiki># {{{2}}} likes {{{1}}}.
# {{{3}}} likes {{{2}}}.
# Class! Nobody likes {{{2}}}!</nowiki></pre>
Em seguida, use:
<nowiki>[[Template:XLikesY|Lisa|Milhouse|Janey]]</nowiki>
Isto resultaria em:
<blockquote>
# Milhouse likes Lisa.
# Janey likes Milhouse.
# Class! Nobody likes Milhouse!
</blockquote>
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:
<nowiki>[[Template:XPrecededY|first=love|second=marriage]]</nowiki>
Com argumentos nomeados, você não precisa se preocupar com a ordem quando você usa o
template:
<nowiki>[[Template:XPrecededY|second=marriage|first=love]]</nowiki>
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 [https://support.mozilla.org/pt-BR/products/contributor/kb aqui].