Manual do Leone/Módulo 5

As predefinições são páginas que contém um texto predefinido, isto é, feito para ser reutilizado por outras páginas sem a necessidade de ser copiado manualmente em cada uma delas.

Uso

Elas podem ser usadas para formatar um texto assim como as tags. No entanto, com as predefinições conseguimos escrever um código grande e complexo, que não vai aparecer no código-fonte do verbete, mas sim em outra página. Desse modo, evitamos que esse código polua o código-fonte do verbete e nos permitem usá-las em diversas páginas.

Estilização com predefinições

Nome	Conteúdo do código-fonte		Mostrado na tela
	Tag	Predefinição
Monoespaçado	Ele é <kbd>culpado</kbd>	Ele é {{Kbd|culpado}}	Ele é culpado
	Ele é <span style="font-family:monospace;">culpado</span>	Ele é {{Mono|culpado}}	Ele é culpado
Sobrescrito	10<sup>23</sup>	10{{Exp|23}}	1023
	10<span style="vertical-align:super; font-size:80%;">23</span>
Pequeno	Fluminense <small>(campeão)</small>	Fluminense {{Pequeno|(campeão)}}	Fluminense (campeão)
	Fluminense <span style="font-size:smaller;">(campeão)</span>
Grande	Vi uma <big>barata</big>	Vi uma {{Grande|barata}}	Vi uma barata
	Vi uma <span style="font-size:larger;">barata</span>
Cores	Trinta <span style="background:black; color:white;">candidatos</span>	Trinta {{Font color|white|black|candidatos}}	Trinta candidatos

Criação

A conteúdo da predefinição B foi transcluído na página A.

As predefinições devem ser criadas com o prefixo Predefinição:, que no caso seria o domínio da página, seguido do nome escolhido. Por exemplo, vamos considerar a criação da página "Predefinição:Manual" com o seguinte conteúdo:

O que colocamos na página fonte (predefinição)

Olá, este é o manual de edições avançadas do Leone.

Para usar uma predefinição em um artigo, você deve colocar o nome da predefinição dentro de chaves duplas, isto é, {{ }}. Não deve-se colocar o prefixo Predefinição: entre as chaves duplas. Você só deve colocar esse prefixo para criar a predefinição ou encontrá-la na barra de pesquisa.

Assim, ao colocar {{Manual}} em qualquer outra página, vai aparecer Olá, seja bem-vindo à página de dicas do Leone. em vez de {{Manual}}. Podemos dizer que o conteúdo for transcluído para dentro de outra página.

O que colocamos na página alvo

{{Manual}}

O que é mostrado na tela

Olá, seja bem-vindo à página de dicas do Leone.

Parâmetros

Os parâmetros permitem que a predefinição forneça resultados diferente ou se comporte de maneiras diversas. Dentro da página da predefinição, os parâmetros são identificados entre chaves triplas, isto é, {{{ }}}. Dentro dessas chaves triplas, você deve colocar o nome do parâmetro, que pode ser um número ou uma palavra.

Agora vamos imaginar a criação de uma predefinição chamada "Agradecimento", ou seja, "Predefinição:Agradecimento". O conteúdo dela vai ser o seguinte:

O que colocamos na página fonte (predefinição)

Quero te agradecer... {{{1}}}. Obrigado, {{{2}}}.

Nas páginas onde a predefinição é transcluída, eles devem ser separados por uma barra vertical (|). Os parâmetros são passados às predefinições de três formas: de forma anônima, numerada e nomeada.

Parâmetros anônimos

Os parâmetros anônimos também são conhecidos como parâmetros posicionais. Eles seguem a seguinte estrutura dentro do artigo em que as predefinições são colocadas (onde elas são transcluídas):

{{Nome da predefinição| parâmetro1 | parâmetro2 |...}}

Assim, podemos usar a nossa predefinição na página onde o conteúdo é transcluído do seguinte modo:

O que colocamos na página alvo

{{Agradecimento|por pintar meu carro|Juvenal}}

O que é mostrado na tela

Quero te agradecer... por pintar meu carro. Obrigado, Juvenal.

A ordem é essencial nesse caso. O conteúdo que estiver logo à direita da primeira barra, vai ser atribuído ao primeiro parâmetro, já o conteúdo que estiver à direita da segunda barra, vai ser atribuído ao segundo parâmetro, ou seja, {{{1}}} = por pintar meu carro e {{{2}}} = Juvenal. Então se a gente inverter a ordem, vamos obter

