Usuário:Leone Melo/Testes/Parser

As palavras mágicas são aquelas reservadas pelo MediaWiki, o software usado pela Wikipédia, que fornecem instruções específicas para esse software. Há três tipos de palavras mágicas:

• Modificadores comportamentais (behavior switches);
• Funções sintáticas (parse functions);
• Variáveis (variables).

Os modificadores comportamentais ou behavior switches mudam o funcionamento da página em vez de retornar um valor. Na maioria dos casos é constituída por uma palavra em caixa alta entre duplos subtraços.

O índice de conteúdo, também conhecido como table of contents (TOC), mostra todas as seções e subseções (até o nível 6, o menor nível possível). Dos cinco temas (skins em inglês), quatro deles apresentam o índice de conteúdo no texto, e só aparecem quando há pelo menos quatro seções (contando com subseções de qualquer nível e com a predefinição {{referências}}). Por padrão, o índice aparece antes da primeira seção. Para forçarmos o aparecimento do índice com menos de quatro seções no local padrão, podemos usar __FORCETOC__.

Se desejarmos colocar o índice em um lugar diferente do padrão, devemos usar __TOC__, que faz o índice aparecer exatamente no local onde essa palavra mágica é inserida, independentemente do número seções preexistentes.

As palavras mágicas __FORCETOC__ e __TOC__ não funcionam com o tema Vector (2022), em que o índice de conteúdo fica fora do conteúdo do artigo e aparece com qualquer número de seções.

Também podemos omitir o índice de conteúdo por meio da palavra mágica __NOTOC__. Ela pode ser colocada em qualquer parte da página que vai apresentar o mesmo resultado. Ao contrário das outras duas palavras mencionadas anteriormente, o __NOTOC__ funciona em qualquer tema padrão.

