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:

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.

• xapian_search (predefinito: `False`)

  • Impostando a `True`, abilita la ricerca con Xapian.
    Moin disabilita automaticamente `xapian_search` (e passa alla vecchia ricerca) se non trova un indice utilizzabile. È possibile vedere se viene usato Xapian nelle InformazioniSulSistema.

• xapian_index_history (predefinito: `False`)

  • Se questa opzione è abilitata, le revisioni di tutte le pagine (eccetto `underlay` di cui è disponibile solo una revisione) vengono indicizzate. Questo consente agli utenti di eseguire ricerche nelle vecchie revisioni delle pagine nel dialogo di ricerca o in CercaPagina.
    Se viene modificata questa opzione è necessario ricreare l'indice. Controllare anche la dimensione dell'indice dopo la creazione, dato che questa caratteristica può consumare molto spazio su disco. La creazione dell'indice può durare a lungo se l'indicizzazione della cronologia è abilitata.

• xapian_index_dir (predefinito: `None`)

  • Questa opzione consente di specificare una directory separata in cui salvare l'indice; inizialmente viene salvato in `data_dir/cache/xapian/`. Inoltre, se questa opzione è utilizzata, qualsiasi wiki all'interno di una wikifarm avrà il proprio indice identificato dal proprio nome wiki (wikiname) a differenza di una configurazione standard. Impostare questa opzione se viene eseguita una wikifarm.
    Non dimenticarsi di (ri)creare l'indice dopo averla abilitata!

• xapian_stemming (predefinito: `False`)

  • Se abilitata, le parole verranno indicizzate nella loro forma canonica e in base al loro lemma. Questo significa che eseguire una ricerca per "provare" porterà risultati anche per le parole "provato", "prova", etc.
    Abilitando/Disabilitando questa opzione è necessario ricreare completamente l'indice!

(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:

• add

  • Gli oggetti vengono aggiunti senza controllare se sono già presenti. Usare solamente se non si dispone già di un indice.

• rebuild

  • Prima di usare la modalità add, questa opzione cancella l'indice precedente (se esiste).

• update

  • Aggiorna tutte le pagine nell'indice in base alla data di ultima modifica.

    Non è necessario invocare periodicamente il comando con questa opzione, dato che le pagine nell'indice vengono aggiornate quando sono modificate. Dovrebbe essere usato solo per eseguire il debug se le pagine nell'indice non sono aggiornate.

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.