##master-page:HelpTemplate
##master-date:Unknown-Date
#format wiki
#language pt

Ao utilizar Xapian pode melhorar drasticamente o desempenho da pesquisa no moin e ainda ter acesso a mais algumas funcionalidades (veja os prefixos de pesquisa em cima) não possíveis com a política do motor de pesquisa.

<<TableOfContents>>

= Instalação =

== Requisitos ==

Tem de ter instalado o Xapian e os respectivos elementos de Python (xapian-core e xapian-bindings) disponíveis em http://www.xapian.org/, pelo menos a versão 1.0.0.

== Configuração ==

No seu wikiconfig, existem várias opções de configuração do Xapian:e
<<WikiConfigHelp(section=xapian)>>

 * '''xapian_search''' (default: False)
  Ao definir como True, activa a pesquisa Xapian para o seu wiki [[WikiMoinMoin|MoinMoin]].

(!) O Moin desactiva o xapian_search automaticamente (e volta à pesquisa lenta) se não encontrar um índice utilizável. Pode verificar se está a utilizar Xapian na [[SystemInfo|InformaçãoDeSistema]].

 * '''xapian_index_history''' (default: False)
  Se esta opção for activada, todas as versões de todas as páginas (à excepção da sub-camada, que só tem uma versão disponível) são indexadas. Isto permite aos utilizadores pesquisar em versões antigas de páginas, se for activado no diálogo de pesquisa da PesquisaDePáginas.
  /!\ É necessário reconstruir o seu índice se alterar esta opção. Verifique também o tamanho do seu índice depois de o construir, no caso de ter um wiki grande, uma vez que esta funcionalidade pode ocupar muito espaço em disco.

 * '''xapian_index_dir''' (default: None)
  Esta opção possibilita-lhe especificar uma outra directoria para guardar o seu índice. Inicialmente, é guardado em ''data_dir''/cache/xapian/. Além do mais, se esta opção for utilizada, todos os wiki de uma wikifarm terá o seu próprio índice identificado pelo seu nome de wiki ao contrário de um índice único na configuração standard. Configure esta opção se gerir uma wikifarm!
  /!\ Não se esqueça de (re-)construir o(s) índice(s) depois de activar esta opção!

 * '''xapian_stemming''' (default: False)
  Se estiver activada, as palavras serão indexadas sem formato e hifenizadas, e os termos da sua query de pesquisa serão hifenizadas no seu idioma. Isto significa que ao pesquisar por "testar", devolve igualmente páginas que contenham as palavras "testado", "testador", etc.
  /!\ Activar/Desactivar esta opção requer uma reconstrução completa do seu índice!

== (Re-)Construção de um índice ==

Pode utilizar a ferramenta de linha de comando ''moin'' para construir de início, reconstruir completamente ou actualizar um índice existente.

Para construir o seu índice pela primeira vez, execute
{{{
moin index build --mode=add
}}}
na sua linha de comando. Pode verificar o estado do Xapian e os seus índices em [[SystemInfo|InformaçãoDeSistema]].

Os seguintes modos podem ser adicionado ao comando descrito em cima para controlar a construção do índice:

 * '''add'''
  Os itens são adicionados sem verificação de duplicação de itens no índice. Utilize este modo apenas se ainda não tiver um índice.

 * '''rebuild'''
  Antes de optar pelo modo ''add'', esta opção elimina o índice anterior, se existir.

* '''update'''
  Actualiza todas as páginas do índice baseada na data da alteração mais recente.
  (!) As invocações periódicas utilizando este modo '''não''' são necessárias, uma vez que as páginas do índice serão actualizadas após cada alteração. Este modo deve ser utilizado apenas por motivos de correcção de falhas se as páginas do índice não estiverem actualizadas.

/!\ Por favor, tenha em consideração que '''tem''' de ''reconstruir'' o seu índice se alterar pelo menos uma das seguintes opções de configuração: xapian_index_history, xapian_index_dir ou xapian_stemming!

== Testes ==

Pode testar se o Xapian está activo se um índice estiver disponível ao consultar a [[SystemInfo|InformaçãoDeSistema]]. Para verificar se as pesquisas estão a utilizar o Xapian, active o show_timings no seu wikiconfig, pesquise e procure por _xapianSearch no fundo da página.

= Utilização =

Basicamente, o Xapian é utilizado da mesma forma que todos os outros motores de pesquisa. Devido às funcionalidade avançadas do Xapian, foram introduzidas alguns novos termos de pesquisa com prefixos, que ainda não estão disponíveis na política de motores de pesquisa (a que geralmente chamamos de pesquisa moin). Consulte o tópico AjudaNaPesquisa para mais informações e/ou utilize o novo diálogo de pesquisa avançada na PesquisaDePáginas para ver o que está disponível e é possível.
