Ajuda: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. | ![]() |
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 Manual:Palavras mágicas .
Existem três tipos gerais de palavras mágicas:
- Modificadores comportamentais: normalmente palavras em maiúsculas, rodeadas por dois sublinhados, por exemplo:
__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 recebem parâmetros e tomam a forma
{{foo:...}}
ou{{#foo:...}}
, ex.{{#invoke:...}}
. Veja também Ajuda:Extensão:ParserFunctions e Extensão:Scribunto .
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.
Palavra | Descrição | Versões | ||
---|---|---|---|---|
Tabela de conteúdo | ||||
__NOTOC__
|
Esconde a tabela de conteúdo (TOC). | |||
__FORCETOC__
|
Força a tabela de conteúdo a aparecer em sua posição normal (antes do primeiro cabeçalho). This will not work in skins that present table of contents outside the article content e.g. Vector 2022 skin. | |||
__TOC__
|
Coloca uma tabela de conteúdo na posição atual da palavra (sobrescrevendo __NOTOC__ ). If this is used multiple times, the table of contents will appear at the first word's position. This will not work in skins that present table of contents outside the article content e.g. Vector 2022 skin.
|
|||
Edição | ||||
__NOEDITSECTION__
|
Esconde os links da edição de seção, ao lado dos títulos. Isto é especialmente útil, onde um título é criado a partir de um modelo: a edição de seção wiki normal seria, neste caso, editar o código do modelo, que normalmente é contraditório para o usuário. Se um molde contiver múltiplas posições, pode ser necessário adicionar "$noeditsection" após cada título. O uso desta palavra mágica numa predefinição tem efeito na própria definição, nas páginas onde ela é usada, e em quaisquer outras predefinições que sejam incluídas na mesma página. É possível uma solução alternativa. | |||
__NEWSECTIONLINK__
|
Adiciona um link ao lado do separador «Editar» para adicionar uma nova secção numa página que não seja de discussão (veja Adicionar uma secção ao fim). |
| ||
__NONEWSECTIONLINK__
|
Remove o link ao lado da aba "Editar" nas páginas em namespaces de discussão. |
| ||
Categorias | ||||
__NOGALLERY__
|
Usado em uma página de categoria, substitui miniaturas na visualização de categoria, com links normais. |
| ||
__HIDDENCAT__
|
Usado em uma página de categoria, esconde a categoria a partir das listas de categorias em seus membros e categorias pai (há uma opção nas preferências de usuário para mostra-las). |
| ||
__EXPECTUNUSEDCATEGORY__
|
Quando usada numa página de categoria, remove a categoria de Special:UnusedCategories . |
| ||
Conversão de idioma | ||||
__NOCONTENTCONVERT__ __NOCC__
|
Nas wikis com variantes de idioma, não executa qualquer conversão de linguagem de conteúdo (personagem e fase) na exibição de artigos, por exemplo, é mostrado chinês padrão (zh) em vez de variantes como zh_cn, zh_tw, zh_sg, ou zh_hk. | |||
__NOTITLECONVERT__ __NOTC__
|
Nas wikis com variantes de idioma, não executa a conversão de linguagem no título (todos os outros conteúdos são convertidos). | |||
Outros | ||||
__START__
|
Sem efeito. Era usada para indicar onde a mensagem da base de dados começava após um comentário de que esta não devia ser transcluída. Removido em r1695 e completamente removido em r24784 |
| ||
__END__
|
Marca explicitamente o fim de uma página, para impedir o MediaWiki de remover automaticamente um espaço em branco que exista ao fundo da página. Removido em 19213. |
| ||
__INDEX__
|
Informa aos mecanismos de pesquisa para indexar a página (substitui $wgArticleRobotPolicies , e não robots.txt). Ele obedece a variável $wgExemptFromUserRobotsControl . |
| ||
__NOINDEX__
|
Informa os motores de busca que não devem indexar a página, isto é, que não devem inclui-la nos resultados de pesquisas. Obedece à variável $wgExemptFromUserRobotsControl . |
| ||
__STATICREDIRECT__
|
Em páginas de redirecionamento, não permita que o MediaWiki atualize automaticamente o link quando alguém move uma página e verifica "Atualizar todos os redirecionamentos que apontem para o título original" (que requer $wgFixDoubleRedirects ). |
| ||
__EXPECTUNUSEDTEMPLATE__
|
Used on a template page, removes the page from Special:UnusedTemplates.
If this switch is not intended to be transcluded with the template's contents, it should be used inside If the switch is intended to remove from the report all pages that transclude a given template (for example, a notice that is transcluded on testcases or sandbox subpages), put the switch inside |
| ||
A partir de extensões | ||||
Extensão | Palavra | Descrição | Versões | |
GlobalUserPage | __NOGLOBAL__
|
Desativa a página global do Usuário. Se estiver presente na página central do usuário, impede que esta seja apresentada em wikis remotas. Também determina se um link para uma página de usuário na wiki remota aparece a vermelho ou a azul. |
| |
Disambiguator | __DISAMBIG__
|
Identifica uma página de desambiguação. |
| |
Wikibase (client) | __EXPECTED_UNCONNECTED_PAGE__
|
Some wiki pages do not fit the scope of Wikidata items, such as discussion archives, template subpages, etc. To prevent a wiki page from being listed in Special:UnconnectedPages, use this magic word anywhere on the page. Pages that don't meet Wikidata's notability criteria should not receive a Wikidata item. |
| |
DiscussionTools | __ARCHIVEDTALK__
|
Hides "responder" links from discussions on archived pages. |
| |
__NOTALK__
|
Makes a page in a talk namespace not be treated like a talk page. |
| ||
ProofreadPage | __EXPECTWITHOUTSCANS__
|
Some wikisource content pages consist of lists (such as a list of editions or translations of the same work) and therefore did not have scans. To prevent these pages from being listed in Special:PagesWithoutScans, insert this magic word into the page. |
| |
Wikibase (client) | {{NOEXTERNALLANGLINKS}}
|
A magic word and a parser function which when invoked, will disable the Wikibase extension for a specific page, or used with parameters can suppress specific interlanguage links produced by the extension. When active, only interlanguage links present in the wikitext are used. |
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, adicionar parâmetros irá forçar o analisador a invocar um modelo; 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.
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 1.19, elas dependem do idioma de conteúdo da página.
Variável | Saída | Descrição | Versões | |
---|---|---|---|---|
Ano | ||||
{{CURRENTYEAR}}
|
2024 | Ano | ||
Mês | ||||
{{CURRENTMONTH}}
|
09 | Mês (com zeros à esquerda) | ||
{{CURRENTMONTH1}}
|
9 | Mês (sem zeros à esquerda) | ||
{{CURRENTMONTHNAME}}
|
setembro | Mês (nome) | ||
{{CURRENTMONTHNAMEGEN}}
|
setembro | Mês (caso genitivo) | ||
{{CURRENTMONTHABBREV}}
|
set. | Mês (abreviado) |
| |
Dia | ||||
{{CURRENTDAY}}
|
8 | Dia do mês (sem zeros à esquerda) | ||
{{CURRENTDAY2}}
|
08 | Dia do mês (com zeros à esquerda) |
| |
{{CURRENTDOW}}
|
0 | Dia da semana (sem zeros à esquerda), de 0 (para Domingo) até 6 (para Sábado) | ||
{{CURRENTDAYNAME}}
|
domingo | Dia da semana (nome) | ||
Hora | ||||
{{CURRENTTIME}}
|
06h17min | Hora e minuto (formato 24 horas, HH:mm) | ||
{{CURRENTHOUR}}
|
06 | Hora (formato 24 horas, HH, com zeros à esquerda) | ||
Outros | ||||
{{CURRENTWEEK}}
|
36 | Semana (número) | ||
{{CURRENTTIMESTAMP}}
|
20240908061735 | Data e hora (formato YYYYMMDDHHmmss) |
|
As seguintes variáveis fazem o mesmo que as anteriores, mas que utilizam configuração do servidor do site ou $wgLocaltimezone .
{{LOCALYEAR}}
{{LOCALMONTH}}
{{LOCALMONTH1}}
{{LOCALMONTH2}}
{{LOCALMONTHNAME}}
{{LOCALMONTHNAMEGEN}}
{{LOCALMONTHABBREV}}
{{LOCALDAY}}
{{LOCALDAY2}}
{{LOCALDOW}}
{{LOCALDAYNAME}}
{{LOCALTIME}}
{{LOCALHOUR}}
{{LOCALWEEK}}
{{LOCALTIMESTAMP}}
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 Extensão:ParserFunctions para usar a a parser function #time .
Metadados técnicos
Variável | Saída | Descrição | Versões | ||
---|---|---|---|---|---|
Site | |||||
{{SITENAME}}
|
MediaWiki | O nome do site da wiki ($wgSitename ) | |||
{{SERVER}}
|
//www.mediawiki.org | A URL do domínio ($wgServer ) | |||
{{SERVERNAME}}
|
www.mediawiki.org | Nome de domínio e subdomínio (não depende mais de $wgServerName desde a versão 1.17). | |||
{{DIRMARK}}
|
|
Retorna a marca direcional do Unicode correspondente à direção do idioma padrão desta wiki (‎ nas wikis em que a direção é da esquerda para a direita e ‏ nas wikis em que a direção é da direita para a esquerda); útil para texto multi-direcional. Desde a revisão 1.19, depende do idioma de conteúdo da página.
|
| ||
{{ARTICLEPATH}}
|
/wiki/$1 | Relative article path ($wgArticlePath ). | |||
{{SCRIPTPATH}}
|
/w | Endereço relativo dos scripts ($wgScriptPath ). | |||
{{STYLEPATH}}
|
/w/skins | Endereço relativo dos estilos ($wgStylePath ). |
| ||
{{CURRENTVERSION}}
|
1.43.0-wmf.21 (b7b9c62) | A versão do MediaWiki nesta wiki. |
| ||
{{CONTENTLANGUAGE}}
|
en en |
A língua padrão da interface desta wiki ($wgLanguageCode ). |
| ||
Página | |||||
{{PAGEID}}
|
76028 | Retorna o identificador de página (ID da página). |
| ||
{{PAGELANGUAGE}} {{#language:{{PAGELANGUAGE}}}}
|
pt-br português do Brasil |
Devolve a língua da página atual. O código de língua que esta variável devolve pode ser convertido num nome de língua usando {{#language:...}} .
|
| ||
{{TRANSLATABLEPAGE}}
|
Help:Magic words | Returns the title of the translation page (the page other languages are translated from) if a page is translatable (including translated pages), and nothing if the page is not translatable. |
| ||
|
Unidade traduzida. Idioma: pt-br. Not translated unit. Language: en. |
Deve ser usado em uma página traduzida, dentro de <translate> etiquetas. Retorna o código do idioma da unidade de tradução atual. Em uma página de tradução, se a unidade foi traduzida, ela retorna o idioma da tradução. Caso contrário, retorna o idioma de origem. O código de idioma que esta variável retorna pode ser convertido em um nome de idioma usando {{#language:...}} . Deve ser usado apenas por administradores de tradução.
|
| ||
{{PROTECTIONLEVEL:ação}}
|
Retorna o nível de proteção (por exemplo, autoconfirmado, sysop) para uma determinada operação (por exemplo, «edit», «move») na página atual. Retorna uma string vazia se a operação não estiver protegida. |
| |||
{{PROTECTIONEXPIRY:operação}}
|
Devolve a data e expiração (por exemplo, «20160418155030», «infinity») para uma dada operação (por exemplo, «edit», «move») sobre a página atual. Devolve «infinity» se não está protegida. |
| |||
{{CASCADINGSOURCES}}
|
[Exigente] Devolve as fontes de qualquer proteção em cascata que esteja a ter efeito na página atual. As páginas não devolvem o seu próprio título a menos que se transcluam a si próprias. |
| |||
Revisão exibida da página atual (revisão mais recente ou revisão mais antiga selecionada) | |||||
{{REVISIONID}}
|
- | Identificador (ID) único da revisão. Está vazio na pré-visualização, pelo que pode mostrar uma mensagem de erro apenas na pré-visualização. Pode ser desativado no modo miser (todas as wikis WMF), retornando - quando não estiver na prévisualização.
|
| ||
{{REVISIONDAY}}
|
7 | Dia em que a edição foi realizada (número, sem zeros à esquerda). |
| ||
{{REVISIONDAY2}}
|
07 | Dia em que a edição foi realizada (número, com zeros à esquerda). |
| ||
{{REVISIONMONTH}}
|
09 | Mês em que a edição foi feita (com zeros à esquerda desde 1.17+, sem zeros à esquerda nas versões anteriores). |
| ||
{{REVISIONMONTH1}}
|
9 | Mês em que a edição foi realizada (número, sem zeros à esquerda). |
| ||
{{REVISIONYEAR}}
|
2024 | Ano da última edição |
| ||
{{REVISIONTIMESTAMP}}
|
20240907192932 | Data e hora da última edição |
| ||
{{REVISIONUSER}}
|
FuzzyBot | O nome de usuário do usuário que fez a edição em questão ou o usuário que está visualizando a edição. |
| ||
{{REVISIONSIZE}}
|
93594 | O tamanho (bytes de wikitexto) da revisão atual da página ou previsualização |
| ||
Afeta o conteúdo da página | |||||
{{DISPLAYTITLE:título}} {{DISPLAYTITLE:"título"|noerror}} {{DISPLAYTITLE:"título"|noreplace}}
|
Formata o cabeçalho de título da página atual. O valor tem de ser igual ao título por omissão: só são permitidas alterações entre maiúsculas e minúsculas em certas partes do título (não todas) e a substituição de espaços por sublinhados (isto pode ser alterado com $1). Pode ser ativada ou desativada com $2; desativada por padrão antes da versão 1.10+, ativada por padrão dela em diante. Unless $wgRestrictDisplayTitle is set to false , the value must be equivalent to the default title: only capitalization changes to certain parts of the title (not all) and replacing spaces with underscores are allowed. It can be disabled or enabled by $wgAllowDisplayTitle .
Pode ter um segundo argumento de noerror ou noreplace para suprimir mensagens de erro quando vários displaytitles são usados em uma página ou para fazer este |
(para noerror e noreplace) | |||
{{DEFAULTSORT:chavedeordenação}} {{DEFAULTSORTKEY:chavedeordenação}} {{DEFAULTCATEGORYSORT:chavedeordenação}} {{DEFAULTSORT:chavedeordenação|noerror}} {{DEFAULTSORT:chavedeordenação|noreplace}}
|
Usado para categorizar páginas, define uma chave de classificação de categoria padrão. Por exemplo, se você colocar {{DEFAULTSORT:Smith, John}} no fim de John Smith, a página seria classificada em "S" por padrão nas categorias. Pode ser necessário um segundo argumento de noerror ou noreplace para suprimir mensagens de erro quando múltiplas defaultsortkeys são usadas em uma página ou para fazer com que defaultsort não faça nada se defaultsort já foi especificado anteriormente na página.
|
(para noerror e noreplace) |
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, $nop-code → $nop-result e $nop-r-code → $nop-r-result).
Use "|R" para palavras mágicas que requerem um parâmetro como PAGESINCATEGORY (por exemplo $pic e $pic-r, ou $pic-subcats e $pic-subcats-r).
Também aplicável a {{PAGESIZE:nome da página}}
anteriormente.
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.
Variável | Saída | Descrição | Versões | |
---|---|---|---|---|
{{NUMBEROFPAGES}}
|
1 716 284 | Número de páginas wiki |
| |
{{NUMBEROFARTICLES}}
|
63 966 | Número de páginas em domínios de conteúdo que podem ser considerados artigos. Consulte Manual:$wgArticleCountMethod para detalhes. | ||
{{NUMBEROFFILES}}
|
2 760 | Número de arquivos carregados |
| |
{{NUMBEROFEDITS}}
|
6 634 628 | Número de edições wiki |
| |
{{NUMBEROFVIEWS}}
|
Número de visitas às páginas. Normalmente inútil nas wikis com armazenamento em cache. Removido em Gerrit change 150699. |
| ||
{{NUMBEROFUSERS}}
|
17 989 412 | Número de usuários registados. |
| |
{{NUMBEROFADMINS}}
|
138 | Número de usuários no grupo sysop. |
| |
{{NUMBEROFACTIVEUSERS}}
|
897 | Número de usuários ativos, com base nos critérios usados na página Special:Statistics |
| |
{{PAGESINCATEGORY:nomedacategoria}} {{PAGESINCAT:nomedacategoria}}
|
158 158 |
[Exigente] Número de páginas (incluindo categorias e arquivos) na categoria especificada. (Category:Help usada para demonstração) |
| |
{{PAGESINCATEGORY:nomedacategoria|all}} {{PAGESINCATEGORY:nomedacategoria|pages}} {{PAGESINCATEGORY:nomedacategoria|subcats}} {{PAGESINCATEGORY:nomedacategoria|files}}
|
158 155 3 0 |
[Exigente] Respetivamente, o número de
na categoria especificada. (Category:Help usada para demonstração) |
| |
{{NUMBERINGROUP:groupname}} {{NUMINGROUP:groupname}}
|
21 21 |
Número de usuários num grupo específico. (bureaucrat usado para demonstração) |
| |
{{PAGESINNS:index}} {{PAGESINNAMESPACE:index}}
|
Não habilitado | [Exigente] Número de páginas no espaço nominal especificado (substitua índice pelo índice do espaço nominal desejado). Por exemplo, {{PAGESINNAMESPACE:14}} produzirá o número de páginas de categoria. {{PAGESINNS:0}} difere de {{NUMBEROFARTICLES}} porque o primeiro inclui páginas de redirecionamento e desambiguação. Desativado por padrão, ative com $wgAllowSlowParserFunctions .
|
|
Nomes de páginas
Variável | Para a página atual | Descrição | Versões | |
---|---|---|---|---|
{{FULLPAGENAME}}
|
Help:Magic words/pt-br | Namespace e título completo de página (incluindo todos os níveis de subpáginas). |
| |
{{PAGENAME}}
|
Magic words/pt-br | Título completo de página (incluindo todos os níveis de subpáginas) sem o namespace. | ||
{{BASEPAGENAME}}
|
Magic words | Título da página no nível de subpágina imediatamente superior sem o namespace. Retornaria Title/Foo na página Help:Title/Foo/Bar
|
| |
{{ROOTPAGENAME}}
|
Magic words | Nome do diretório raiz da página atual. Retornaria Title na página Help:Title/Foo/Bar
|
| |
{{SUBPAGENAME}}
|
pt-br | O título da subpágina. Retornaria Bar na página Help:Title/Foo/Bar
Se não houver subpágina, o valor do Para obter uma separação mais complexa, use |
| |
{{SUBJECTPAGENAME}} {{ARTICLEPAGENAME}}
|
Help:Magic words/pt-br Help:Magic words/pt-br |
Nome completo da página do tema associado (por exemplo, artigo ou arquivo). Útil em páginas de discussão. |
| |
{{TALKPAGENAME}}
|
Help talk:Magic words/pt-br | Nome completo da página de discussão associada. |
|
Nenhum destes é afetado por alterações no título de exibição usando {{DISPLAYTITLE:xxxx}}
; os valores retornados são o título da página original.
As palavras mágicas {{BASEPAGENAME}}
e {{SUBPAGENAME}}
só funcionam para espaços nominais nos quais foi possibilitado o uso de subpáginas. Consulte $wgNamespacesWithSubpages 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:
{{PAGENAME:Template:Main Page}}
→ Main Page
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 detalhes.
Namespaces
Variável | Saída | Descrição | Versões | |
---|---|---|---|---|
{{NAMESPACE}}
|
Help | Nome do namespace da página (exceto para o espaço principal) | ||
{{NAMESPACENUMBER}}
|
12 | ID do namespace da página |
| |
{{SUBJECTSPACE}} {{ARTICLESPACE}}
|
Help Help |
Nome do namespace de conteúdo associado |
| |
{{TALKSPACE}}
|
Help talk | Nome do namespace da página de discussão associada |
|
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}}
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:
{{NAMESPACENUMBER:MediaWiki}}
→ 0{{NAMESPACE:MediaWiki}}
→ (Pages in main space will return empty){{NAMESPACE:Template:Main Page}}
→ Template{{SUBJECTSPACE:Template talk:Main Page}}
→ Template{{ARTICLESPACE:Template talk: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
Variável | Saída | Descrição | Versões | |
---|---|---|---|---|
{{!}}
|
| | Usada para incluir uma barra vertical (pipe) como parte do argumento de uma predefinição ou do conteúdo da célula de uma tabela. Antes da sua adição às palavras mágicas, muitas wikis implementavam-na criando a predefinição Template:! com o conteúdo | .
Veja Ajuda: Extensão:ParserFunctions#Caracteres barra vertical de escape nas tabelas para maiores explicações. |
| |
{{=}}
|
= | Used to include an equal sign as part of a template argument or table cell contents. Before this was added as a magic word, many wikis implemented this by creating Template:= with = as the content.
See Help:Extension:ParserFunctions#Raw equal signs for further explanation. |
|
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 Extensão:ParserFunctions . Para mais detalhes, consulte Ajuda:Extensão:ParserFunctions .
Metadados técnicos de outra página
Função do analisador sintático | Saída (para a página MediaWiki) |
Descrição | Versões | |
---|---|---|---|---|
{{PAGEID: nome da página }}
|
1 | [Exigente] Devolve o identificador da página especificada*. |
| |
{{PAGESIZE:nome da página}} {{PAGESIZE: nome da página |R}}
|
105 859 105859 |
[Exigente] Devolve o tamanho em bytes da página especificada. Use |R para obter números em bruto (sem formatação).
|
| |
{{PROTECTIONLEVEL:ação | nome da página}}
|
sysop | [Exigente] Devolve o nível de proteção (por exemplo, «autoconfirmed», «sysop») para uma determinada operação (por exemplo, «editar», «mover») |
| |
{{PROTECTIONEXPIRY: ação | nome da página}}
|
infinity | [Exigente] Gera o vencimento da proteção (por exemplo, "20160418155030", "infinity") para uma determinada ação (por exemplo, "editar", "mover") na página especificada. Retorna "infinity" se não estiver protegido. |
| |
{{CASCADINGSOURCES: page name}}
|
[Exigente] Devolve as fontes de qualquer proteção em cascata que esteja a incidir sobre a página especificada. As páginas não devolvem o seu próprio título a menos de se estejam a transcluir a elas próprias. |
| ||
{{REVISIONID: nome da página }}
|
6287429 | [Exigente] Identificador único da última revisão da página especificada*. |
| |
{{REVISIONDAY: nome da página }}
|
29 | [Exigente] Dia da última revisão da página especificada* (sem zeros à esquerda). |
| |
{{REVISIONDAY2: nome da página }}
|
29 | [Exigente] [Exigente] Dia da edição da última revisão da página especificada* (com zeros à esquerda). |
| |
{{REVISIONMONTH: nome da página }}
|
12 | [Exigente] Mês da última revisão da página especificada* (com zeros à esquerda, desde a versão 1.17+, sem zeros à esquerda nas versões anteriores). |
| |
{{REVISIONMONTH1: nome da página }}
|
12 | [Exigente] Mês da última revisão da página especificada* (sem zeros à esquerda). |
| |
{{REVISIONYEAR: nome da página }}
|
2023 | [Exigente] Ano da última revisão da página especificada*. |
| |
{{REVISIONTIMESTAMP: nome da página }}
|
20231229181425 | [Exigente] Data e hora da edição da última revisão da página especificada*. |
| |
{{REVISIONUSER: nome da página }}
|
Tropicalkitty | [Exigente] O nome do usuário do autor da última revisão da página especificada*. |
| |
|
Dados da URL
Função do analisador sintático | Entrada → Saída | Descrição | Versões | ||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
{{localurl:nome da página}} {{localurl:nome da página
|
{{localurl:MediaWiki}} → /wiki/MediaWiki {{localurl:MediaWiki|printable=yes}} → /w/index.php?title=MediaWiki&printable=yes |
Endereço relativo para o título | |||||||||||||||
{{fullurl:nome da página}} {{fullurl:nome da página {{fullurl:interwiki:nome da página remota
|
{{fullurl:Category:Top level}} → //www.mediawiki.org/wiki/Category:Top_level
|
Um caminho relativo ao protocolo para o título, que depende da configuração $wgServer para a wiki local (e assim, pode ou não começar como http(s):// ). Este também irá resolver os prefixos das interwikis. Nota: as hiperligações relativas ao protocolo sem parênteses retos (simples) não são automaticamente interligadas.
|
| ||||||||||||||
{{canonicalurl:nome da página}} {{canonicalurl:nome da página {{canonicalurl:interwiki:nome da página remota
|
{{canonicalurl:Category:Top level}} → https://www.mediawiki.org/wiki/Category:Top_level
|
O caminho absoluto para o título, usando a URL canônica. Isso também irá resolver prefixos interwiki. |
| ||||||||||||||
{{filepath:nome do arquivo}} {{filepath:nome do arquivo|nowiki}} {{filepath:nome do arquivo|thumbnail_size}}
|
{{filepath:Wiki.png}} → //upload.wikimedia.org/wikipedia/mediawiki/b/bc/Wiki.png
|
Um caminho relativo ao protocolo do tamanho completo ou thumbnail (1.18+) de um ficheiro multimédia. |
| ||||||||||||||
{{urlencode:string}} ou {{urlencode:string|QUERY}} {{urlencode:string|WIKI}} {{urlencode:string|PATH}}
|
{{urlencode:x:y/z á é}} ou {{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 |
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:StringFunctions .
|
| ||||||||||||||
{{anchorencode:string}}
|
{{anchorencode:x y z á é}} → x_y_z_á_é |
A entrada codificada para utilização nas âncoras da seção URL (após o símbolo hashtag “#” em uma URL). |
|
The following are equivalents encoded for use in MediaWiki URLs (some characters percent-encoded):
{{localurle:page name}}
{{localurle:page name|query_string}}
{{fullurle:page name}}
{{fullurle:page name|query_string}}
{{fullurle:interwiki:remote page name|query_string}}
{{canonicalurle:page name}}
{{canonicalurle:page name|query_string}}
{{canonicalurle:interwiki:remote page name|query_string}}
Namespaces
{{ns:}}
retorna o nome localizado atual para o espaço nominal com esse índice, nome canônico ou alias local.
Thus {{ns:6}}
, {{ns:File}}
, and {{ns:Image}}
(an old name for the File namespace) all return "File".
On a wiki where the content language is French, {{ns:Fichier}}
is also valid, but {{ns:Datei}}
(the localisation of "File" in German) is not.
The main namespace has no name, i.e. {{ns:0}}
returns an empty string.
For explicitly referring to the main namespace, {{int:Blanknamespace}}
can be used, resulting in "(Principal)".
{{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.
Namespaces de conteúdo | Namespaces Discussão | |||
---|---|---|---|---|
Uso | Saída | Uso | Saída | |
{{ns:-2}} / {{ns:Media}}
|
Media | {{ns:-1}} / {{ns:Special}}
|
Special (no talk page) | |
{{ns:0}} / {{ns:}}
|
{{ns:1}} / {{ns:Talk}}
|
Talk | ||
{{ns:2}} / {{ns:User}}
|
User | {{ns:3}} / {{ns:User talk}}
|
User talk | |
{{ns:4}} / {{ns:Project}}
|
Project Varies between wikis |
{{ns:5}} / {{ns:Project talk}}
|
Project talk | |
{{ns:6}} / {{ns:File}} or {{ns:Image}}
|
File | {{ns:7}} / {{ns:File talk}} or {{ns:Image talk}}
|
File talk | |
{{ns:8}} / {{ns:MediaWiki}}
|
MediaWiki | {{ns:9}} / {{ns:MediaWiki talk}}
|
MediaWiki talk | |
{{ns:10}} / {{ns:Template}}
|
Template | {{ns:11}} / {{ns:Template talk}}
|
Template talk | |
{{ns:12}} / {{ns:Help}}
|
Help | {{ns:13}} / {{ns:Help talk}}
|
Help talk | |
{{ns:14}} / {{ns:Category}}
|
Category | {{ns:15}} / {{ns:Category talk}}
|
Category talk |
Não confundir namespaces localizados com espaços nominais personalizados.
Formatação
Uso | Entrada → Saída | Descrição | Versão | ||
---|---|---|---|---|---|
|
Não suportado: Exemplos de entrada errada (saída não confiável), com ou sem o código |
Recebe um número não formatado (algarismos árabes, sem separador de milhares e com . no lugar de vírgula decimal) e devolve-o na forma localizada e formatado com separador decimal e separador de milhares, de acordo com a definição na locale padrão da wiki.O parâmetro Se tem a necessidade de formatar (de acordo com a locale da wiki) um número de entrada cujo formato é desconhecido, pode tentar usar |
| ||
|
|
Formata uma data desvinculada com base na preferência do usuário "formato de data", e acrescenta metadados etiquetando-a como uma data formatada. Para usuários não logados e aqueles que não definiram um formato de data em suas preferências, as datas podem receber um padrão: mdy , dmy , ymd , ISO 8601 (todos eles são case sensitive). Se apenas o mês e o dia são dados, somente mdy e dmy são válidos. Se um formato não for especificado ou for inválido, o formato de entrada é usado como padrão. Se a data fornecida não é reconhecida como uma data válida (especificamente, se contiver quaisquer metadados tais como a partir de um uso aninhado destas predefinições ou semelhantes), ele é renderizado sem alterações, e metadados adicionais não serão gerado. For logged-out users and those who have not set a date format in their preferences, dates can be given a default: mdy , dmy , ymd , ISO 8601 (all case sensitive). If only the month and day are given, only mdy and dmy are valid. If a format is not specified or is invalid, the input format is used as a default. If the supplied date is not recognized as a valid date (specifically, if it contains any metadata such as from a nested use of these or similar templates), it is rendered unchanged, and no (additional) metadata is generated.
|
| ||
|
{{lc:DATA CENTER}} → data center
|
O texto de entrada em letras minúsculas. |
| ||
|
{{lcfirst:DATA center}} → dATA center
|
O texto de entrada com o primeiro caractere em minúsculas |
| ||
|
{{uc:text transform}} → TEXT TRANSFORM
|
O texto de entrada em letras maiúsculas |
| ||
|
{{ucfirst:text tRAnSFORM}} → Text tRAnSFORM
|
O texto de entrada com o primeiro caractere em letras maiúsculas. |
| ||
|
{{padleft:xyz|5}} → 00xyz
|
Insere uma string com caracteres de preenchimento (o caractere é escolhido no terceiro parâmetro; por padrão é 0), de uma dimensão especificada (segundo parâmetro), ao lado de um caractere ou variável base escolhido (primeiro parâmetro). The final digits or characters in the base replace the final characters in the padding; i.e. {{padleft:44|3|0}} produces 044. The padding string may be truncated if its length does not evenly divide the required number of characters.
Somente o primeiro caractere do terceiro parâmetro é usado em versões até a 1.12, mas na versão 1.15, todos os caracteres são usados. Bug (resolvida em r45734): carateres multibyte são interpretados como dois caracteres, o que pode inclinar a largura. Estes também não podem ser usados como carateres de preenchimento. |
| ||
|
{{padright:xyz|5}} → xyz00
|
Idêntico a padleft , mas adiciona os caracteres de preenchimento no lado direito.
|
| ||
|
{{bidi:text transform}} → text transform
|
Wraps the text in a script-appropriate directionality marker (either left-to-right (U+202A) or right-to-left (U+202B)) and a pop directionality formatting character (U+202C), to ensure directionality safety when using a mix of scripts in running text. |
Ver também: Extension: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: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.
Uso | Entrada → Saída | Descrição | Versão | |||
---|---|---|---|---|---|---|
{{#language}} {{#language:language code}} {{#language:language code|target language code}}
|
{{#language:ar}} → العربية {{#language:ar|en}} → Arabic
|
O nome completo do idioma para o código do idioma dado: nome nativo (idioma autônimo) por padrão, o nome traduzido no idioma de destino se um código de idioma de destino for especificado. A extensão Extension:CLDR deve ser instalada para a tradução funcionar. If no argument is given, returns the name of the target language (for articles, the content language; for messages, the user language). |
| |||
{{#bcp47}} {{#bcp47:language code}}
|
{{#bcp47:sr-ec}} → sr-Cyrl{{#bcp47:zh-yue}} → yue
|
The IETF BCP-47 language tag for the given language code . If no argument is given, returns the tag of the target language (for articles, the content language; for messages, the user language). |
| |||
{{#dir}} {{#dir:language code}} {{#dir:language code|bcp47}}
|
{{#dir:en}} → ltr{{#dir:he}} → rtl{{#dir:sr-Cyrl|bcp47}} → ltr
|
The directionality for the given language code , either rtl or ltr . If the optional second argument is bcp47 , then the first argument is interpreted as a BCP-47 language tag. If no argument is given, returns the directionality of the target language (for articles, the content language; for messages, the user language).
|
| |||
{{PLURAL:2|is|are}}
|
{{PLURAL:0|is|are}} → is{{PLURAL:1*1|is|are}} → is{{PLURAL:21 mod 10|is|are}} → are{{PLURAL:{{#expr:21 mod 10}}|is|are}} → is{{PLURAL:1|is|are}} → is{{PLURAL:2|is|are}} → are{{PLURAL:-1|is|are}} → is{{PLURAL:-2|is|are}} → are{{PLURAL:0.5|is|are}} → are{{PLURAL:1.5|is|are}} → are{{PLURAL:-0.5|is|are}} → are{{PLURAL:-1.5|is|are}} → are(Para o Russo) {{PLURAL:5|1=Категория|Категории}} → Категории
|
Produz a forma singular (segundo parâmetro) se o valor absoluto do primeiro parâmetro for uma expressão com o valor um; se não, produz a forma plural (terceiro parâmetro). O funcionamento depende do idioma. See further documentation on translatewiki.net
Alguns códigos de idioma (ab, av, ba, bxr, ce, crh_cyrl, cv, inh, koi, krc, kv, lb, lez, mhr, mrj, myv, ru, tt_cyrl, tyv, udm, xal) usavam 3 formas plurais (atualizado 01.2014):
|
||||
{{GRAMMAR:N|noun}}
|
Retorna a forma inflectida correta do substantivo, descrito pelo código de inflexão após os dois pontos «: » (dependente do idioma). Transformações gramaticais deste gênero são usadas para idiomas inflectidos como o polonês. Ver também $wgGrammarForms .
|
| ||||
{{GENDER:username|text for every gender}}
|
(Depende do gênero do usuário) | Retorna uma de várias opções dependendo do sexo do utilizador nas preferências. |
| |||
{{int:nome da mensgem}}
|
{{int:edit}} → Edit (Depende do idioma do usuário; tente: fr • ja) |
Internacionaliza (traduz) a mensagem de sistema da interface (páginas no namespace MediaWiki) para a língua do usuário. Para msgnw e outras palavras mágicas de transclusão, ver Modificadores de transclusão.
Note que esta palavra mágica pode danificar ou confundir a consistência da cache no MediaWiki 1.17 e anteriores; consulte bug 14404 Note that this can damage / confuse cache consistency in MediaWiki 1.17 and earlier, see T16404. |
||||
{{int:editsectionhint|MediaWiki}}
|
{{int:editsectionhint|MediaWiki}} → Edit section: MediaWiki
|
Você também pode usar parâmetros com traduções. Os parâmetros são designados em mensagens com: $1, $2, $3, etc. Por exemplo, aqui é a mensagem para editsectionhint: Edit section: $1 Neste exemplo, o MediaWiki substitui $1. |
Modificadores de transclusão
{{Nome da página|parâmetros opcionais}}
normalmente transclui outra página nomeada, por padrão a partir do espaço nominal Predefinição:.
Estas palavras mágicas modificam esse comportamento.
Uso | Descrição | Versão | |
---|---|---|---|
{{:xyz}}
|
O sinal de dois pontos não é um modificador da predefinição, mas sim o prefixo que indica o espaço nominal principal. Porque o espaço nominal para transclusões é, por omissão, Predefinição:, usa-se, por exemplo, {{:UTC}} (em vez de {{UTC}}) para incluir o texto do artigo UTC do espaço nominal principal em vez de a Predefinição:UTC. | ||
{{int:xyz}}
|
O mesmo que {{MediaWiki:xyz}}, exceto que é aplicada a tradução padrão da mensagem, dependendo das subpáginas e da língua do conteúdo, do utilizador e a uselang. Outra diferença é: isto não aparece em «Predefinição usada nesta página:». O resultado é ⧼xyz⧽ se MediaWiki:xyz não existir. Ver também Help:Mensagem do sistema . | ||
{{msg:xyz}} {{raw:xyz}}
|
Mesmo que exista a palavra mágica com o título "xyz", usar Predefinição:xyz a menos que a predefinição não exista (equivalente a {{template:xyz}}). Normalmente, as palavras mágicas têm precedência quando existe um conflito. | ||
{{raw:xyz}}
|
Se $wgEnableScaryTranscluding estiver ativado, e esta for uma transclusão interwikis, incluir o texto wiki em bruto em vez do HTML da wiki terceira. |
| |
{{msgnw:xyz}}
|
É apresentado o texto wiki não expandido (mais ou menos, para obter detalhes consulte Help:Predefinições ). | ||
{{subst:xyz}}
|
No texto wiki, a marcação é substituída pelo conteúdo (só um nível de análise). Consulte Help:Predefinições . | ||
{{safesubst:xyz}}
|
Veja Help:Predefinições . |
Diversos
Uso | Input → Saída | Descrição | Versão | |
---|---|---|---|---|
{{#special:nome da página especial}}
|
{{#special:userlogin}} → Special:UserLogin
|
O nome localizado de uma determinada página canônica do namespace Special: .
|
| |
{{#speciale:nome da página especial}}
|
{{#speciale:userlogin}} → Special:UserLogin
|
O nome localizado e codificado por URL de uma determinada página canônica do namespace Special: .
|
| |
{{#tag:nomedatag
|
Exemplo para as tags da extensão Cite <ref> :
|
Nome alternativo (alias) para elementos (tags) do analisador sintático ou de extensões, em estilo XML. Permite a transformação pré-gravação de código wiki e de funções da extensão Extensão:ParserFunctions dentro de elementos, antes desses elementos em si serem processados. Também impede a análise de elementos em caminhos condicionais que não são executados (como nas declarações #if ). O conteúdo entre elementos é passado no primeiro parâmetro e quaisquer atributos para os elementos pode ser passado nos parâmetros subsequentes. Este exemplo:
…pode ser reescrito desta maneira:
|
|
See also
- Para a função de analisador
#invoke
, consulte w:Wikipedia:Lua#Running a module.