O que colocamos na página alvo

{{Agradecimento|Juvenal|por pintar meu carro}}

O que é mostrado na tela

Quero te agradecer... Juvenal. Obrigado, por pintar meu carro.

Ao invertermos as posições, a atribuição de parâmetros se deu da seguinte forma: {{{1}}} = Juvenal e {{{2}}} = por pintar meu carro.

Se nós nomeássemos os parâmetros com nomes (exemplo: {{{motivo}}} e {{{pessoa}}}) em vez de números ({{{1}}} e {{{2}}}), não iria funcionar nesse caso.

Parâmetros numerados

Podemos passar parâmetros por número, identificando o número de cada parâmetro ao passá-lo. Os números farão o papel de chave. Segue-se a seguinte estrutura:

{{Nome da predefinição|1 = parâmetro1|2 = parâmetro2|...}}

que produz resultado equivalente a

{{Nome da predefinição|2 = parâmetro2|1 = parâmetro1|...}}

Aplicando na nossa predefinição, vamos obter

O que colocamos na página alvo

{{Agradecimento|1=por me emprestar um dinheiro|2=Djalma}}

ou

{{Agradecimento|2=Djalma|1=por pintar meu carro}}

O que é mostrado na tela

Quero te agradecer... por me emprestar um dinheiro. Obrigado, Djalma.

Tanto o que foi apresentado no código de cima quanto o que foi mostrado no código de baixo produzem o mesmo resultado. A ordem mostrada não importa neste caso, pois atribuição vai ser sempre {{{1}}} = por me emprestar um dinheiro e {{{2}}} = Djalma.

Parâmetros nomeados

Os parâmetros nomeados seguem a seguinte forma:

{{Nome da predefinição|nomedoparâmetro1 = parâmetro1|nomedoparâmetro2 = parâmetro2|...}}

sendo nomedoparâmetro1 e nomedoparâmetro2 as chaves.

Dessa maneira, o nosso código deve ser mudado na página da predefinição, isto é,

O que colocamos na página fonte (predefinição)

Quero te agradecer... {{{motivo}}}. Obrigado, {{{pessoa}}}.

Agora, na página em que a predefinição é transcluída, temos que identificar o nome de cada parâmetro ao passá-lo, ou seja,

O que colocamos na página alvo

{{Agradecimento|motivo=por cuidar da minha filha|pessoa=Lindalva}}

ou

{{Agradecimento|pessoa=Lindalva|motivo=por cuidar da minha filha}}

O que é mostrado na tela

Quero te agradecer... por cuidar da minha filha. Obrigado, Lindalva.

Assim como o caso anterior, a ordem não importa, e o que foram mostrados no código de cima e no código de baixo resultam no mesmo resultado, de modo que {{{motivo}}} = por cuidar da minha filha e {{{pessoa}}} = Lindalva.

Para facilitar a leitura do código, podemos colocar as instruções em linhas diferentes, o que não muda em nada o resultado na tela. No entanto, é importante destacar que letras minúsculas e maiúsculas são interpretadas de modo diferente (case-sentive). Assim,

O que colocamos na página alvo

{{Agradecimento
 |pessoa = Dalila
 |Motivo = por tosar o meu cão
 |motivo = por alimentar o meu gato
}}

O que é mostrado na tela

Quero te agradecer... por alimentar o meu gato. Obrigado, Dalila.

Isso ocorreu pois definimos o parâmetro como {{{motivo}}} na página da predefinição, e não como {{{Motivo}}}.

Valores padrões (default)

Se nós não colocarmos parâmetros, a predefinição mostra os próprios parâmetros em vez de seus respectivos valores, uma vez que eles não foram passados. Assim, considerando o caso dos parâmetros nomeados, isto é,

O que colocamos na página fonte (predefinição)

Quero te agradecer... {{{motivo}}}. Obrigado, {{{pessoa}}}.

Vamos obter na página onde o conteúdo é transluído a seguinte configuração

O que colocamos na página alvo

{{Agradecimento}}

O que é mostrado na tela

Quero te agradecer... {{{motivo}}}. Obrigado, {{{pessoa}}}.

Para evitar que isso ocorra, podemos colocar uma barra vertical (|) à direita do nome do parâmetro na página da predefinição, de modo que não retorne nada caso o parâmetro não seja definido.

