Exibir código-fonte para STI:MediaWiki:Ajuda:Templates


== INTRODUÇÃO ==

Modelos ou templates são páginas wiki padrão cujo conteúdo é projetado para ser incorporado dentro de outras páginas. Modelos seguem uma convenção de que o nome é prefixado com "Template:", atribuindo-o a esse um ''namespace''; Além disso, você pode criá-los como qualquer outra página wiki. O uso mais simples de modelos é o seguinte. Se você criar uma página chamada "Template:Bem-vindo" com o conteúdo:

 Olá! Bem vindo ao wiki.

você criou seu primeiro modelo! Se você inserir o código:

<nowiki>{{Bem-vindo}}</nowiki>

em qualquer outra página, quando essa página é exibida, o texto "Olá! Bem-vindo ao wiki". aparecerá em vez de
<nowiki>{{Bem-vindo}}</nowiki>
. O conteúdo do modelo é "incluído" na outra página, ou seja, está integrado na página. Você pode inserir {{Bem-vindo}} em qualquer ponto de qualquer página em que deseja. Suponha que seja usado em 100 páginas. Se você, então, alterar o conteúdo do modelo para: 
 Olá! Bem vindo a este wiki maravilhoso.

e revisitar qualquer uma das 100 páginas em que o modelo foi usado, você verá o novo texto em vez do original. Dessa forma, você alterou o conteúdo de 100 páginas sem editá-las, porque o modelo foi transcrito para essas páginas. Este é o mecanismo básico. Existem vários recursos adicionais de inclusão que enriquecem esse mecanismo e tornam os modelos muito úteis.

=== Uso ===

Modelos podem ser usados em outras páginas das seguintes formas:

:
:*<nowiki>{{Name}}</nowiki>
- conforme descrito acima, esse link será substituído dinamicamente pelo conteúdo atual de <nowiki>[[Template: Name]]</nowiki>
no momento em que a página com o link do modelo for carregada. O link permanecerá inalterado na origem da página. 
:*<nowiki>{{subst: Name}}</nowiki>
- quando este link de template é usado, ele será substituído de uma vez por todas pelo conteúdo de <nowiki>[[Template: Name]]</nowiki>
a partir do momento em que a página com o link é salva: uma cópia do O conteúdo de <nowiki>[[Template: Name]]</nowiki>
será substituído pelo link do template. O conteúdo é então parte da página incluída e pode ser editado normalmente, separadamente do original. Nota: alterações posteriores na página do modelo de origem não serão propagadas para a página com o link do modelo. 
:*<nowiki>{{safesubst: Name}}</nowiki>
- foi introduzido para permitir a substituição que não quebra a transclusão, consulte w: pt: Ajuda: Substituição # O modificador de segurança: modificador. 
:*<nowiki>{{msgnw: Name}}</nowiki>
inclui o modelo em um formulário que o exibe como uma sintaxe bruta do wiki (a forma que o <nowiki> faz) quando a página que o contém é buscada.

Na verdade, uma página wiki comum também pode ser usada como um modelo, simplesmente especificando o ''namespace'' em que ele reside, portanto:

:* <nowiki>{{Template: Pagename}}</nowiki>
inclui <nowiki>[[Predefinição: Pagename]]</nowiki>

:*<nowiki>{{Talk: Pagename}}</nowiki>
inclui <nowiki>[[Discussão: Pagename]]</nowiki>

:*<nowiki>{{: Pagename}}</nowiki>
inclui <nowiki>[[nome da página]]</nowiki>
 
::<nowiki>{{subst :: Pagename}}</nowiki>
substitui-se pelo conteúdo de <nowiki>[[Pagename]]</nowiki>
  

Se não existir tal namespace, o título completo será considerado um modelo:

:
:*<nowiki>{{Foo: Bar}}</nowiki>
inclui <nowiki>[[Predefinição: Foo: Bar]]</nowiki>
  

=== Parâmetros ===

Para enriquecer o mecanismo de transclusão, o MediaWiki permite que os parâmetros sejam passados para um modelo quando ele é transcluído. Os parâmetros permitem que o modelo produza conteúdos diferentes ou tenha comportamentos diferentes. Para que a nota pareça semelhante em todos os lugares em que é usada, você pode definir, por exemplo, um modelo chamado Template: Thankyou, por exemplo. Embora a nota deva ser semelhante sempre que um usuário agradece a outro usuário, seu conteúdo específico (ou seja, o motivo e a assinatura) será diferente. Por esse motivo, você deve passá-los como parâmetros. Se ignorarmos os elementos restantes para formatar a caixa e colocar a imagem, o conteúdo principal do modelo será o seguinte:

 'Um pouco obrigado ...'
 por '''{{{1}}}'''.
 abraços, '''{{{2}}}'''

