Ajuda: Template

Da Wikipédia, a enciclopédia livre.
Ir para a navegação Ir para a pesquisa
TIPOS DE PÁGINA
Item · Rosca ( Barra )
Categoria · Portal
Arquivo ( Imagem · Som )
Página de serviço
Modelo · Diretriz
Projeto · Página do usuário
Módulo
Todos os namespaces
Abreviações
WP: TL
WP: Tl

Na Wikipedia, um modelo [1] é uma página especial criada para ser incluída em outras páginas por meio do mecanismo de inclusão .

Ele pode ser usado para vários fins:

  • insira facilmente texto repetido em páginas diferentes, escrevendo-o uma vez, como para os modelos de navegação
  • inserir elementos padrão, tabelas de informação ou avisos
  • insira elementos cujo comportamento pode ser programado de acordo com algumas variáveis.

Os modelos estão contidos no modelo de espaço de nomes (ou espaço de nomes 10), ou seja, o espaço de nomes cujas páginas têm a forma " Modelo: NOME " (por exemplo: Modelo: S , Modelo: Bem-vindo , Modelo: Europa ).

Para se referir a um modelo, você também pode usar a abreviatura T, por exemplo. t: Europa .

Gnome-help.svg - Balcão de informações

Inserção

Ícone da lupa mgx2.svg O mesmo tópico em detalhes: Ajuda: Inclusão .
Exemplo de inclusão

Todas as páginas pertencentes ao namespace 10 podem ser rapidamente inseridas em uma página, simplesmente escrevendo o nome do template (a parte que segue o Template: texto) entre chaves duplas [2] , como em {{ NAME }}. Essa referência no wikitexto faz com que o conteúdo do modelo seja inserido quando a página for exibida.

Se a página "Modelo: nome " não existir, então {{ nome }} funcionará como [[Modelo: nome ]], um link para uma página inexistente, levando à página de edição.

Não é permitido inserir templates inexistentes.

Se o modelo não estiver no namespace apropriado (porque ainda está sendo trabalhado ou porque é uma inserção de outra página), ele pode ser usado de qualquer maneira, inserindo o nome com o caminho completo (por exemplo {{usuário: NOME SOBRENOME / página de teste}}).

A entrada é sensível a maiúsculas, ou seja, os distingue de software maiúsculas e minúsculas letras, com exceção da primeira letra e espaços que são equivalentes a sublinhados ( "_"). Portanto:

  • modelo {{página de teste}} e modelo {{página de teste}} serão reconhecidos como diferentes
  • os modelos {{test page}} e {{test_page}} serão idênticos.

Você pode usar a inclusão aninhada: um modelo incluído em uma página também pode conter um ou mais modelos.

Ao inserir modelos, é possível declarar variáveis ​​que serão utilizadas dentro do modelo : neste caso, falamos de um modelo paramétrico .

Suspensórios

Para inserir as chaves duplas que abrem e fecham um modelo, existem várias maneiras que dependem do layout do teclado e do sistema operacional . Você também pode copiar e colar aqui: {{}}

clipe aberto clipe fechado sistema
Alt + Gr + 7 Alt + Gr + 0 GNU / Linux
Alt + Gr + 8 Alt + Gr + 9 GNU / Linux
Alt + 123 Alt + 125 Microsoft Windows
Alt + Gr + Shift + é Alt + Gr + Shift + + Microsoft Windows - GNU / Linux
Alt + Ctrl + Shift + é Alt + Ctrl + Shift + + Microsoft Windows
+ + é + + + macOS (com layout italiano - Pro )

Nota : a chave Shift , em alguns teclados também pode ser chamado de "Shift". Geralmente é encontrado logo abaixo da chave Digite (ou "Enter").

Uso

Os modelos são úteis para qualquer elemento complexo, especialmente com formatação gráfica, que precisa ser repetido em duas ou mais páginas sem ter que digitar cada vez. Graças aos parâmetros também é possível alterar sua aparência dependendo do item, sempre sem ter que digitar tudo a cada vez. Os modelos não são apenas convenientes, mas podem ajudar a obter consistência entre as páginas.

As aplicações típicas são:

Usos desaconselhados

Não é recomendado duplicar o conteúdo textual (com e sem modelos), por exemplo, colocando uma seção que tem a ver com A e B no item A e no item B. Isso cria confusão, especialmente para contribuidores novatos. Nestes casos, é aconselhável visualizar o texto em um local e usar wikilinks para conectá-lo de vários locais.

