Usando Xapian è possibile aumentare drasticamente le prestazioni della ricerca all'interno di moin e utilizzare molte nuove caratteristiche non disponibili con il vecchio sistema di ricerca.

Configurazione

Requisiti

È necessario avere Xapian e i binding Python (xapian-core e xapian-bindings) da http://www.xapian.org/ almeno alla versione 1.0.0.

Per elaborare i file allegati, moin utilizza i plgu-in filtro. Questo è un elenco dei plug-in disponibili:

Tipo file

Dipendenza

Note

File di testo (.txt)

-

Prova le codifiche utf-8 e iso-8859-15, altrimenti forza ASCII se le altre non funzionano

Immagini JPEG (.jpg)

-

Vengono estratti i dati EXIF

File Open Office (.sx?)

-

Dalle versioni vecchie di OpenOffice.org/StarOffice

File Open Document (.od?)

-

Dalle versioni recenti di OpenOffice.org/StarOffice

File binari

-

Utilizza una stringa come filtro e anche una blacklist con file da non includere nella ricerca

File MS Word (.doc)

antiword

Il filtro invoca antiword

File MS Excel (.xls)

catdoc

Il filtro invoca xls2csv

File PDF (.pdf)

xpdf-utils

Il filtro invoca pdttotext

Dopo aver installato ulteriori filtri (o dipendenze) è raccomandato (ri)creare l'indice. Xapian troverà i nuovi filtri automaticamente. Alla successiva ricerca i risultati dovrebbero contenere collegamenti diretti agli allegati.

Configurazione

Nel file di configurazione del wiki sono disponibili diverse opzioni per la configurazione di Xapian:

Xapian search

Configuration of the Xapian based indexed search, see HelpOnXapian.

Nome variabile Predefinito Descrizione
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.

(Ri)Creare l'indice

È possibile utilizzare lo strumento a riga di comando moin per creare l'indice, ricrearlo completamente o aggiornarne uno già esistente.

Per creare l'indice per la prima volta, eseguire alla riga di comando:

moin --config-dir=/percorso/alla/directory/di/configurazione --wiki-url=wiki-url/ index build --mode=add

È possibile controllare lo stato di Xapian e il suo indice in InformazioniSulSistema.

Inoltre, possono essere usate le seguenti modalità con il comando precedente per controllare la creazione dell'indice:

/!\ Notare che è necessario ricreare l'indice se viene modificata almeno una delle opzioni xapian_index_history, xapian_index_dir o xapian_stemming!

Prova

È possibile verificare se Xapian è abilitato ed è presente un indice valido controllando le InformazioniSulSistema. Per controllare se le ricerche vengono eseguite utilizzando Xapian, abilitare show_timings nella configurazione del wiki, eseguire una ricerca e controllare la presenza di _xapianSearch in fondo alla pagina.

Uso

Xapian è praticamente usato allo stesso modo degli altri motori di ricerca. Date le caratteristiche avanzate di Xapian, sono stati introdotti nuovi prefissi per le ricerche, non ancora disponibili nel vecchio motore di ricerca. Per maggiori informazioni consultare AiutoSuRicerche e/o usare il dialogo di ricerca in CercaPagina.