O que colocamos na página fonte (predefinição)

Quero te agradecer... {{{motivo|}}}. Obrigado, {{{pessoa|}}}.

Desta forma, não é passado nada caso os parâmetros não sejam declarados na página, ou seja,

O que colocamos na página alvo

{{Agradecimento}}

O que é mostrado na tela

Quero te agradecer... . Obrigado, .

Outra solução seria atribuir valores padrões para os parâmetros, ou seja, valores que são atribuídos aos parâmetros em caso de omissão. Eles são colocados após a barra vertical (|), isto é,

O que colocamos na página fonte (predefinição)

Quero te agradecer... {{{motivo|por me ajudar}}}. Obrigado, {{{pessoa|amigo}}}.

Desse modo, caso os parâmetros sejam omitidos, os valores definidos após a barra vertical, que são os valores padrões (default), são mostrados no lugar. Portanto, vamos obter

O que colocamos na página alvo

{{Agradecimento}}

O que é mostrado na tela

Quero te agradecer... por me ajudar. Obrigado, amigo.

Contudo, se a gente atribuir valores aos parâmetros, esse valores vão sobrescrever os valores padrões, ou seja,

O que colocamos na página alvo

{{Agradecimento
 |motivo = por dançar comigo
 |pessoa = Lucileide
}}

O que é mostrado na tela

Quero te agradecer... por dançar comigo. Obrigado, Lucileide.

Parâmetros alternativos

Pode ser interessante usarmos nomes alternativos para os parâmetros. Assim, um valor específico pode atribuído a um certo parâmetro em quaisquer das formas alternativas definidas.

Para colocarmos um nome alternativo, devemos colocá-lo dentro das chaves triplas da primeira forma do parâmetro, ou seja, {{{ }}}, e à direita da barra vertical. E esse parâmetro alternativo também deve estar entre chaves triplas, e de preferência com uma barra vertical à direita para evitar os problemas em caso de omissão das duas formas.

O que colocamos na página fonte (predefinição)

Quero te agradecer... {{{motivo|{{{razão|}}} }}}. Obrigado, {{{pessoa|}}}.

O sistema busca o valor atribuído ao primeiro parâmetro, caso não exista, ele busca no segundo parâmetro, e assim por diante. Então, poderíamos colocar mais parâmetros alternativos, que seguiriam essa lógica.

O que colocamos na página alvo

{{Agradecimento
 |motivo = por dançar comigo
 |pessoa = Dalila
 }}

ou

{{Agradecimento
 |razão = por dançar comigo
 |pessoa = Dalila
}}

O que é mostrado na tela

Quero te agradecer... por dançar comigo. Obrigado, Dalila.

As duas opções de código resultam no mesmo resultado. Não é necessário colocar o espaço entre as chaves triplas de fechamento, de modo que elas foram colocadas aqui para mostras as chaves triplas mais internas são da segunda forma alternativa, e as chaves triplas mais externas são da primeira forma definida. Caso valores diferentes sejam passados para valores alternativos, o valor correspondende à primeira forma definida na predefinição, isto é,

O que colocamos na página alvo

{{Agradecimento
 |razão = por lavar a minha casa
 |motivo = por cantar na minha festa
 |pessoa = Marinete
}}

O que é mostrado na tela

Quero te agradecer... por cantar na minha festa. Obrigado, Marinete.

Repare que a ordem colocada na página onde a predefinição é transcluída é irrelavante nesse caso. Para que a informação "por lavar a minha casa", ligada à chave "razão", aparecesse no caso acima, a definição na página da predefinição deveria ser {{{razão|{{{motivo|}}} }}} ao invés de {{{motivo|{{{razão|}}} }}}.

Transclusão parcial

Se nós pretendemos filtrar o que será transcluído para uma página, podemos fazer uso das tags de "includeonly", "onlyinclude" e "noinclude".

noinclude

O conteúdo dentro de noinclude não é transcluído para outra página, sendo visível apenas na página de origem. Na página da predefinição, a documentação e as categorias ficam entre essas tags.

Wikitexto da página de origem	O que aparece na página de origem	O que aparece na página de destino
Raimundo <noinclude>Nonato</noinclude>	Raimundo Nonato	Raimundo

includeonly

