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.
Contents
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
Xapian search
Configuration of the Xapian based indexed search, see HelpOnXapian.
| Variable name | Default | Description |
| xapian_index_dir | None | Directory where the Xapian search index is stored (None = auto-configure wiki local storage) |
| xapian_index_history | False | True to enable indexing of non-current page revisions. |
| xapian_search | False | True to enable the fast, indexed search (based on the Xapian search library) |
| xapian_stemming | False | True to enable Xapian word stemmer usage for indexing / searching. |
xapian_search (default: False)
Ao definir como True, activa a pesquisa Xapian para o seu wiki 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 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.
![/!\](/static/moniker/img/alert.png "/!\")
É 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!
- 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.
(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 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 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.