Módulo:Busca/doc

Descrição

Faz busca no código wiki de uma página, contando as correspondências ou as utilizando pra gerar uma lista com uma determinada formatação.

Uso

contar: conta as correspondências para uma busca no código fonte de uma página.

{{#invoke:busca|contar|nome da página|Lua pattern}}

formatar: conta as correspondências para uma busca no código fonte de uma página.

{{#invoke:busca|formatar|nome da página|Lua pattern|Lua pattern de substituição}}

{{#invoke:busca|formatar|nome da página|Lua pattern|Lua pattern de substituição|limite=máximo}}

testar: testa se existe uma correspondência no código fonte da página, retornando "Sim" ou "Não" ou a respectiva resposta predefinida.

{{#invoke:busca|testar|nome da página|Lua pattern}}

{{#invoke:busca|testar|nome da página|Lua pattern|sim=texto para o sim|não=texto para o não}}

Lua patterns

Lua patterns são similares às expressões regulares, mas com algumas diferenças:

• Não tem o "|" (ou).
• Não tem o "{x,y}" (quantificador finito).
• Não tem o "\b" (limítrofe de palavra).
• Não tem "(?...)" (grupos especiais).
• O "?" (opcional) não funciona em grupos, apenas em caracteres.
• O caractere de escape é "%", e não "\".
• O "-" é equivalente ao "*?" (repete o caractere o mínimo possível), e "+?" é escrito por exemplo como "aa-" ("a+?" em regex).

Essas são as diferenças mais notáveis, para mais detalhes veja mw:Extension:Scribunto/Lua reference manual#Patterns.

Limitações específicas dos módulos no MediaWiki:

• Todas quebras de linha e todos espaços no começo e fim dos argumentos são contados como parte do pattern.
• É preciso utilizar {{!}} e {{=}} para escapar "|" e "=", da mesma forma que é feito dentro de um #switch.
• Os módulos são processados depois das predefinições e Parser Functions, devido a isso não é possível fazer um #ifexpr ou outra condição que dependa do resultado de um módulo, e as predefinições retornadas por módulos não são expandidas.
  • Obs: o contrário funciona normalmente, ou seja, predefinições e Parser Functions podem ser usados para gerar os argumentos passados para os módulos.

Exemplos

Contar quantas linhas de tabela tem o Tabela de conversão de unidades:

{{#invoke:busca|contar|Tabela de conversão de unidades|
{{!}}%-}}

resulta em: 78

Lista as seções do artigo Lua (linguagem de programação) e as primeiras palavras de cada seção:

{{#invoke:busca|formatar|Lua (linguagem de programação)|
{{=}}{{=}} *([^{{=}}]-) *{{=}}{{=}}
(%S+ %S+ %S+ %S+ %S+ %S+ %S+)|
* '''%1:''' %2...}}

resulta em:

• História: Lua foi criada em 1993 por [[Roberto...
• Características: Lua é normalmente descrita como uma linguagem...
• A Linguagem: Esta seção descreve o vocabulário, aspectos sintáticos...
• Sintaxe e exemplos: O Programa Olá Mundo pode ser escrito...
• Tabelas: As tabelas são as estruturas de dados...
• Projetos que utilizam Lua: Em 2013, a Wikimedia Foundation começou a...
• Bibliografia: * {{citar livro|autor=Ierusalimschy, Roberto; Figueiredo, Luiz Henrique...