O conteúdo dentro de includeonly é transcluído para outra página, mas não fica visível na página de origem. Com essa marcação, nós podemos adicionar categorias para a página onde a predefinição será transcluída, sem que a predefinição propriamente dita seja categorizada dessa forma.

Wikitexto da página de origem	O que aparece na página de origem	O que aparece na página de destino
Raimundo <includeonly>Nonato</includeonly>	Raimundo	Raimundo Nonato

onlyinclude

O conteúdo dentro de onlyinclude é transcluído para outra página e também fica visível na página de origem. Essa marcação pode ser útil no caso em que se pretende aproveitar apenas um trecho de uma página em outro artigo.

Wikitexto da página de origem	O que aparece na página de origem	O que aparece na página de destino
Raimundo <onlyinclude>Nonato</onlyinclude>	Raimundo Nonato	Nonato

Substituição

Vamos imaginar que exista uma predefinição chamada Joinha, composta uma imagem de uma mão dando um joinha e um parâmetro numerado com o texto Tudo joinha! como valor padrão, isto é, se não passarmos nenhum valor, vai ser retornado Tudo joinha!. Se nós colocarmos {{Joinha}} no código da página alvo, salvarmos a página e depois formos conferir o que ficou salvo no código-fonte, vamos observar que consta {{Joinha}}, exatamente o que colocamos. Logo, se fizermos uma alteração na página fonte posteriormente, isso vai afetar o que é mostrado na tela da página alvo.

Sem subst

Domínio + Nome da predefinição	Predefinição:Joinha
Código na página fonte	[[Imagem:Symbol thumbs up.svg|20px]] {{{1|Tudo joinha!}}}
O que colocamos na página alvo	{{Joinha}}
Resultado na tela da página alvo	Tudo joinha!
O que fica salvo na página alvo	{{Joinha}}

Contudo, ao utilizarmos a substituição — feita por meio da sintaxe {{subst:Nome da predefinição}} — o resultado será diferente. Ao adicionarmos o subst: antes do nome da predefinição, como em {{subst:Joinha}}, e salvarmos a página, vamos notar que o que foi salvo no código-fonte da página alvo, foi o código que consta na página fonte (predefinição). Assim, alterações posteriores na página da predefinição não terão efeito sobre o conteúdo já salvo.

Uma aplicação do uso da substituição pode ser vista nas discusssões de artigos destacados e artigos bons (w:WP:EAD). Caso se utilize a transclusão normal para indicar uma posição e, mais tarde, ela seja alterada, o “voto” anterior continuará visível na coluna “Estado da candidatura”, mesmo que o comentário tenha sido riscado. Se outro editor respondeu ao comentário original, apagar esse comentário pode retirar a resposta de seu contexto. Nesses casos, o uso de subst: é recomendado, pois fixa o conteúdo e evita esse tipo de problema.

Usando subst

Domínio + Nome da predefinição	Predefinição:Joinha
Código na página fonte	[[Imagem:Symbol thumbs up.svg|20px]] {{{1|Tudo joinha!}}}
O que colocamos na página alvo	{{subst:Joinha}}
Resultado na tela da página alvo	Tudo joinha!
O que fica salvo na página alvo	[[Imagem:Symbol thumbs up.svg|20px]] {{{1|Tudo joinha!}}}

Transclusão de outras páginas

O domínio fonte não precisa ser necessariamente de predefinição, isto é, o conteúdo que será transcluído em uma página alvo pode ser originário de uma outra pagina que não seja uma predefinição.

Domínio principal

Se quisermos pegar o conteúdo de um verbete do domínio principal e transcluirmos em outra página, devemos usar a seguinte sintaxe: {{:Nome do verbete}}. No entanto, repetir todo o conteúdo de um artigo em outro, o artigo copiado perde o sentido de existir.

Transclusão de trechos

Uma das maneiras para transcluir apenas um trecho de um verbete, é colocar o conteúdo que você deseja transcluir dentro de onlyinclude. A limitação desse procedimento é que você só vai poder transcluir aquele trecho específico daquele verbete.

É possível transcluir seções, parágrafos ou trechos específicos usando a predefinição {{Excerto}}. O primeiro parâmetro passado é o nome do artigo, já o segundo pode ser o nome da seção, seguindo a seguinte estrutura: {{Excerto|Título da página|Título da seção}}.

