Manual:Guida al bot

From Botwiki

L'utilizzo di un Bot all'interno di questo progetto non implica particolari conoscenze tecniche. Certo è che più sono meglio è, ma tutto è rollbackabile e quindi i danni non saranno mai eccessivi. Ovviamente, in ogni caso, Bot incontrollati verranno bloccati all'istante.

Se però volete usare il Bot su Wikipedia, fate Attenzione! perché questa guida è stata scritta per utenti già esperti di Wikipedia (almeno 1000-1500 edit) che sanno come è fatto il codice di wikipedia (parentesi quadre, apostrofi, ecc...) e che possono usare il bot diligentemente. Ricordate che ogni modifica non è garantita al 100% (anzi) e che spesso si possono presentare degli errori che non sono stati preventivati (parlo per esperienza personale :D ) quindi attenzione! E se non siete sicuri, EVITATE! in quanto non è facile mantenere un bot!

Questa guida è totalmente non-ufficiale. Se volete seguirla avrete gli stessi risultati della ufficiale ma non posso garantire nulla! Eventuali bot distruttori saranno disintegrati all'istante dagli amministratori. Se avete dei problemi segnalatelo qui.

Primo passo: installare Python da qui che è l'interprete dei programmi per Wikipedia.
Scaricare la cartella "pywikipedia", che si può trovare a questo indirizzo, sotto il nome pywikipedia-nightly.tar.bz2
Decomprimere la cartella e salvarla preferibilmente nel percorso "C:\pywikipedia" (ovvero bisogna aprire "Risorse del Computer e mettere la cartella nell'Hard Disk C, quello principale).
Registrare su Wikipedia un account col nome del bot (che facciamo finta sia NOMEbot).
{NB!} Apri il blocco note e digita:

mylang = 'it'
family = 'wikipedia'
usernames['wikipedia']['it'] = 'NOMEBot'
console_encoding = 'cp850'
use_api = True

Ovviamente bisogna sostituire 'NOMEBot' col nome del Bot scelto. Quindi clicca "salva con nome": in "salva come" indica "Tutti i file" e nel nome del file inserisci "user-config.py"; la destinazione è la cartella pywikipedia appena creata.

(Per dettagli vedere qua e se da qualche problema, sostituire il console_encoding con 'cp850' con 'utf-8' o con 'iso-8859-1')

Questa immagine spiega tutto, ingranditela per vedere meglio.

{NB!} Ora, clicca su start, esegui e scrivi (nella finestra esegui) "cmd" per aprire il DOS, e digitare cd C:\pywikipedia dove cd sta per "Change Directory" e serve per "navigare nel DOS" (bisogna farlo ogni volta che si apre la finestra DOS) e clicca Invio. Ora devi loggare il bot: digita login.py (sempre nel DOS). Verrà richiesta la password: basta inserirla, prestando attenzione perché non compare, per la privacy e perché probabilmente troppi copia/incolla hanno rivelato "troppe" informazioni ;-). Il Login è necessario una volta sola in quanto il programma carica i cookie e li salva per poterli riutilizzare in seguito.
Puoi iniziare a provare ad usare il bot, per esempio facendo delle sostituzioni di testo tipo da "perchè" a "perché" o simili. Trovi un elenco di comandi standard qui (un'altra lista utile la puoi trovare qui).
Importante: è necessario richiedere lo status di bot, in questa pagina (per it.wikipedia, chiedente nel vostro progetto se non riuscite a trovarne una equivalente) altrimenti gli amministratori bloccheranno subito il Bot.
{NB!} Se volete fermare il bot, selezionate la finestra del bot (se è già selezionata non serve) e digitate "ctrl+c" (assieme, in contemporanea, magari un attimo prima ctrl).

{NB!} Per la pagina utente del bot date pure un'occhiata alla mia (cercate però di non copiarmela spudoratamente ;-)) e alla pagina di aiuto per altri comandi.

Se avete creato il vostro bot con questa guida, inserite, se volete, il nome del vostro Bot in questa pagina ;-)

Se avete problemi e non mi trovate, potete visitare questi due canali:

#botolatori @ irc.eu.freenode.net quello italiano
#pywikipediabot @ irc.eu.freenode.net quello internazionale

[edit] Settare il Bot per Botwiki

Il software pywikipedia può essere fatto funzionare anche su progetti wiki non predefiniti. Un esempio è mozilla.org o questo sito, per l'appunto. Per fare ciò bisogna aggiungere uno script in più al set normale per definire la "nuova famiglia" creata (per famiglia si intende, per esempio, "Wikipedia, Wikiquote, ecc.")

Per fortuna, da poco, Misza13 ha inserito direttamente nel framework ufficiale di pywikipedia, la famiglia di botwiki! :-) Perciò, basta settare il bot con i parametri che seguono e sieti a posto ^_-

mylang = 'botwiki'
family = 'botwiki'
usernames['botwiki']['botwiki'] = 'NOMEBot'
console_encoding = 'cp850'
use_api = True

Questo perché, come commons, non c'è una lingua ufficiale in quanto il progetto è multilingua. Perciò dovete inserire botwiki anche nella lingua (sebbene possa sembrare strano).