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:
{{Bem-vindo}}
em qualquer outra página, quando essa página é exibida, o texto "Olá! Bem-vindo ao wiki". aparecerá em vez de {{Bem-vindo}} . O conteúdo do modelo é "incluído" na outra página, ou seja, está integrado na página. Você pode inserir Predefinição: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:
-
- {{Name}}
- conforme descrito acima, esse link será substituído dinamicamente pelo conteúdo atual de [[Template: Name]] no momento em que a página com o link do modelo for carregada. O link permanecerá inalterado na origem da página.
- {{subst: Name}}
- quando este link de template é usado, ele será substituído de uma vez por todas pelo conteúdo de [[Template: Name]] a partir do momento em que a página com o link é salva: uma cópia do O conteúdo de [[Template: Name]] 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.
- {{safesubst: Name}}
- 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.
- {{msgnw: Name}}
inclui o modelo em um formulário que o exibe como uma sintaxe bruta do wiki (a forma que o 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}} inclui [[Predefinição: Pagename]]
- {{Talk: Pagename}}
inclui [[Discussão: Pagename]]
- {{: Pagename}}
inclui [[nome da página]]
- {{subst :: Pagename}}
substitui-se pelo conteúdo de [[Pagename]]
Se não existir tal namespace, o título completo será considerado um modelo:
-
- {{Foo: Bar}}
inclui [[Predefinição: Foo: Bar]]
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:
{{Thankyou | '''2 = Eu | 1 = sua amizade'''}}
Desta vez, o template {{Thankyou}} 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 [[Template: Navbar]] . 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 {{tl | Navbar}} pode ser usado para criar o link {{Navbar}} . 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 <code>{{[[Template: Navbar | Navbar]]}}</ code> , mas a abordagem {{tl}} 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.
| |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
|
| ||