Observe o uso de {{{1}}} e {{{2}}}. Esta é a maneira de identificar, dentro dos modelos, os parâmetros que serão passados quando o modelo for usado. Observe que, dentro do modelo, cada parâmetro é cercado por três chaves: {{{}}}. Isso é diferente do uso normal do nome do modelo. Ao usar o modelo em uma página, você preenche os valores dos parâmetros, separados por um caractere "pipe" (|). O MediaWiki permite que parâmetros sejam passados para o modelo de três maneiras: Anonimamente, Numerados e Nomeados.

==== Parâmetros numerados ====

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

<nowiki>{{Thankyou | '''2 = Eu | 1 = sua amizade'''}}</nowiki>

Desta vez, o template
<nowiki>{{Thankyou}}</nowiki>
recebe parâmetros {{{1}}} = sua amizade e {{{2}}} = Eu, apesar de terem sido fornecidos em ordem inversa, e produz: 
 Um pouco obrigada ...
 pela '''sua amizade'''.
 abraços, '''Eu'''

== ORGANIZANDO MODELOS ==

Para que os modelos sejam eficazes, os usuários precisam encontrá-los e descobrir como usá-los. Para encontrá-los, os usuários podem:

:
:*Clique em Páginas especiais> Todas as páginas. 
:*Na lista Namespace:, escolha Template e clique em Ir.   

=== Vinculando a um modelo ===

Uma página de modelo pode ser vinculada a qualquer outra página da wiki. Por exemplo, o link Template: Navbar é gerado usando o wikicode
<nowiki>[[Template: Navbar]]</nowiki>
. Em muitos wikis, o Template: Tl pode ser usado para fornecer um link para um modelo formatado de forma que mostre o wikicode "chaves duplas" necessário para transcluir o modelo sem realmente fazer a tranclusion. Por exemplo, o código <nowiki>{{tl | Navbar}}</nowiki>
pode ser usado para criar o link <nowiki>{{Navbar}}</nowiki>
. Essa construção é comumente usada na documentação de modelo, nas páginas de ajuda e nas páginas de discussão ao se referir a modelos. O mesmo efeito pode ser alcançado usando <nowiki><code>{{[[Template: Navbar | Navbar]]}}</ code></nowiki>
, mas a abordagem <nowiki>{{tl}}</nowiki>
envolve muito menos digitação. Em qualquer wiki, o modelo Tl, se existir, pode ou não renderizar o texto em um elemento "code", como mostrado aqui. Caso contrário, outro modelo com nome semelhante pode fazê-lo. Veja, por exemplo, a seção "Veja também" da documentação de en: Template: Tl na Wikipédia em inglês. 
=== Principais Templates pré-definidos ===

A seguir apresentamos os principais templates pré-definidos e disponíveis para uso na Wiki.

