Ajuda da API do MediaWiki
Esta é uma página de documentação da API do MediaWiki gerada automaticamente.
Documentação e exemplos: https://www.mediawiki.org/wiki/API
action=parse
- Este módulo requer direitos de leitura.
- Fonte: MediaWiki
- Licença: GPL-2.0+
Faz a análise sintática do conteúdo e devolve o resultado da análise.
Consulte os vários módulos disponíveis no parâmetro prop de action=query para obter informação da versão atual de uma página.
Há várias formas de especificar o texto a analisar:
- Especificar uma página ou revisão, usando page, pageid ou oldid.
- Especificar o conteúdo de forma explícita, usando text, title e contentmodel.
- Especificar só um resumo a analisar. prop deve receber o valor vazio.
- title
Título da página à qual o texto pertence. Se omitido, é preciso especificar contentmodel e deve usar API como título.
- text
Texto a analisar. Usar title ou contentmodel para controlar o modelo de conteúdo.
- summary
Sumário para analisar.
- page
Analisa o conteúdo desta página. Não pode ser usado em conjunto com text e title.
- pageid
Analisa o conteúdo desta página. sobrepõe page.
- Tipo: inteiro
- redirects
Se page ou pageid estiverem definidos para um redirecionamento, resolvê-lo.
- Tipo: booleano (detalhes)
- oldid
Analisar o conteúdo desta revisão. Tem precedência sobre page e pageid.
- Tipo: inteiro
- prop
Qual pedaço de informação obter:
- text
- Fornece o texto analisado do wikitexto.
- langlinks
- Fornece os links de idiomas do wikitexto analisado
- categories
- Fornece as categorias no wikitexto analisado.
- categorieshtml
- Fornece a versão HTML das categorias.
- links
- Fornece os links internos do wikitexto analisado.
- templates
- Fornece a predefinição no wikitexto analisado.
- images
- Fornece as imagens no wikitexto analisado.
- externallinks
- Fornece os links externos no wikitexto analisado.
- sections
- Fornece as seções no wikitexto analisado.
- revid
- Adiciona o identificador de revisão da página analisada.
- displaytitle
- Adiciona o título do texto analisado.
- headitems
- Fornece itens para colocar no
<head>da página. - headhtml
- Fornece
<head>analisado da página. - modules
- Fornece os módulos do ResourceLoader usados na página. Ou jsconfigvars ou encodedjsconfigvars deve ser solicitado conjuntamente com modules.
- jsconfigvars
- Fornece as variáveis de configuração JavaScript específicas da página.
- encodedjsconfigvars
- Fornece as variáveis de configuração JavaScript específicas da página como uma string JSON.
- indicators
- Fornece o HTML de indicadores de status de página utilizados na página.
- iwlinks
- Fornece links interwiki no wikitexto analisado.
- wikitext
- Fornece o wikitexto original que foi analisado.
- properties
- Fornece várias propriedades definidas no wikitexto analisado.
- limitreportdata
- Fornece o relatório limite de uma forma estruturada. Não informa dado, quandodisablelimitreport se definido.
- limitreporthtml
- Fornece a versão HTML do relatório de limites. Não fornece dados quando disablelimitreport está definido.
- parsetree
- A árvore de análise XML do conteúdo da revisão (requer o modelo de conteúdo
wikitext). - parsewarnings
- Gives the warnings that occurred while parsing content.
- Valores (separados com | ou alternativas): text, langlinks, categories, categorieshtml, links, templates, images, externallinks, sections, revid, displaytitle, headitems, headhtml, modules, jsconfigvars, encodedjsconfigvars, indicators, iwlinks, wikitext, properties, limitreportdata, limitreporthtml, parsetree, parsewarnings
- Valor por omissão: text|langlinks|categories|links|templates|images|externallinks|sections|revid|displaytitle|iwlinks|properties|parsewarnings
- pst
Fazer uma transformação de pré-gravação ao texto de entrada, antes de analisá-lo. Só é válido quando usado com texto.
- Tipo: booleano (detalhes)
- onlypst
Fazer uma transformação de pré-gravação (PST, pre-save transform) ao texto de entrada, mas não o analisar. Devolve o mesmo texto após aplicação da PST. Só é válido quando usado com text.
- Tipo: booleano (detalhes)
- effectivelanglinks
Inclui links interlínguas fornecidos por extensões (para ser usado com prop=langlinks).
- Tipo: booleano (detalhes)
- section
Analisar apenas o conteúdo desta secção.
Quando tiver o valor new, analisar text e sectiontitle como se fosse adicionar uma nova secção à página.
new só é permitido quando se especifica text.
- sectiontitle
O novo título da secção quando section tem o valor new.
Ao contrário da edição de páginas, este não toma o valor de summary se for omitido ou estiver vazio.
- disablepp
- Obsoleto
Em vez deste, usar disablelimitreport.
- Tipo: booleano (detalhes)
- disablelimitreport
Omitir o relatório de limites ("NewPP limit report") do resultado de saída do analisador sintático.
- Tipo: booleano (detalhes)
- disableeditsection
Omitir links para edição da secção no resultado da análise sintática.
- Tipo: booleano (detalhes)
- disabletidy
Não fazer a limpeza do HTML (isto é, o tidy) no resultado da análise sintática.
- Tipo: booleano (detalhes)
- generatexml
- Obsoleto
Gerar a árvore de análise XML (requer o modelo de conteúdo
wikitext; substituído por prop=parsetree).- Tipo: booleano (detalhes)
- preview
Executar a análise em modo de antevisão.
- Tipo: booleano (detalhes)
- sectionpreview
Executar a análise em modo de antevisão (também ativa o modo de antevisão).
- Tipo: booleano (detalhes)
- disabletoc
Omitir a tabela de conteúdo no resultado.
- Tipo: booleano (detalhes)
- contentformat
O formato da seriação de conteúdo, usado para o texto de entrada. Só é válido quando usado com text.
- Um dos seguintes valores: text/x-wiki, text/javascript, application/json, text/css, text/plain
- contentmodel
Modelo de conteúdo do texto de entrada. Se omitido, title tem de ser especificado e o valor por omissão será o modelo do título especificado. Só é válido quando usado com text.
- Um dos seguintes valores: wikitext, javascript, json, css, text
- Analisa uma página.
- api.php?action=parse&page=Project:Sandbox [abrir na página de testes]
- Analisa wikitexto.
- api.php?action=parse&text={{Project:Sandbox}}&contentmodel=wikitext [abrir na página de testes]
- Analisa wikitexto, especificando o título da página.
- api.php?action=parse&text={{PAGENAME}}&title=Test [abrir na página de testes]
- Analisa uma sumário.
- api.php?action=parse&summary=Some+[[link]]&prop= [abrir na página de testes]