As funções sintáticas ou funções parser são uma extensão do MediaWiki que permitem criar predefinições mais sofisticadas. Elas têm uma cerquilha (#) no início, possuindo a seguinte sintaxe:

{{#nome da função: argumento 1| argumento 2| argumento 3}}

A função #expr realiza operações matemáticas. Ela não funciona com strings.

{{#expr: expressão matemática }}

A precisão de números reais é de 13 casas decimais. Na matemática de "módulo" e "valor absoluto" são geralmente tratados como sinônimos. No entanto, na computação eles possuem significados diferentes. O "valor absoluto" continua significando o valor do número sem o sinal da frente. Já "módulo" significa o resto de uma divisão.

Nos países lusófonos, é usada a vírgula como separador decimal. No entanto, em computação é usado o ponto para isso.

O número após round indica quantos lugares à direita do decimal estão incluídos no arredondamento. Quando esse número após round é negativo, o arredondamento se dá para os números à esquerda do ponto, isto é, para a parte inteira. Esse arredondamento é feito para o número mais próximo.

Os ângulos das funções trigonométricas são expressos em radianos, sendo π rad = 180°.

Se a proposição é «verdadeira», então retorna 1. Se a proposição é «falsa», então retorna 0.

Quando operadores lógicos são usados, o número 0 significa um valor lógico «falso». Já qualquer outro número, positivo ou negativo, é interpretado como «verdadeiro», e retorna o valor 1.

Se a condição é uma string vazia ou consiste apenas de espaços em branco, então é considerada como «falsa», e a função retorna <senão texto>. Caso contrário, a função retorna <então texto>. O <senão texto> pode ser omitido; assim, se a condição for «falsa», a função devolve um texto vazio. Normalmente o parâmetro é passado na página em que o contéudo é transcluído.

{{#se: <condição> | <então texto> | <senão texto>}}

{{#if: <condição> | <então texto> | <senão texto>}}

Note que a função se não suporta sinais de "=" ou expressões matemáticas. {{#se: 1 = 2|sim|não}} irá devolver "sim", porque a string "1 = 2" não é vazia.

Essa função compara dois valores, que podem ser números ou strings, e retorna uma string se os valores foram equivalentes ou outra string se não forem equivalentes. Letras maiúsculas de letras minúsculas são interpretadas como diferentes (case-sentitive), assim como strings e números. Se <texto 1> for equivalente a <texto 2>, será mostrada a string <igual texto>. Caso <texto 1> seja interpretado como diferente de <texto 2>, vai retornar <não igual texto>.

{{#seigual: <texto 1> | <texto 2> | <igual texto> | <não igual texto>}}

{{#ifeq: <texto 1> | <texto 2> | <igual texto> | <não igual texto>}}

Esta função avalia se existe um erro na expressão, isto é, se é possível obter um resultado numérico. Se houver um erro em <expressão>, retorna <valor se verdadeiro>. Caso não haja erro, retorna <valor se falso>.

{{#seerro: <expressão> | <valor se verdadeiro> | <valor se falso> }}

{{#iferror: <expressão> | <valor se verdadeiro> | <valor se falso> }}

Como não há um erro na expressão {{#expr: 3 + 2}}, isto é, é possível extrair um resultado dessa expressão, vai retornar Falso. Já a {{#expr: x + 2}} retorna um erro, então retorna Verdadeiro. Se um

{{#seexpr: <expressão> | <então texto> | <senão texto>}}

{{#ifexpr: <expressão> | <então texto> | <senão texto>}}

Se não escrevermos as opções após a barra, dá um resultado vazio (independentemente se a expressão é verdadeira ou não). A exceção é quando há uma expressão inválida.

Se a expressão calculada resulta em um resultado vazio (que é diferente do número 0), então é mostrado o <senão texto>. Caso a expressão calculada dê qualquer outro valor, independentemente se a expressão é correta ou não, resulta é mostrado o <então texto>.

{{#se: {{#seexpr: <expressão> | <então texto> | <senão texto>}} }}

{{#if: {{#ifexpr: <expressão> | <então texto> | <senão texto>}} }}

Se existir uma página na Wikipédia lusófona com o nome igual ao que consta em <nome do artigo>, retorna <existe o artigo>. Caso não exista uma página com esse nome, retorna <não existe o artigo>.

{{#seexiste: <nome do artigo> | <existe o artigo> | <não existe o artigo> }}

{{#ifexxist: <nome do artigo> | <existe o artigo> | <não existe o artigo> }}

Essa função compara o <valor de comparação> com o <valor1>, <valor2>, etc. Se o <valor de comparação> for igual ao <valor1>, será mostrado <resultado1>, se for igual ao <valor2>, será mostrado <resultado2>, e assim diante. Se o <valor de comparação> não for igual a nenhum dos valores, será mostrado o <resultado padrão>, que é colocado por último.

{{ #switch: <valor de comparação> | <valor1> = <resultado1> | <valor2> = <resultado2> | ... | <valorn> = <resultadon> | <resultado padrão>}}

A análise é feita da esquerda para a direita. O primeiro valor igual é mostrado na tela. É case-sensitive.

Esse tipo palavra mágica retorna um valor relacionado com a página atual ou com a data atual. A sintaxe é semelhante ao de uma predefinição, mas a função é diferente. Por exemplo, as variáveis não possuem uma página onde fica disponível um código que pode ser editado pelos usuários da Wikipédia.

Esta é a subpágina {{SUBPAGENAME}} da página {{PAGENAME}}, do usuário {{ROOTPAGENAME}}. O domínio desta página é {{NAMESPACE}}, em que seu número associado é {{NAMESPACENUMBER}}. Já o nome completo, com o domínio e nome da página é {{FULLPAGENAME}}.

Hoje é {{CURRENTDAYNAME}}, dia {{CURRENTDAY}} de {{CURRENTMONTHNAME}} de {{CURRENTYEAR}}.

Olá, o endereço URL da {{SITENAME}} é https:{{SERVER}}. O endereço URL da minha página de usuário é https:{{fullurl:Usu%C3%A1rio:Leone_Melo}}.

O comando {{ns:}}, juntamente com um número inteiro específico ou com o nome do domínio em inglês, retorna o nome do domínio em português na Wikipédia.

• Layout
• Tabelas
• Ambiente matemático
• Predefinições