Help:Palavras mágicas

Nota: Ao editar esta página, você concorda em publicar a sua contribuição no âmbito da licença CC0. Veja as páginas de ajuda do domínio público para mais informações. Editar · Traduções

Magic words are strings of text that MediaWiki associates with a return value or function, such as time, site details, or page names. This page explains only the standard magic words; for a technical reference, see Manual:Magic words.

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. {{FOO}}. 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 {{foo:...}} ou da forma {{#foo:...}}. Veja também Help:Extensão:ParserFunctionsHelp:Extension:ParserFunctions.

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 Template:PAGENAME você precisa escrever {{Template:PAGENAME}}). Em alguns casos, a adição de parâmetros irá forçar o analisador para invocar uma predefinição; por exemplo, {{CURRENTDAYNAME|x}} transclui Template: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 1.19, 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.

• {{LOCALYEAR}}
• {{LOCALMONTH}}
• {{LOCALMONTH1}}
• {{LOCALMONTHNAME}}
• {{LOCALMONTHNAMEGEN}}
• {{LOCALMONTHABBREV}}
• {{LOCALDAY}}
• {{LOCALDAY2}}
• {{LOCALDOW}}
• {{LOCALDAYNAME}}
• {{LOCALTIME}}
• {{LOCALHOUR}}
• {{LOCALWEEK}}
• {{LOCALTIMESTAMP}}

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

Metadados técnicos

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, {{NUMBEROFPAGES}} → 507 038 e {{NUMBEROFPAGES:R}} → 507038).

Use "|R" para palavras mágicas que requerem um parâmetro como PAGESINCATEGORY (por exemplo {{PAGESINCATEGORY:Help}} e {{PAGESINCATEGORY:Help|R}}, ou {{PAGESINCATEGORY:Help|subcats}} e {{PAGESINCATEGORY:Help|subcats|R}}). Também aplicável a {{PAGESIZE:nome da página}} hereinbefore.

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

Nomes de páginas

As palavras mágicas {{BASEPAGENAME}} e {{SUBPAGENAME}} só funcionam em namespaces que têm subpáginas habilitadas. Consulte $wgNamespacesWithSubpages para obter informações sobre como habilitar subpáginas.

Desde a revisão 1.15+, essas variáveis ​​podem ter um parâmetro, o que permite a especificação da página a ser operada, em vez de apenas a página atual:

• {{PAGENAME:Template:Main Page}} → Main Page

Atenção: Page titles containing certain characters, such as apostrophes ' or asterisks *, may produce unexpected results when handled with these magic words, e.g. {{PAGESINCATEGORY:{{PAGENAME}}}}. See bugs T16779, T18474, T37628, and T37746. One simple way to fix this is wrapping the pagename in {{#titleparts:}} from the ParserFunctions extension.

Por exemplo, se o nome da página for "L'Aquila", o seguinte código produzirá a string "Numeric char encoding":

{{#switch:{{PAGENAME}}
| L'Aquila = No translation
| L = Not OK
| L'Aquila = Entity escaping
| L'Aquila = Numeric char encoding
}}

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):

• {{FULLPAGENAMEE}}
• {{PAGENAMEE}}
• {{BASEPAGENAMEE}}
• {{SUBPAGENAMEE}}
• {{SUBJECTPAGENAMEE}}
• {{ARTICLEPAGENAMEE}}
• {{TALKPAGENAMEE}}
• {{ROOTPAGENAMEE}}

Observe que {{PAGENAME:...}}, {{PAGENAMEE:...}} e {{urlencode:...}} 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):

• {{NAMESPACEE}}
• {{SUBJECTSPACEE}}
• {{ARTICLESPACEE}}
• {{TALKSPACEE}}

Desde o MediaWiki 1.15+, estas variáveis podem ter um parâmetro "nome completo de página" e retornarão o namespace solicitado associado a essa página, em vez da página atual:

• {{NAMESPACE:Template:Main Page}} → Template
• {{SUBJECTSPACE:Template:Main Page}} → Template
• {{TALKSPACE:Template:Main Page}} → Template talk

O parâmetro não deve ser um nome de namespace:

• {{SUBJECTSPACE:Help talk}} →   (Empty)

Outros