Modelos paramétricos

Curly Brackets.svg

Ao construir um modelo, pode ser necessário permitir que o usuário personalize parte do texto ou comportamento do modelo, dependendo da página em que está inserido. Neste caso, o usuário indica um ou mais parâmetros que serão explorados para a representação de vídeo do próprio template. Por exemplo, o modelo: Filme mostra dados diferentes dependendo do filme que descreve.

Em cada página onde o modelo é inserido, os parâmetros são expressos após o nome do modelo, separados por barras verticais, e podem ser identificados por um nome de parâmetro ou por uma ordem progressiva. O método de identificação depende de como o modelo foi construído e é explicado em seu manual ; ambos também podem ser suportados.

Exemplo de inclusão com parâmetros chamados por nome:

 {{nome do modelo | nome = Tom | sobrenome = Tom | data = terça}}

Exemplo de inclusão com parâmetros sequenciais:

 {{nome do modelo | Tizio | Caio | Terça}}

Dentro do próprio modelo, no meio do wikicode que constitui a página "Modelo: nome do modelo", os parâmetros são representados por rótulos entre colchetes triplos ; quando o modelo é incluído, esses rótulos serão substituídos pelos valores de texto atribuídos de tempos em tempos pelo usuário aos parâmetros.

No primeiro exemplo:

 {{{nome}}}, {{{sobrenome}}} e {{{dados}}}

No segundo:

 {{{1}}}, {{{2}}} e {{{3}}}

A sintaxe completa é, portanto,

 {{templatename | nome do parâmetro1 = valor do parâmetro1 | nome do parâmetro2 = valor do parâmetro 2}}
com as tags {{{nomeparametro}}} no modelo
ou
 {{templatename|valoreparametro1|valoreparametro2}}
com as tags {{{1}}} , {{{2}}} , etc. no modelo.

notas importantes :

  • as tags de parâmetro no modelo têm três chaves e não duas !
  • os nomes dos parâmetros devem corresponder exatamente; letras maiúsculas são importantes e os espaços não equivalem a sublinhados.
Exemplo

A página "Modelo: Saudação" contém:

 Olá {{{name}}}, como você está?

O modelo é incluído em uma entrada digitando:

 {{Saudação | nome = Tom}}

Depois de salvar a alteração (ou na visualização ), o item mostrará:

 Oi cara tudo bem?

Na fase de renderização (ou seja, gerar o resultado da inserção do modelo na tela), os parâmetros extras serão ignorados. Se, por outro lado, os parâmetros forem insuficientes, normalmente ocorrerá um erro, a menos que tenha sido prevista a possibilidade de omissão de um determinado parâmetro.

Parâmetros opcionais

Normalmente, um parâmetro é tornado opcional com a forma {{{1|}}} ou {{{1|Pippo}}} , ou seja, com uma barra vertical após o nome. A barra significa que, na ausência desse parâmetro, o valor após a barra será usado por padrão (nada no primeiro caso; "Pippo" no segundo).

O padrão não é aplicado se o parâmetro estiver vazio, mas sua declaração ainda está presente: chamando {{nome template|}} (ou {{nome template|nome=}} se esse parâmetro tiver um nome) o valor do parâmetro será justo null e não "Pippo". Para verificar se o parâmetro não está ausente nem vazio, a função #if é necessária.

Personagens de espaço

Ao usar a notação =, quaisquer espaços e retornos de carro em torno dos valores dos parâmetros são ignorados, então {{Saluto|nome=Tizio}} é equivalente a {{Saluto| nome = Tizio }} . Por esse motivo, os modelos com muitos parâmetros nomeados costumam ser colocados no seguinte formato, que é mais legível e fácil de preencher:

 {{nome do modelo
| nome = Tom
| sobrenome = Caio
...
}}

