Help:Magic words/pt-br

Palavras mágicas são sequências de texto que o MediaWiki associa com um valor de retorno ou função, como tempo, detalhes do site ou nomes de página. Esta página é sobre o uso de palavras mágicas padrão; para uma referência técnica, veja.

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


 * Comutadores de comportamento: estas são palavras em maiúsculas, rodeadas por sublinhados duplos, p.ex. __FOO__.


 * 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 funções usam parâmetros e se apresentam da forma   ou da forma  . Veja também.

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 comutador de comportamento controla o layout ou o comportamento da página e muitas vezes pode ser usado para especificar omissões e inclusões desejados no conteúdo.

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.

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

Para uma formatação de tempo mais completa, você pode querer instalar Extension:ParserFunctions para usar #time parser function.

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  and , 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
The  and   magic words only work in namespaces that have subpages enabled. See for information on enabling subpages.

As of, these can all take a parameter, allowing specification of the page to be operated on, instead of just the current page:
 * &rarr; 

For example, if page name is "L'Aquila", the following code will produce the string "Numeric char encoding":

Nomes de página com URL codificada
The following are equivalents encoded for use in MediaWiki URLs (i.e. spaces replaced with underscores and some characters HTML escaped using numeric character encoding):



Note that,   and   have distinct implementations. See Manual:PAGENAMEE encoding for details.

Namespaces
The following are equivalents encoded for use in MediaWiki URLs (spaces replaced with underscores and some characters percent-encoded):



As of, these can take a full-page-name parameter and will return the requested namespace associated with that page, instead of with the current page:

Parameter must not be a namespace name:
 * &rarr; 
 * &rarr; 
 * &rarr; 
 * &rarr;   (Empty)

Parser functions
Parser functions are very similar to variables, but take one or more parameters (technically, any magic word that takes a parameter is a parser function), and the name is sometimes prefixed with a hash to distinguish them from templates.

This page only describes parser functions that are integral to the MediaWiki software. Other parser functions may be added by MediaWiki extensions such as the. For those see Help:Extension:ParserFunctions.

Namespaces
returns the current localized name for the namespace with that index, canonical name, or local alias. Thus,  , and   (an old name for the File namespace) all return "    ". On a wiki where the content language is French,  is also valid, but   (the localisation of "File" in German) is not.

is the equivalent encoded for MediaWiki URLs. It does the same, but it replaces spaces with underscores, making it usable in external links.

Don't confuse localised namespaces with custom namespaces.

Formatting
See also: Extension:StringFunctions.

Localização
Here are the magic words which are used as main localisation tools. Other magic words will often depend on the wiki's locale and configuration or on the chosen language: see in particular, ,. More magic words are added by the Translate extension.

The usage of these magic words can be very complex, and the documentation is currently incomplete; there's some more info on PLURAL, GRAMMAR, GENDER.