Help:Magic words/pt-br

Palavras mágicas são palavras que o MediaWiki associa a um valor ou uma função a devolver como, por exemplo, uma hora, detalhes da instalação ou nomes de páginas. Esta página só descreve o uso das palavras mágicas padrão; para mais detalhes técnicos, consulte.

Existem três tipos gerais de palavras mágicas:


 * Modificadores comportamentais: normalmente palavras em maiúsculas, rodeadas por dois sublinhados, por exemplo:  .
 * Variáveis: estas são palavras em maiúsculas, rodeadas por chaves duplas, p.ex.  . Como tal, elas se parecem muito com as predefinições.
 * Funções do analisador sintático: estas recebem parâmetros e tomam a forma   ou  , ex. . Veja também  e.

Variáveis ​​e funções do analisador podem usar subst:, exatamente como as predefinições. Palavras mágicas dependentes de página afetarão ou retornarão dados sobre a página atual (por padrão), mesmo que a palavra seja adicionada através de um modelo de transcluídos ou incluído mensagens do sistema.

Comutadores de comportamento
Um modificador comportamental controla a disposição dos elementos na página ou o comportamento da própria página (se suportado pelo tema). São frequentemente usados para especificar inclusões ou omissões de certos elementos no conteúdo da página. Alguns não são suportados pelo tema Minerva.

Variáveis
As variáveis retornam informação sobre a página atual, a wiki ou a data. A sua sintaxe é semelhante às predefinições. As variáveis marcadas [exigente] são monitoradas pelo software, e a quantidade que pode ser incluída em uma página é limitada.

Se um nome de predefinição entra em conflito com uma variável, a variável será usada (assim para transcluír a predefinição    :PAGENAME você precisa escrever  ). Em alguns casos, a adição de parâmetros irá forçar o analisador para invocar uma predefinição; por exemplo,  transclui     :CURRENTDAYNAME, não a variável.

Data e hora
As seguintes variáveis retornam a data e hora atuais em UTC.

Devido ao MediaWiki e ao cache do browser, estas variáveis ​​freqüentemente mostram quando a página foi armazenada em cache em vez da hora atual.

O uso dessas variáveis faz com que páginas sejam armazenadas em cache por um número mais limitado de segundos. Isto é definido em MagicWordFactory.

As palavras mágicas de data e hora são formatadas no idioma de conteúdo wiki. Desde a revisão, elas dependem do idioma de conteúdo da página.

As seguintes variáveis fazem o mesmo que as anteriores, mas que utilizam configuração do servidor do site ou $manual-wg-localtimezone.



Para formatação de tempo mais completa ou para gerar o ano e a semana atuais com melhor conformidade com ISO-8601, você pode querer instalar para usar a a parser function #time.

Estatísticas
Os números retornados por estas variáveis normalmente contêm separadores decimais (vírgulas ou espaços, dependendo da língua local), mas podem retornar números sem qualquer separador adicionando a flag ":R" (por exemplo,  &rarr;  e   &rarr; ).

Use "|R" para palavras mágicas que requerem um parâmetro como PAGESINCATEGORY (por exemplo  e , ou   e  ). Também aplicável a  hereinbefore.

As palavras mágicas de data e hora são formatadas no idioma de conteúdo da wiki. Desde a revisão, elas dependem do idioma de conteúdo da página.

Nomes de páginas
Nenhum destes é afetado por alterações no título de exibição usando ; os valores retornados são o título da página original.

As palavras mágicas  e   só funcionam para espaços nominais nos quais foi possibilitado o uso de subpáginas. Consulte $manual-wg-ns-with-subpages para informação sobre como possibilitar o uso de subpáginas.

A partir de 1.15+, todas estas podem aceitar um parâmetro, que permite especificar a página sobre a qual devem operar, em vez da página atual apenas:


 * &rarr; 

Nomes de página com URL codificada
As seguintes variáveis são equivalentes codificados para uso em URLs do MediaWiki (ou seja, espaços substituídos por sublinhados e alguns caracteres HTML escaped using numeric character encoding):



Observe que,   e   têm implementações distintas. Consulte Manual:PAGENAMEE encoding para mais detalhes.

Namespaces
Os seguintes variáveis são equivalentes codificados para uso em URLs do MediaWiki (espaços substituídos por sublinhados e alguns caracteres codificados por percentagem):



A partir de 1.15+, todas estas aceitam um parâmetro com o nome completo de uma página, e retornam o domínio associado a essa página e não à página atual:

O parâmetro não deve ser um nome de namespace:
 * &rarr; 
 * &rarr;  (Pages in main space will return empty)
 * &rarr; 
 * &rarr; 
 * &rarr; 
 * &rarr; 
 * &rarr;   (Empty)

Funções do analisador sintático
As funções do analisador sintático são muito parecidas com as variáveis, mas aceitam um ou mais parâmetros (tecnicamente, qualquer palavra mágica que aceita um parâmetro é uma função do analisador sintático) e o seu nome é por vezes precedido por um símbolo de cardinal para distingui-las das predefinições.

Esta página descreve somente as funções do analisador sintático que estão integradas no software MediaWiki. Podem existir na sua wiki outras funções sintáticas, adicionadas por extensões do MediaWiki, tais como a extensão. Para mais detalhes, consulte.

Namespaces
retorna o nome localizado atual para o namespace com este índice, nome canônico ou alias local. Assim,,  , e   (um antigo nome para o namespace File) retornam "    ". Em uma wiki onde o idioma de conteúdo é o francês,  também é válido, mas   (a localização de "File" em alemão) não é.

é o equivalente codificado para URLs do MediaWiki. Ele faz o mesmo, mas ele substitui os espaços com sublinhados, tornando-o utilizável em links externos.

Não confundir namespaces localizados com namespaces personalizados.

Formatação
Ver também:.

Localização
Aqui estão as palavras mágicas que são utilizadas como ferramentas de localização principais. Outras palavras mágicas, muitas vezes, dependem da localidade e da configuração da wiki ou do idioma escolhido: ver em particular #Data e hora, #Formatação, #Diversos. Mais palavras mágicas são adicionadas pela extensão.

O uso dessas palavras mágicas pode ser muito complexo, e a documentação é atualmente incompleta; há mais algumas informações sobre PLURAL, GRAMÁTICA, GÊNERO.

Modificadores de transclusão
normalmente transclui a página nomeada, por omissão a partir do espaço nominal Predefinição:. Estas palavras mágicas modificam esse comportamento.