Para transcluir apenas um trecho, podemos deixar o conteúdo que se deseja ser transcluído entre as tags <section begin=rótulo /> e <section end=rótulo />, de maneira que "rótulo" é a palavra que você colocar para indentificar esse trecho. Em um mesmo verbete, podemos colocar vários trechos entre essas tags, com rótulos diferentes, com a estrutura: {{Excerto|Título da página|Nome do rótulo}}.

A predefinição {{Excerto}} deixa um aviso que indica da origem do texto. Caso você não queira deixar esse aviso, você pode usar uma função sintática (parse function) chamada section na página de destino, algo que será abordado no módulo 6.

Citação em um texto

Para nós citarmos uma predefinição sem que o conteúdo dela apareça na página, temos que escrever {{Lp|nome da predefinição}}. Exemplo:

• Código: {{Lp|Sim 2}}
• Resultado: {{Sim 2}}

Caso a gente queira que os parâmetros apareçam, então temos que usar {{Tlp|nome da predefinição|parâmetro1|parâmetro2|...}}. Exemplo:

• Código: {{Tlp|data|ano|mês|dia}}
• Resultado: {{data|ano|mês|dia}}

Se nós quisermos fazer uma ligação semelhante de páginas que não são predefinições, ou seja, que não possuem o prefixo Predefinição:, temos que usar {{Tlx|nome da página (com o prefixo)}}. Exemplo:

• Código: {{Tlx|Wikipédia:Userbox/Rio de Janeiro}}
• Resultado: {{Wikipédia:Userbox/Rio de Janeiro}}

Predefinições úteis

Química

As predefinições {{chem}} e {{chem2}} são apropriadas para representar elementos químicos.

Nome	Aplicação	Resultado
chem	{{chem|H|2|O}}	H2O
	{{chem|Cr|O|4|2-}}	CrO42-
	{{chem|Ag|Cl|2|-}}	AgCl2-
chem2	{{chem2|H2O}}	H2O
	{{chem2|CrO4(2-)}}	CrO42-
	{{chem2|AgCl2(-)}}	AgCl2-

Matemática

A predefinição {{math}} é usada para escrever fórmulas matemáticas usando HTML ou wikitexto. Ao contrário da tag <math>, essa predefinição não aceita LaTeX. Ela é mais apropriada para escrever fórmulas mais simples em linha. Para fórmulas mais complexas, é preverível usar a tag <math>.

Ao contrário do que ocorre ao usarmos <math>, os espaços que a gente dá no código são contabilizados e o sinal de menos não é produzido pelo hífen ("-"), Na verdade, deve-se usar o sinal de menos ('−') que consta na aba "Matemática", que também pode ser produzido pelo código −. Vale notar que esse símbolo é diferente do meia-risca ('–'), que embora possua a mesma largura, o posicionamento dele é diferente. Enquanto o hífen e a meia-risca se posicionam na metade da altura de uma letra minúscula, o sinal de menos fica na metade da altura de um número.

Hífen	Meia-risca	Menos (html)
x - 3 = - 8	x – 3 = – 8	x − 3 = − 8

A predefinição {{math}} admite dois tipos de parâmetros: grande e tamanho. O parâmetro tamanho permite a alteração do tamanho da fonte se usarmos unidades de medidas válidas, mas se atribuímos um valor sem as unidades apropriadas de fonte, a fonte segue com o tamanho padrão. Já o parâmetro grande sempre atribui um valor de 165% para a fonte, qualquer que seja o valor que atribuímos para ele.

A barra horizontal ("|") e o sinal de igual ("=") são usados na sintaxe da predefinição. Assim, para escrevermos esses símbolos na equação, temos que usar a palavra mágica {{!}} e a predefinição {{=}}, respectivamente.

Aplicação	Resultado
{{math|x<sup>2</sup> + 3 {{=}} 1}}	x2 + 3 = 1
{{math|grande = 200%|x<sup>3</sup> − 3 {{=}} 2}}	x3 − 3 = 2
{{math|grande = arroz|x<sub>2</sub> + 1 {{=}} 0}}	x2 + 1 = 0
{{math|tamanho = 200%|x + 3x {{=}} 4x}}	x + 3x = 4x
{{math|tamanho = coentro|x<sup>2</sup> + 2 {{=}} y }}	x2 + 2 = y

Ver também

• Módulo 1
• Módulo 2
• Módulo 3
• Módulo 4
• Módulo 6
• Módulo 7