BeeSeek, per chi non ne avesse già sentito parlare, è un progetto che punta a creare un motore di ricerca open-source e basato su un database distribuito in una rete P2P.

Adesso che il codice è funzionante, siamo in una fase di debug davvero intensivo per stabilizzare il tutto il prima possibile e renderlo pronto per funzionare a pieno regime.

…l’alveare colpisce ancora ;) …

Per questo ho deciso di scrivere un piccolo HowTo su come essere in pochi minuti pronti ad utilizzarlo per le proprie ricerche e segnalare eventuali bug, senza doversi però spulciare la documentazione.

Vorrei ripetere ancora una volta che non è necessario saper programmare per aiutare BeeSeek, se poi lo sapete fare, ben venga ;)

~ Step 1 – Dipendenze ~
Python 2.5
Bazaar 0.92 o superiore

~ Step 2 – Creare una directory per contenere il progetto ~
Penso sia superfluo spiegare come creare una directory, quello che vorrei far notare però è che il vostro utente deve avere i permessi di lettura e scrittura su di essa.
Per far ciò basta dare un:

$ sudo chown user directory

specificando il vostro nome utente e la directory che avete appena creato.

~ Step 3 – Scaricare Hive e Honeybee e mettere i file al posto giusto ~
Basta utilizzare questo semplicissimo script:

#!/bin/bash

directory=/beeseek #Sostituitelo con il percorso di quella che avete creato prima

cd $directory
bzr branch http://bazaar.launchpad.net/~beeseek-core-devs/beeseek/hive
bzr branch http://bazaar.launchpad.net/~beeseek-core-devs/beeseek/honeybee
cd honeybee
cp ball-blue.png firepage.html fireresult.html head-bg.png head-bg-rev.png honeybee.js honeybee.py logo.png separator.png $directory/hive/etc/modules
cp honeybee.conf $directory/hive/etc
sudo chown -R daemon:daemon $directory/hive/var
sudo chown -R daemon:daemon $directory/hive/etc
exit

~ Step 4 – Avviare Hive e effettuare le ricerche ~
A questo punto, da terminale, spostatevi nella directory dove avete messo il tutto e da lì nella directory ‘hive’. Per avviare Hive vi basterà digitare:

$ ./hive -vfal1

Le opzioni che vedete sono:
-v = verbose: mostra più informazioni.
-f = foreground: fa in modo che hive non venga avviato in background (perciò il terminale deve rimanere aperto).
-a = keep alive: mantiene hive aperto in caso di errori non critici.
-l = loglevel: specifica il grado di informazioni di log che si vuole ricevere (in questo caso 1, cioè il massimo).

Adesso non vi resta che aprire il vostro browser e collegarvi a http://localhost:50007/ e da li sbizzarrirvi nelle ricerche ;)

Per chiudere la sessione di Hive, basta premere Ctrl+C oppure Ctrl+D.

~ Step 5 – Segnalare i bug ~
“Aiuto, un bug cattivissimo si frappone tra me e la mia ricerca, che devo fare?”

Se effettuando le vostre ricerche o mentre visitate un sito tramite hive vi viene restituito un errore, basta segnalarlo sulla pagina di segnalazione bug che BeeSeek ha su Launchpad.

Un paio di cose da ricordare:

~ Step 6 – Passi successivi ~
“Wow, ho davvero voglia di aiutarvi ma…come posso contattarvi, dove trovo informazioni più approfondite?”

Il modo più immediato per contattarci è venirci a trovare in IRC: canale #beeseek.org su irc.freenode.net

Per le informazioni e la documentazione necessarie a soddisfare la vostra sete di sapere ci sono tutti gli strumenti “standard” del caso: wiki, forum e blog.

Vi aspettiamo ;)