{| align="center"
|-
| 
{| class="wikitable"
|-
! style="width: 380px" | Sintaxe
! Template
|-
| <nowiki> {{Obsoleto}} </nowiki>

| {{Obsoleto}}
|-
| <nowiki> {{Deletar||Seu texto aqui}} </nowiki>

| {{Deletar|Seu texto aqui}}
|-
| <nowiki> {{Descontinuado||Seu texto aqui}} </nowiki>

| {{Descontinuado|Seu texto aqui}}
|-
| <nowiki> {{Melhorias||Seu texto aqui}} </nowiki>

| {{Melhorias|Seu texto aqui}}
|-
| <nowiki> {{Dicas||Seu texto aqui}} </nowiki>

| {{Dicas|Seu texto aqui}}

|-
| <nowiki> {{Info1||Seu texto aqui}} </nowiki>

| {{Info1|Seu texto aqui}}
|-
| <nowiki> {{Info2||Seu texto aqui}} </nowiki>

| {{Info2|Seu texto aqui}}
|-
| <nowiki> {{Info3||Seu texto aqui}} </nowiki>

| {{Info3|Seu texto aqui}}
|-
| <nowiki> {{Info4||Seu texto aqui}} </nowiki>

| {{Info4|Seu texto aqui}}
|-
| <nowiki> {{Aviso||Seu texto aqui}} </nowiki>

| {{Aviso|Seu texto aqui}}
|-
| <nowiki> {{Perigo||Seu texto aqui}} </nowiki>

| {{Perigo|Seu texto aqui}}
|-
| <nowiki> {{Cuidado||Seu texto aqui}} </nowiki>

| {{Cuidado|Seu texto aqui}}
|-
| <nowiki> {{Importante||Seu texto aqui}} </nowiki>
| {{Importante|Seu texto aqui}}
|-
| <nowiki> {{Nota1||Seu texto aqui}} </nowiki>
| {{Nota1|Seu texto aqui}}
|-
| <nowiki> {{Nota2||Seu texto aqui}} </nowiki>
| {{Nota2|Seu texto aqui}}
|-
| <nowiki> {{Nota3||Seu texto aqui}} </nowiki>
| {{Nota3|Seu texto aqui}}
|-
| <nowiki> {{Observacao||Seu texto aqui}} </nowiki>
| {{Observacao|Seu texto aqui}}
|-
| <nowiki> {{Atencao1||Seu texto aqui}} </nowiki>
| {{Atencao1|Seu texto aqui}}
|-
| <nowiki> {{Atencao2||Titulo aqui||Seu texto aqui}} </nowiki>
| {{Atencao2|Titulo aqui|Seu texto aqui}}
|-
| <nowiki> {{Saiba||Seu texto aqui}} </nowiki>
| {{Saiba|Seu texto aqui}}
|-
| <nowiki> {{Exemplo||Seu texto aqui}} </nowiki>

| {{Exemplo|Seu texto aqui}}
|-
| <nowiki> {{Agir||Conteúdo Aqui}} </nowiki>

| {{Agir|Conteúdo Aqui}}
|-
| <nowiki> {{Alinhar||Conteúdo Aqui}} </nowiki>

| {{Alinhar|Conteúdo Aqui}}
|-
| <nowiki> {{Analisar||Conteúdo Aqui}} </nowiki>

| {{Analisar|Conteúdo Aqui}}
|-
| <nowiki> {{Processo||Conteúdo Aqui}} </nowiki>

| {{Processo|Conteúdo Aqui}}
|-
| <nowiki> {{Resolver||Conteúdo Aqui}} </nowiki>

| {{Resolver|Conteúdo Aqui}}
|-
| <nowiki> {{Reflexao2||Conteúdo Aqui}} </nowiki>

| {{Reflexao2|Conteúdo Aqui}}
|-
| <nowiki> {{Share||Conteúdo Aqui}} </nowiki>

| {{Share|Conteúdo Aqui}}
|-
| <nowiki> {{Lembre-se||Seu texto aqui}} </nowiki>

| {{Lembre-se|Seu texto aqui}}
|-
| <nowiki> {{Lembre-se2||Seu texto aqui}} </nowiki>

| {{Lembre-se2|Seu texto aqui}}
|-
| <nowiki> {{Aspas||Seu texto aqui}} </nowiki>

| {{Aspas|Seu texto aqui}}

|-
| <nowiki> {{Infobox|Título aqui|Resumo aqui|Subtítulo aqui|Conteúdo aqui}} </nowiki>

| {{Infobox|Título aqui|Resumo aqui|Subtítulo aqui|Conteúdo aqui}}
|-
| <nowiki> {{Infobox1|Resumo aqui|Título aqui|Conteúdo aqui}} </nowiki>

| {{Infobox1|Resumo aqui|Título aqui|Conteúdo aqui}}
|-
| <nowiki> {{Seq1||TConteúdo}} </nowiki>

| {{Seq1|Conteúdo}}
|-
| <nowiki> VideoAula </br> Deve-se usar o código em Ajuda -> Multimidia </nowiki>

| {{VideoAula|Conteúdo}}
|-
| <nowiki> Video </br> Deve-se usar o código em Ajuda -> Multimidia </nowiki>

| {{Video|Conteúdo}}

|}

|}
:
::
:::
::::URL: [https://www.mediawiki.org/wiki/Help:Templates/pt-br https://www.mediawiki.org/wiki/Help:Templates/pt-br]       

{{Ajuda}}