====== Pesquisa ======

A pesquisa é feira através do campo apropriado no canto superior direito da página.

===== Sintaxe =====

Basicamente, o DokuWiki executa pesquisas lógicas com o argumento E entre as palavras-chave; todas as palavras escritas no campo de pesquisa serão usadas, sem diferenciar maiúsculas de minúsculas.



As sintaxes das pesquisas avançadas do DokuWiki são descritas a seguir. Todas podem ser combinadas na mesma pesquisa. Usaremos colchetes **''[ ... ]''** para representar os caracteres digitados no campo de pesquisa.

==== Excluir palavras-chave dos resultados (-) ====

Digite um hífen ''-'' imediatamente antes de uma palavra-chave para excluir as páginas com a palavra-chave dos resultados da pesquisa. Por exemplo, a consulta ''[ dokuwiki -plugin ]'' encontrará páginas que contenham "DokuWiki" e não contenham "plugin".



A sintaxe ''-'' pode ser usada não apenas para uma palavra-chave, mas também para pesquisas de correspondência parcial, de frases, de namespaces e pesquisas de grupo descritas abaixo. Por exemplo, você pode escrever a consulta ''%%[ -"frase que quero excluir" ]%%'' para excluir uma frase exata.

==== Coincidência parcial (*) ====

Você pode executar uma pesquisa de coincidência parcial, prefixando ou sufixando a palavra-chave com um asterisco ''*''. Por exemplo, se pesquisar ''[ wiki ]'', encontrará apenas "wiki" mas, com ''[ *wiki ]'' também encontrará "DokuWiki" (coincidência de sufixo). Você também pode pesquisar ''[ doku* ]'' (coincidência de prefixo) e ''[ *okuwik* ]'' (coincidência parcial).



Note que o asterisco ''*'' não substitui caracteres, não é um "wildcard". Você não pode usá-lo dentro da palavra-chave, se pesquisar ''[ doku*iki ]'', por exemplo, não achará nada.

==== Pesquisa de frases ("") ====

Você pode pesquisar frases completas exatas, delimitando-as com aspas. Por exemplo, ''%%[ "instalação do excel" ]%%''.

==== Pesquisar dentro de um namespace (@) ====

Você pode restringir a pesquisa a namespaces. Para pesquisar em páginas dentro de um namespace, prefixe o namespace com ''@'' ou ''ns:''. Para não pesquisar páginas dentro de um namespace, prefixe o namespace com ''^'' or ''-ns:''.



Por exemplo, a consulta ''[ dokuwiki @wiki ^wiki:docs ]'' achará páginas com a palavra "dokuwiki" dentro do namespace "wiki" e não no namespace "wiki:docs". A consulta ''[ dokuwiki ns:wiki -ns:wiki:docs ]'' dará o mesmo resultado.

==== O operador OU (|) ====

Por padrão, o DokuWiki executa pesquisas lógicas com E entre as palavras-chave, mas você também pode usar o operador lógico OU, digitando ''|'' ou ''or'' como separador dos termos de pesquisa. Por exemplo, a consulta ''[ plugin | template ]'' achará páginas que contenham "plugin" OU "template" OU ambos. A consulta ''[ plugin or template ]'' dará o mesmo resultado. Você pode usar o operador OR como alternativa para pesquisas de coincidência parcial [[#Coincidência parcial (*)]], por exemplo, achando páginas sobre nomes com variações de grafia como ''[ Elizabeth | Elizabete ]''.



O operador OU tem precedência menor que o operador E. A consulta ''[ dokuwiki plugin | template ]'' pode ser representada como ''[ (dokuwiki plugin) | template ]'', não como ''[ dokuwiki (plugin | template) ]''. Para pesquisar ''[ dokuwiki (plugin | template) ]'' use a sintaxe de agrupamento como descrito abaixo.



Para [[#Pesquisar dentro de um namespace (@) |restringir sua pesquisa a um namespace]], você **tem de** agrupar a pesquisa com parênteses "()". A pesquisa ''[ plugin | template @plugin ]'' se comportará como ''[ (plugin) | (template @plugin) ]'', i.e. pesquisará "plugin" OU "template @plugin" em //todos// os namespaces. Se você pretende pesquisar "plugin" OU "template" no namespace //plugin//, deve escrever ''[ (plugin | template) @plugin]''.

==== Agrupamento de palavras-chave ====

Você pode agrupar termos de pesquisa com parênteses ''( ... )'', usando-os para forçar a precedência porque os parênteses têm a maior precedência.



Por exemplo, a consulta ''[ dokuwiki -(plugin | @plugin) ]'' achará páginas com a palavra "DokuWiki" que não contenham a palavra "plugin" e também não estejam no namespace "plugin".

===== Pesquisa rápida =====

Você pode digitar o início do nome de uma página no campo de pesquisa e esperar meio segundo. Nos browsers modernos, automaticamente aparecerá uma lista de páginas com o mesmo início de nome.