Funções do analisador sintático

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.

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 Extensão:ParserFunctionsExtension:ParserFunctions. Para mais detalhes, consulte Help:Extensão:ParserFunctionsHelp:Extension:ParserFunctions.

Metadados técnicos de outra página

Dados da URL

Função do analisador sintático	Entrada → Saída	Descrição	Versões
{{localurl:page name}} {{localurl:page name|query_string}}	{{localurl:MediaWiki}} → /wiki/MediaWiki {{localurl:MediaWiki|printable=yes}} → /w/index.php?title=MediaWiki&printable=yes	Endereço relativo para o título
{{fullurl:page name}} {{fullurl:page name |query_string}} {{fullurl:interwiki:remote page name |query_string}}	{{fullurl:Category:Top level}} → //www.mediawiki.org/wiki/Category:Top_level {{fullurl:Category:Top level|action=edit}} → //www.mediawiki.org/w/index.php?title=Category:Top_level&action=edit https:{{fullurl:s:Electra|action=edit}} → https:https://en.wikisource.org/wiki/Electra?action=edit https:{{fullurl:s:es:Electra|action=edit}} → https:https://en.wikisource.org/wiki/es:Electra?action=edit	Um caminho de protocolo relativo ao título. Isso também irá resolver prefixos interwiki.  Nota: Links de protocolo relativo sem parênteses não são automagicamente linkados.	≥ 1.5
{{canonicalurl:page name}} {{canonicalurl:page name |query_string}} {{canonicalurl:interwiki:remote page name |query_string}}	{{canonicalurl:Category:Top level}} → https://www.mediawiki.org/wiki/Category:Top_level {{canonicalurl:Category:Top level|action=edit}} → https://www.mediawiki.org/w/index.php?title=Category:Top_level&action=edit	O caminho absoluto para o título, usando a URL canônica. Isso também irá resolver prefixos interwiki.	≥ 1.18
{{filepath:file name}} {{filepath:file name|nowiki}} {{filepath:file name|thumbnail_size}}	{{filepath:Wiki.png}} → //upload.wikimedia.org/wikipedia/mediawiki/b/bc/Wiki.png {{filepath:Wiki.png|nowiki}} → //upload.wikimedia.org/wikipedia/mediawiki/b/bc/Wiki.png {{filepath:Example.svg|300}} → //upload.wikimedia.org/wikipedia/commons/thumb/8/84/Example.svg/300px-Example.svg.png	Um caminho de protocolo relativo ao tamanho completo ou miniatura (versão 1.18+) de um arquivo de mídia.	≥ 1.12 r25854 ≥ 1.18 r80813
{{urlencode:string}} ou {{urlencode:string|QUERY}} {{urlencode:string|WIKI}} {{urlencode:string|PATH}}	{{urlencode:x:y/z á é}} or {{urlencode:x:y/z á é|QUERY}} → x%3Ay%2Fz+%C3%A1+%C3%A9 {{urlencode:x:y/z á é|WIKI}} → x:y/z_%C3%A1_%C3%A9 {{urlencode:x:y/z á é|PATH}} → x%3Ay%2Fz%20%C3%A1%20%C3%A9 Observe que o padrão mudou de |WIKI para |QUERY na versão 1.17; isso pode quebrar predefinições que contam com essa função.	A entrada codificada para uso em URLs. Observe que não há nenhuma função urldecode como a que existe na extensão obsoleta Extension:StringFunctionsExtension:StringFunctions.. Decodificação código espaço  none  +  QUERY  +   WIKI  _   PATH %20	≥ 1.7 r14273 (or ≥ 1.17 r64726 ≥ 1.17 r64726 ≥ 1.17 r64726 )
{{anchorencode:string}}	{{anchorencode:x y z á é}} → x_y_z_.C3.A1_.C3.A9	A entrada codificada para utilização nas âncoras da seção URL (após o símbolo hashtag “#” em uma URL).	≥ 1.6 r16279

Namespaces

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

{{nse:}} é 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: Extension:StringFunctionsExtension:StringFunctions.

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 Extensão:TranslateExtension:Translate.

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

{{Page name|optional params}} usually transcludes another page, by default from the Template:namespace. Estas palavras mágicas modificam esse comportamento.

Diversos