Wikipédia:Predefinições
Esta é uma página informativa.
Ela descreve a prática estabelecida da comunidade sobre algum ou mais aspetos das normas e costumes da Wikipédia e que foram considerados consensuais pela comunidade. Prefira utilizar a página de discussão ou até mesmo a esplanada antes de fazer uma modificação que altere o contexto.
Predefinições são páginas que contém texto pré-definido, isto é, feito para ser reutilizado por outras páginas sem a necessidade de ser copiado manualmente em cada uma delas.
Embora qualquer página possa ser usada como uma predefinição, estas correspondem a um tipo especial de páginas, criadas especificamente para serem usadas dentro de outras, e que ficam no domínio predefinição.
Elas são comumente utilizadas para texto clichê, avisos e notificações padrão, infoboxes, predefinições de navegação e similares.
As predefinições são, de certa forma, no que diz respeito à edição de páginas, o recurso mais difícil de compreender e dominar da Wikipédia.
Nota: Antes de criar uma predefinição, tenha certeza de que leu e compreendeu esta e as outras páginas indicadas.
Tipos de predefinições
Quanto à manipulação da informação
Quanto à funcionalidade, as predefinições podem ser classificadas por predefinições estáticas ou predefinições dinâmicas.
Predefinições estáticas
São aquelas que apresentam a mesma informação em todas as páginas em que são utilizadas, ou ao menos, não tem qualquer campo, opção ou parâmetros personalizáveis ao utilizá-la. Esse tipo de predefinições é o mais simples de ser criado e utilizado. Alguns exemplos de predefinições estáticas: Predefinição:História da arte, Predefinição:Metallica​, Predefinição:Jogos Olímpicos e Predefinição:Tabela periódica.
Predefinições dinâmicas
São predefinições um pouco mais complexas que permitem introduzir dados personalizados em determinadas páginas. Normalmente este tipo de predefinições atua como um "modelo" que pode ser preenchido, de forma semelhante a "formulários" que têm definidos os campos de preenchimento, localização e aparência visual. Ao utilizar essas predefinições numa determinada página, devem ser introduzidos dados personalizados de acordo com o tema. Dessa forma, as páginas que utilizam essas predefinições têm os dados organizados segundo uma determinada estrutura e apresentação. É exemplo disso a Predefinição:Info/País que é utilizada em artigos da Wikipédia relativos a países, como em Portugal e Brasil. Outro exemplo, a Predefinição:Info/Biografia é utilizada em artigos sobre pessoas, como em Albert Einstein e Leonardo da Vinci.
Alguns tipos de predefinições dinâmicas utilizam outros recursos avançados e não têm necessariamente parâmetros opcionais. Por exemplo, a Predefinição:Arquivo histórico que deve ser aplicada apenas em páginas inativas, normalmente do domínio Wikipedia, e nunca no domínio principal (artigos enciclopédicos) detecta se a predefinição foi aplicada numa página do domínio principal e coloca-a na Categoria:!Páginas com predefinições indevidas. Já a Predefinição:Discussão​, que é utilizada em secções da esplanada e nos diversos cafés existentes, mostra informações diferentes consoante a página em que é mostrada.
Tabela de diferença entre predefinições estáticas e predefinições dinâmicas
TipoNome da predefinição (exemplo)Código da predefiniçãoCódigo a colocar nos artigosÉ mostrado nos artigos
EstáticaPredefinição:Albert Einstein
{| border="1"
|Nome
|Albert Einstein
|-
|Nascimento
|[[1879]]
|}
{{Albert Einstein}}
NomeAlbert Einstein
Nascimento1879
DinâmicaPredefinição:Biografia
{| border="1"
|Nome
|{{{nome completo}}}
|-
|Nascimento
|{{{data nascimento}}}
|}
{{Biografia
|nome completo=Albert Einstein
|data nascimento=[[1879]]
}}
NomeAlbert Einstein
Nascimento1879
Nos exemplos apresentados, a predefinição estática de Albert Einstein provavelmente só seria utilizada na página de Albert Einstein. O segundo exemplo pode ser adaptado para ser aplicado em muitas páginas, pois o conteúdo pode ser preenchido com os dados específicos da pessoa titular da página.
Quanto à função
As predefinições caracterizam-se também em diferentes tipos consoante a função:
Infocaixas
Ver artigo principal: Ajuda:Caixa de informação
Infocaixas, ou caixas de informação (do inglês infoboxes) localizam-se normalmente no início das páginas do lado direito, apresentando determinadas informações essenciais de forma resumida. Exemplos de caixas de informação: Predefinição:Info/Barragem​, Predefinição:Info/Filme e Predefinição:Info/Biografia​.
Predefinições de navegação
Ver artigo principal: Wikipedia:Predefinição de navegação
Auxiliam o leitor a navegar entre artigos do mesmo tema. Notar também que normalmente os artigos estão numa determinada categoria e se pode navegar entre categorias mas, ao contrário delas, as caixas de navegação apresentam de forma resumida e prática outros artigos sobre o mesmo tema ou até divididos por subtemas. As caixas de navegação encontram-se normalmente no final das páginas e por vezes no início da página do lado direito caso não haja uma caixa de informação (infobox) nesse local. Exemplos de caixas de navegação: Predefinição:Meses, Predefinição:Páginas por características, Predefinição:Peqind e Predefinição:África.
Caixa de avisos ou indicações relevantes
Destacam determinada mensagem aos leitores e editores. Quando aplicados em artigos enciclopédicos, normalmente esses avisos são temporários. Localizam-se na maioria das vezes no início de uma página ou de uma secção da página. Exemplos de caixas de avisos: Predefinição:Parcial e Predefinição:Má tradução. Exemplos de caixas de informação: Predefinição:Reciclagem​, Predefinição:Esboço e Predefinição:Fusão.
Indicações breves
Indicam de forma breve que existe determinado recurso, por exemplo, um portal sobre um tema. Exemplos: Predefinição:Commons e Predefinição:Portal.
Formatação de elementos
Auxiliam na normalização de terminada informação. Exemplos de formatação de elementos: Predefinição:Carece de fontes, Predefinição:Citar web e Predefinição:Ligações externas.
Predefinições para predefinições
Algumas predefinições destinam-se a serem utilizadas em outras predefinições, como a antiga Predefinição:! (para contornar problemas técnicos existentes antes da implementação da palavra mágica equivalente), ou a Predefinição:Predefinição complexa (que também pode ser considerada uma caixa de aviso).
!Predefinições para o domínio "Predefinição"
sem subcategorias
Páginas ou secções de outras páginas
São utilizadas para simplificar páginas complexas ou para permitir a inclusão de uma secção em várias páginas, como a Predefinição:Projetos correlatos que é mostrada na página principal e pode ser utilizada em outras páginas. No caso, a Predefinição:Projetos correlatos é por vezes colocada nas páginas de usuários.
Marcações invisíveis
Servem normalmente apenas para colocar o artigo em que a predefinição é usada numa determinada categoria ou para incluir esse artigo nos afluentes da predefinição. Este tipo de predefinições permite facilitar a classificação na manutenção de determinados artigos. Apesar destas predefinições poderem ser substituídas por uma categoria, permite no entanto filtrar por domínio as páginas que usem a predefinição. Por exemplo, esta lista mostra onde é utilizada a predefinição no domínio Wikipédia.
Como utilizar uma predefinição
Elas podem ser utilizadas de duas formas: transcluídas ou substituídas, e podem ou não aceitar ou exigir parâmetros.
Basicamente, usar uma predefinição consiste do nome da predefinição e os vários parâmetros que são especificados, cada um separado por uma barra vertical (ou pipe), e o conjunto é cercado por chaves duplas, {{...}}. Nunca se é necessário especificar o prefixo Predefinição: para usar uma predefinição, apenas para encontrar e editar a própria predefinição (embora se a intenção for translcluir uma página de um domínio diferente, o prefixo torna-se obrigatório). Nem todas as predefinições têm parâmetros, e nem todas as predefinições que possuem parâmetros precisam ter valores previstos, por isso às vezes {{nome da predefinição}} é suficiente para usar uma predefinição. Se um parâmetro é realmente necessário, mas um valor não foi fornecido pelo usuário, a predefinição pode ter como resultado algo como {{{...}}} no texto, onde o '...' pode ser um número ou o nome do parâmetro em falta. Isso serve para informar ao usuário que um parâmetro, nomeado ou não, está faltando. Tal pode ser evitado pelo uso de valores padrão para o parâmetro.
Parâmetros podem ter duas formas básicas:
Sem nome (às vezes chamados de parâmetros 'posicionais'): os valores são colocados na predefinição na ordem em que aparecem
{{nome da predefinição|parâmetro1|parâmetro2|...}}
Nomeados: os valores são associados a uma chave particular nomeada na predefinição
{{Nome da predefinição|nomedoparâmetro1 = parâmetro1|nomedoparâmetro2 = parâmetro2|...}}
Estes podem ser misturados:
{{nome da predefinição|parâmetro1|parâmetro2|nomedoparâmetro1 = parâmetro3|nomedoparâmetro2 = parâmetro4| ...}}
Por convenção os parâmetros nomeados estão listados por último, mas isto não é um requisito. Caracteres em branco (espaços, tabulações, retornos) são removidos do início e fim dos valores dos parâmetros nomeados (parâmetros posicionais não eliminam os espaços, mas os retêm, ver #Espaços em branco), mas não a partir do meio: assim {{ ... | param = isto é um teste }} será tratado como se o usuário tivesse digitado {{ ... |param=isto é um teste}}.
A página da predefinição pode incluir material que não é transcluído com a predefinição (tais como documentação ou categorias que pertencem à própria predefinição), ou material que é usado somente quando a página é transcluída (tais como as categorias que se aplicam à página de transclusão, mas não a predefinição). Veja a seção #noinclude, includeonly e onlyinclude abaixo.
Tentar transcluir uma predefinição que não existe produz um link vermelho, assim como links para qualquer outra página que não existe. Seguindo o link permite criar essa predefinição em particular.
Os nomes das predefinições são exatamente como os das outras páginas: CaseSensitive, exceto a primeira letra, com espaços indistinguíveis sublinhados.
As próximas seções descrevem como utilizar a sintaxe da transclusão e da substituição:
Transclusão
Ver artigo principal: Wikipedia:Transclusão
É o modo mais comum de se utilizar predefinições, através da sintaxe {{nome da predefinição}}. Esse código faz com que o sistema busque o conteúdo da Predefinição:Nome da predefinição e o exiba. Cada vez que o conteúdo da predefinição sofre uma alteração, esta será refletida em todas as páginas que contiverem o código {{nome da predefinição}}.
Tabela da sintaxe de transclusão para os diferentes domínios
DomíniosSintaxeResultado
Predefinição{{Nome da predefinição}}Transclusão do conteúdo da predefinição
Principal{{:Título do artigo}}Transclusão do conteúdo do artigo
Principal sem os dois pontos{{Nome do artigo}}Link vermelho para a predefinição não criada
Fora do domínio predefinição e principal{{Domíno:Nome da página}}Transclusão do conteúdo da página
Substituição
Ver artigo principal: Wikipedia:Substituição
Em certos casos, em vez de utilizar uma predefinição transcluída deve-se substituí-la com a seguinte sintaxe: {{subst:nome da predefinição}}. Ao fazê-lo, o código da predefinição é gravado na página e a predefinição não terá essa página como afluente. Note que no caso de a predefinição ser alterada posteriormente, a página em que foi substituída não será atualizada. Devido a esse fator, o recurso só deve ser utilizado quando não se pretende padronizar alguma experiência e o conteúdo da predefinição não necessitar de atualização. Regra geral, predefinições em páginas enciclopédicas nunca devem ter seu código substituído no artigo. Existem certas exceções, em predefinições que adicionam a data, e que na verdade só são parcialmente substituídas porque se substitui uma predefinição que utiliza o código de outra predefinição, como é o caso da
{{VDA}}
que utiliza a
{{VDA2}}
. Neste caso, ao substituir o código, apenas se está a fazer na
{{VDA}}
e não na
{{VDA2}}
.
Erros comuns
URLs
URLs podem conter sinais de igual (=), como em http://some.page.org?key=value&key2=value2. No entanto, o primeiro sinal de igual em um parâmetro de predefinição é sempre tratado como se fosse uma chamada de parâmetro. Assim {{nome da predefinição|http://some.page.org?key=value&key2=value2}} irá agir como se http://some.page.org?key fosse um nome de parâmetro, e não o início de uma URL. Há duas soluções para esse problema:
Espaços em branco
Os parâmetros nomeados tiram espaços automaticamente – espaços, tabulações e retornos, ou outros caracteres não visíveis a partir de um parâmetro. Parâmetros não nomeados mantem todos os espaços. Isso pode causar problemas de formatação, e o resultado não será o esperado.
Barras verticais
O caractere "|" (barra vertical) é usado em predefinições (e nas funções sintáticas) para separar parâmetros e também argumentos. Se é necessário fornecer esse caractere para um parâmetro da predefinição (por exemplo, se o título da citação é BBC News|Business...), então a palavra mágica
{{!}}
deve ser usada, que retorna uma barra vertical não analisada, o que também pode ser obtido pelo código HTML |.
Outras informações
noinclude, includeonly e onlyinclude
noinclude
A tag 'noinclude' serve para não permitir que o texto da predefinição seja transcluído ou substituído na página alvo. É frequentemente utilizado para:
Uso:
Se este texto estivesse numa predefinição, esta parte seria transcluída
<noinclude>mas este texto não seria transcluído</noinclude>
Uma das peculiaridades do 'noinclude' é que o texto contido nele é processado, ainda que não esteja incluído no resultado final. Isso tem a ver com o relatório de erros: o processador necessita reter o texto enquanto verifica se existe uma tag 'noinclude' de fechamento válida (</noinclude>), e isto consome recursos do sistema. Para predefinições que não são muito utilizadas, isto raramente é um problema, mas em algumas predefinições que têm texto em excesso (interwikis em particular) pode criar uma enorme sobrecarga para o sistema. Como regra geral, os interwikis e a documentação devem ser colocados na subpágina /doc (que é gerada automaticamente pela Predefinição:Documentação​).
includeonly
'includeonly' faz o oposto do 'noinclude'. O texto dentro de includeonly só é incluído quando a página é transcluída/substituída, e não aparece na página da predefinição em si. É frequentemente utilizado para:
Uso:
Se este texto estivesse numa predefinição, essa parte iria aparecer na página da predefinição e na página da transclusão
<includeonly>mas esse texto só apareceria na página da transclusão</includeonly>
onlyinclude
A tag 'onlyinclude' inclui na transclusão/substituição apenas o texto que está entre ela; qualquer outra coisa na página – mesmo o texto dentro de 'includeonly' – aparecerá na página da predefinição, mas não será incluído na tranclusão/substituição. Esta tag não é frequentemente usada, mas pode ser útil quando apenas uma pequena porção de texto no meio de uma página grande deve ser transcluída.
Uso:
Se este texto estivesse numa predefinição, esta parte seria visível lá, mas não seria transcluída
<onlyinclude>Este texto é tudo o que seria transcluído</onlyinclude>
Detalhes técnicos
Estas tags são utilizadas da mesma forma que o padrão HTML ou blocos XML: abertura e fechamento de tags entre colchetes angulares (por exemplo, <noinclude>wikitexto afetado</noinclude>).
Talvez a questão mais comum com o uso desses blocos sejam espaços ou linhas indesejados. É importante lembrar que o efeito dessas tags termina imediatamente após o colchete angular passado, e não na linha seguinte ou com o próximo caractere visível.
Estas tags podem ser aninhadas umas dentro das outras, embora (para uma determinada página) isso realmente só se aplica a tag 'onlyinclude'; aninhar 'includeonly' e 'noinclude' é bastante inútil. Cuidado para não dividir as tags, no entanto. Construções como esta <onlyinclude>abc<includeonly>def</onlyinclude>ghi</includeonly> não vão funcionar como o esperado. Use a regra 'primeiro aberto, último fechado', que é padrão para XML.
Note ainda que a expansão pode não ocorrer da maneira esperada. Por exemplo, ~<includeonly>~</includeonly>~~ será exibido como ~~~ na predefinição, e será transcluída como ~~~~, mas não vai ser expandida em ambos os casos (como 'nome do usuário' ou a combinação 'nome de usuário/data'). A predefinição teria de ser substituída para que este wikitexto fosse expandido.
Fragilidades e limitações
Fragilidades
Ver artigo principal: Wikipedia:Predefinições em alto risco
Quando uma predefinição é muito utilizada, ela acaba por se tornar de alto risco. Isto porque caso ocorra algum vandalismo ou edição desastrosa nesta predefinição, o erro ou vandalismo alastra-se pelos seus afluentes, tornando a má edição visível em milhares de artigos. O mesmo ocorre com redirecionamentos de predefinição.
Predefinições substituídas também podem sofrer do mesmo mal, com o problema agravante de que se, ela for utilizada enquanto estava com a edição ruim, não há como consertar, a não ser apagando o texto substituído e reutilizando a predefinição.
Limites
Ver artigo principal: Wikipedia:Limites das predefinições
Alguns limites foram tecnicamente impostos pelos desenvolvedores a fim de evitar transtornos, tanto aos usuários quanto aos servidores. Entre eles incluem-se o limite de predefinições aceitas numa única página (ver a Categoria:!Páginas com excesso de predefinições), e a castração de ParserFunctions custosas, como o #ifexist:, caso excedam certo número numa página (ver a Categoria:!Páginas com demasiadas chamadas a funções exigentes).
Como criar predefinições
Ver artigo principal: Ajuda:Guia de edição/Como criar predefinições
Ver também
Última edição a 27 de novembro de 2021, às 20h45min
Wikipédia
Conteúdo disponibilizado nos termos da CC BY-SA 3.0, salvo indicação em contrário.
Política de privacidade
Condições de utilização
Versão desktop
InícioAleatório Aqui perto Entrar Definições DonativosSobre a WikipédiaAvisos gerais
LínguaVigiarEditar