Mudanças entre as edições de "Ajuda:Magic words/pt-br"

Edição atual tal como às 09h14min de 19 de novembro de 2014

<languages /> Predefinição:TOCRight {{#invoke:Template translation|renderTranslatedTemplate|uselang=|namespace=|template=PD Help Page|noshift=}} 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 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 Predefinição:Ll.

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.

Predefinição:Anchor

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.

Predefinição:Anchor

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 Predefinição:PAGENAME você precisa escrever {{Predefinição: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 Predefinição:CURRENTDAYNAME, não a variável.

Predefinição:Anchor

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 Predefinição:R, 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}}
• {{LOCALMONTHNAME}}
• {{LOCALMONTHNAMEGEN}}
• {{LOCALMONTHABBREV}}
• {{LOCALDAY}}
• {{LOCALDAY2}}
• {{LOCALDOW}}
• {{LOCALDAYNAME}}
• {{LOCALTIME}}
• {{LOCALHOUR}}
• {{LOCALWEEK}}
• {{LOCALTIMESTAMP}}

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

Metadados técnicos

Predefinição:Note/pt-br

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}} → 4 933 e {{NUMBEROFPAGES:R}} → 4933).

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 Predefinição:R, elas dependem do idioma de conteúdo da página.

Predefinição:Anchor

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

Predefinição:Warning/pt-br

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}}

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

Predefinição:Anchor

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}}
• {{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}} → Predefinição
• {{SUBJECTSPACE:Template:Main Page}} → Predefinição
• {{TALKSPACE:Template:Main Page}} → Predefinição Discussão

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

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

Outros

Predefinição:Anchor

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 nome é, algumas vezes, precedido por um símbolo «#» (hashtag) 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 Predefinição:Ll. Para mais detalhes, consulte Predefinição:Ll.

Metadados técnicos de outra página

Dados da URL

Predefinição:Anchor

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 "Arquivo". 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.

Predefinição:Anchor

Formatação

Ver também: Predefinição:Ll.

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 Predefinição:Ll.

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.

Predefinição:Anchor

Diversos