No entanto, este não é o caso para declarações implícitas: {{Saluto|Tizio}} e {{Saluto| Tizio }} são diferentes e, no segundo caso, os espaços serão reportados textualmente na página de chamada. Os espaços são frequentemente inofensivos de qualquer maneira, mas se não forem, um possível truque para removê-los é usar {{#if:toglispazi|{{{1}}}}} no código do modelo ("remoção de espaço" é qualquer string )

Limitações

Um nome de parâmetro ou seu valor não pode conter o caractere " | ", pois é usado para separar parâmetros. Qualquer "|" dentro de wikilinks ( links canalizados ) ou outros modelos não são um problema, mas se você precisar inserir um "|" por outras razões, use o comando {{!}}.

esta sintaxe funciona corretamente: {{Template | [[Marte (astronomia) | Marte]]}}
mas isso não funciona: {{Template | La | é um bar}}
para remediar isso, você precisa usar esta variante: {{Modelo | O {{!}} é uma barra}}

Além disso, se o nome da variável não for especificado, seu valor não pode conter o sinal " = ". Se você precisar inserir o sinal "=" em um modelo que usa nomes de variáveis ​​implícitos, você precisará especificar o nome, por exemplo:

esta sintaxe funciona corretamente: {{Template | A | B}}
mas isso não funciona: {{Template | A = 10 | B = 32}}
para remediar isso, você precisa usar esta variante: {{Modelo | 1 = A = 10 | 2 = B = 32 }}

Ou você pode usar o modelo {{ = }} da seguinte maneira: {{Modelo | A {{=}} 10 | B {{=}} 32}}.

Editar um modelo

Para ver o conteúdo de um modelo, é necessário abri-lo no modo de edição.

Simplesmente indo para a página do modelo, dependendo de como ela está configurada, você obterá nos casos mais comuns um exemplo de exibição do modelo ou uma página de instruções, às vezes acompanhada por um aviso que marca os modelos mais complexos e difíceis de modificar.

Para ir à página de um template, além de digitar seu nome na caixa de pesquisa, é possível clicar na tag de edição de um item no qual o template está contido. No canto inferior esquerdo, após o wikicode do item, aparecerá uma seção com o título "Modelos usados ​​nesta página", contendo links para todos os modelos inseridos na página.

É necessário um esclarecimento importante:

NUNCA MODIFIQUE O CONTEÚDO DE UM MODELO EM USO SE NÃO SABE O QUE ESTÁ FAZENDO

A edição de um modelo muito lembrado pode danificar várias páginas, bem como sobrecarregar os servidores da Wikipedia, que precisam atualizar todas as páginas que o incluem. Em particular, não altere o nome / ordem dos parâmetros , a menos que pretenda corrigir todas as páginas que já incluem o modelo, uma por uma. É sempre melhor experimentar antes de modificar modelos populares, usando a visualização ou sandboxes .

Quando um modelo é aberto para edição, é possível, como para todas as páginas, visualizar a visualização do próprio modelo; além disso, outra função está disponível para modelos (a caixa "Visualizar uma página com este modelo") que permite visualizar diretamente o efeito que as alterações teriam em um item que já inclui o modelo, sem ter que salvar, nem mesmo caixa de areia.

Crie um modelo

A criação de um novo modelo é feita como em qualquer outra página. Uma vez que um modelo é feito para ser usado em várias vozes, às vezes até milhares, é bom discutir a conveniência de sua criação, por exemplo, em um projeto temático .

Ao escrever um modelo, é sempre uma boa idéia inserir as categorias às quais o modelo pertence, um pequeno texto de instrução (ou melhor ainda, um manual ) e uma apresentação das funções do modelo entre as tags <noinclude> </noinclude>. Consulte a Ajuda: Inclusão para obter uma descrição dessas tags. Se você não usar o noinclude, as categorias e instruções também aparecerão erroneamente em todos os itens nos quais o modelo foi inserido.

Se necessário, o código do modelo real é colocado entre tags <includeonly> </includeonly>, para evitar que um resultado sem sentido seja mostrado na própria página do modelo. Não insira espaços e envolva fora das tags includeonly e noinclude, pois eles também apareceriam nas entradas.

Nomes de modelos

Não há limites técnicos para os títulos além daqueles que todas as outras páginas têm; um modelo pode ser facilmente chamado de "Modelo: Principais cidades italianas", sem a necessidade de nomes de linguagem de programação como "Modelo: CittaITA1" (o mesmo pode ser dito dos nomes dos parâmetros). Em geral, portanto, siga as mesmas convenções usadas para as vozes , escolhendo nomes em italiano correto.

As abreviaturas são normalmente usadas apenas para modelos amplamente utilizados que requerem uma alta velocidade de entrada manual, este é o caso, por exemplo, dos avisos principais.

Observe que os redirecionamentos também funcionam para modelos.

Lista de páginas contendo um modelo

Para verificar quais páginas contêm um modelo você usa (como para qualquer página) as ferramentas Apontar aqui à esquerda. A ferramenta permite distinguir quais páginas incluem o modelo e quais simplesmente apontam para ele com um wikilink.

Lista de modelos incluídos em uma página

Se você deseja visualizar a lista de modelos incluídos em uma página, abra essa página no modo de edição (ou visualize a fonte, para páginas protegidas).

Logo abaixo da caixa de edição, à esquerda, há uma parte da página intitulada "Modelos usados ​​nesta página:" que lista os vários modelos incluídos na página em questão. Você pode clicar no nome de um deles para acessar a página relevante e, se necessário, editá-lo a partir dela.

Observação: não apenas os modelos incluídos diretamente, mas também indiretamente (ou seja, aqueles incluídos por sua vez em um modelo incluído na página e assim por diante) são indicados lá.

Cache

Ícone da lupa mgx2.svg O mesmo tópico em detalhes: Help: Purge .

Quando um modelo é modificado, a versão HTML em cache de todas as páginas que usam o modelo são marcadas como sendo regeneradas, o que é executado por meio de uma fila de trabalho pelos servidores. A atualização pode, portanto, levar algum tempo, especialmente quando o modelo está incluído em muitas páginas; portanto, não se preocupe se as alterações do modelo não aparecerem imediatamente nas páginas. Para forçar imediatamente a atualização de uma determinada página, basta fazer um salvamento (mesmo sem modificações) da página.

Substituindo um modelo (subst :)

Ícone da lupa mgx2.svg O mesmo tópico em detalhes: Ajuda: Subst .

Ao colocar "subst:" após os colchetes abertos, este comando no wikitexto será substituído pelo conteúdo do modelo quando a página for salva. Se alguém alterar a página posteriormente, não verá mais a tag no wikitexto, mas apenas o texto substituído.

Verifique a aparência

Ao editar os gráficos de um modelo, é uma boa ideia verificar sua aparência com os navegadores principais, já que nem todos os navegadores exibem gráficos da Wikipedia da mesma maneira. Veja também Wikipedia: Acessibilidade de conteúdo .

Variáveis ​​do sistema

As variáveis ​​do sistema podem ser consideradas como templates especiais gerenciados com a mesma sintaxe, mesmo que o sistema as reconheça sem a necessidade de uma página correspondente no namespace do Template, que de fato, se criado com um nome já utilizado pelas variáveis, seria ignorado.

Também é possível usar variáveis ​​dentro dos templates, além dos parâmetros declarados pelo usuário, para obter algumas informações como os nomes das páginas nas quais o template está incluído ({{PAGENAME}}) ou a data ({{ CURRENTDAY}} {{CURRENTMONTHNAME}} e {{CURRENTYEAR}} nas várias combinações). Uma palavra mágica em um modelo é avaliada após a inserção na página que faz referência a ela, por exemplo, se a palavra mágica {{PAGENAME}} aparecer no wikicode de um modelo, ela é processada com o nome da página que a contém e não com o nome do modelo.

msgnw

Use "msgnw:" após os colchetes abertos para exibir o wikicode interno do modelo em vez de sua aparência. Por exemplo, exibem {{ITA}} e {{msgnw: ITA}} respectivamente:

Itália Itália
E
{{flag | ITA | name}} <noinclude> {{Protected}} [[Category: National flag templates]] [[fr: Model: Italie]] </noinclude>

Pesquisa combinada

Exquisite-kfind.png Árvore de categorias relativas aos modelos
(páginas em itálico )

Exquisite-kfind.png Pesquise o namespace do modelo


Observação

  1. ^ O termo está em inglês ( [ˈtɛmpleɪt] ou [ˈtɛmplɪt] ): em italiano significa "modelo", mas literalmente é "silhueta", "elenco". Para obter informações gerais, consulte a entrada do modelo .
  2. ^ Com o teclado italiano, a chave aberta pode ser obtida pressionando Alt Gr + Shift + [ , enquanto a chave de fechamento pressionando Alt Gr + Shift + ] )

Páginas relacionadas

Outros projetos

modelo Projeto modelo : colabore com a Wikipedia no tópico do modelo