Usuário:Leone Melo/Testes/Predefinições

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

Criação

As predefinições devem ser criadas com o prefixo Predefinição:, que no caso seria seu espaço de nomes (do inglês namespace) da página, seguida 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 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

{{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 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

{{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

{{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

{{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 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

{{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

{{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 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

{{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 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

{{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 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

{{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

{{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 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

{{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

{{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|}}} }}}.

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 {{Lpp|nome da predefinição|parâmetro1|parâmetro2|...}}. Exemplo:

Código: {{Lpp|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 {{Lpu|nome da página (com o prefixo)}}. Exemplo:

Código: {{Lpu|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}}	H₂O
	{{chem\|Cr\|O\|4\|2-}}	CrO2− 4
	{{chem\|Ag\|Cl\|2\|-}}	AgCl− 2
chem2	{{chem2\|H2O}}	H 2O
	{{chem2\|CrO4(2-)}}	CrO2– 4
	{{chem2\|AgCl2(-)}}	AgCl– 2

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>.

Ela 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.

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 é representado pela meia-risca ("–") em vez do hífen ("-").

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

Uso

Criação

Parâmetros

Parâmetros anônimos

Parâmetros numerados

Parâmetros nomeados

Valores padrões (default)

Parâmetros alternativos

Citação em um texto

Predefinições úteis

Química

Matemática

Ver também