Help:Magic words/pt

= Palavras mágicas = Palavras mágicas sao palavras as quais o MediaWiki associa um valor de retorno como, por exemplo, uma hora, detalhes da instalaçao ou nomes de páginas. Esta página descreve o uso das palavras mágicas padrao; para mais detalhes técnicos, consulte.

Existem tres grupos de palavras mágicas:
 * Modificadores comportamentais: palavras em maiúsculas, rodeadas por dois sublinhados, tais como:  __EXEMPLO__ .
 * Variáveis: palavras em maiúsculas, rodeadas por duas chavetas, tais como:  . Por terem esta forma, sao muito parecidas com predefiniçoes.
 * Funçoes do analisador sintáctico: recebem parâmetros e tomam a forma   ou   . Consulte também.

As palavras mágicas relacionadas com páginas, afectam ou retornam dados acerca da página corrente (por omissao) onde estao, mesmo que provenham de uma predefiniçao (que tenha sido transcluída nessa página) ou de uma mensagem de sistema (que tenha sido incluída na página).

Modificadores comportamentais
Os modificadores comportamentais controlam a disposiçao dos elementos ou o comportamento da página. Sao frequentemente usados para especificar a inclusao ou omissao de certos elementos no conteúdo da página.

Variáveis
As variáveis retornam informaçao acerca da página corrente, acerca da wiki ou acerca da data. A sua sintaxe é semelhante as predefiniçoes. As variáveis marcadas [exigente] sao exigentes em termos de recursos e tem impacto no desempenho. Por isso, o MediaWiki monitoriza o número de vezes que sao usadas em cada página, e impoe um limite a este número.

Se o nome de uma predefiniçao entrar em conflito com o nome de uma variável, será usada a variável. Por exemplo, se criar uma predefiniçao de nome    :PAGENAME e a transcluir usando   , está a transcluir a variável e nao a predefiniçao. Para transcluir a predefiniçao, inclua o nome do espaço nominal na tranclusao, assim:  .

Nalguns casos, se forem usados parâmetros, o analisador sintáctico é forçado a tratar uma variável como uma predefiniçao. Por exemplo, o código  Tuesday  transclui a predefiniçao  </tt> e nao a variável.

Data e hora
As seguintes variáveis retornam a data e hora presente, em UTC. No entanto, devido as caches do MediaWiki e do browser, estas variáveis apresentam frequentemente a hora a que a página foi colocada na cache e nao a hora presente. Portanto, ao utilizá-las, nao assuma que apresentam sempre a hora actualizada.

As seguintes variáveis tem a mesma funçao que as da tabela acima, mas usam a zona horária configurada no servidor com $wgLocaltimezone</tt>:
 *  2024 </tt> › 2024
 *  August </tt> › August
 *  </tt> ›
 *  </tt> ›
 *  </tt> ›
 *  27 </tt> › 27
 *  </tt> ›
 *  </tt> ›
 *  Tuesday </tt> › Tuesday
 *  </tt> ›
 *  </tt> ›
 *  </tt> ›
 *  </tt> ›

Metadados técnicos
As variáveis relacionadas com revisoes de páginas, retornam dados acerca da última ediçao da página corrente, mesmo que se esteja a visionar uma ediçao anterior da página.

Estatísticas
Os números retornados por estas variáveis normalmente contem separadores decimais (vírgulas ou espaços, dependendo da língua local), mas podem retornar números sem qualquer separador adicionando o sufixo «:R</tt>»; por exemplo, <tt> </tt> ›  e <tt>  </tt> ›. Nas palavras mágicas que requerem um parâmetro, como <tt> </tt>, adicione o parâmetro «<tt>|R</tt>»; por exemplo, <tt>  </tt> ›  e <tt>  </tt> ›.

Nomes das páginas
As palavras mágicas <tt> </tt> e <tt>  </tt> só funcionam para espaços nominais nos quais foi possibilitado o uso de subpáginas.

As seguintes variáveis sao equivalentes as da tabela acima, mas o valor retornado pode ser usado em URLs do MediaWiki (isto é, espaços sao substituídos por sublinhados e alguns caracteres recebem uma codificaçao com percentagem):
 * <tt> </tt> ›
 * <tt> </tt> ›
 * <tt> </tt> ›
 * <tt> </tt> ›
 * <tt> </tt> ›
 * <tt> </tt> ›
 * <tt> </tt> ›

Desde o MediaWiki, todas estas variáveis aceitam um parâmetro, que permite especificar a página sobre a qual devem operar, em vez da página corrente; por exemplo: <tt> </tt> ›.

Espaços nominais
As seguintes sao equivalentes mas retornam valores codificados para uso em URLs do MediaWiki (isto é, espaços sao substituídos por sublinhados e alguns caracteres recebem uma codificaçao com percentagem):
 * <tt> </tt> ›
 * <tt> </tt> ›
 * <tt> </tt> ›
 * <tt> </tt> ›

Desde o MediaWiki, todas estas variáveis aceitam um parâmetro, que permite especificar a página sobre a qual devem operar, em vez da página corrente; por exemplo:
 * <tt> </tt> ›
 * <tt> </tt> ›
 * <tt> </tt> ›

Funçoes do analisador sintáctico
As funçoes do analisador sintáctico sao 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çao do analisador sintáctico) e o nome é por vezes precedido por um símbolo de cardinal «<tt>#</tt>» para distingui-las das predefiniçoes.

Esta página descreve somente as funçoes do analisador sintáctico que estao integradas no programa MediaWiki. Podem existir na sua wiki outras funçoes sintácticas adicionais, se tiver sido instalada a extensao. Para mais detalhes sobre estas funçoes adicionais, consulte Extensao:Parser functions.

Espaços nominais
<tt>     </tt> retorna o nome localizado do espaço nominal com o índice especificado.

<tt> </tt> é o equivalente codificado para uso em URLs do MediaWiki (isto é, espaços sao substituídos por sublinhados e alguns caracteres recebem uma codificaçao com percentagem.

Ver também

 * Extensao:ParserFunctions, funçoes adicionais do analisador sintáctico.