# Tutorial de bots/Descarregar el bot

El mètode més senzill és descarregar el codi de pywikipedia des de sourceforge (enllaç). Tot i això, aquesta no acostuma a ser la versió més nova del bot, així que si el que busques és la versió més recent, utilitza Subversion.
Un cop descarregat, la instal·lació dependrà del tipus de sistema operatiu que utilitzis. Aquí explicarem els passos a seguir per sistemes tipus UNIX i Windows.

## Sistemes UNIX i semblants (GNU/Linux)

* ACTUALITZACIó 20.02.2011: Millor SVN: http://pywikipediabot.sourceforge.net
Accedeix al directori a on vols instal·lar el codi del bot. Assegura't que en tens els permisos d'escriptura, i també que tens instal·lat cvs.
Per registrar-te al servidor CVS, has d'escriure:
Per a descarregar el codi, escriu:
Si el que vols és actualitzar el codi d'un bot ja instal·lat, col·loca't a la carpeta pywikipedia i tecleja:
Per a executar un programa en python des de la consola, s'ha d'entrar al directori corresponent i escriure python <programa>. Per exemple:

## Programari

Hi ha dos programes necessaris per al bot que no es troben per defecte al sistema operatiu:
* El llenguatge de programació Python: és el que utilitza aquest bot, així que perquè el teu ordinador el pugui entendre caldrà que tinguis instal·lada una versió del llenguatge. Si no la tens, pots seguir les instruccions per aconseguir-lo aquí.
* Les eines CVS: són un mètode per descarrega arxius d'un servidor específic directament a l'ordinador. L'eina facilitarà la descàrrega i l'actualització. A més, garanteix que descarregarem la versió més recent del paquet de bots, perquè gairebé cada dia es modifica. Pel tutorial, ens centrarem en TortoiseCVS, degut al seu instal·lador GUI i el seu funcionament simple (el pots descarregar aquí i seleccionar el servidor local que més et convingui. Un cop descarregat, instal·la'l seguint les instruccions. En el cas que hagis instal·lat el cient de línia d'ordres de CVS, pots seguir amb el protoclo d'instal·lació per a UNIX.

### Instal·lació del bot

La instal·lació del bot és un procés una mica complexa:
* Escull, mitjançant l'explorador de Windows, la carpeta on hi vols instal·lar el paquet.
* Fes un clic amb el botó secundari (normalment, el dret) a la carpeta.
* Si has instal·lat TortoiseCVS correctament, t'apareixerà l'opció "CVS Checkout...", que té una tortuga per icona. Tria aquesta opció i t'apareixerà una finestra que, t'ho avisem, és molt i molt confosa.
** De la primera caixa de text, "CVSROOT", no te'n preocupis, s'omplirà soleta.
** A la segona, "Protocol:", selecciona "Password server (:pserver:)"
** Salta't la tercera ("Protol parameters:"), és prescindible.
** La quarta, "Server:", és molt important. Hi has d'escriure exactament "pywikipediabot.cvs.sourceforge.net" sense cap modificació.
** Salta't la cinquena ("Port:")
** "Repository folder:" també és important. Hi has d'escriure "/cvsroot/pywikipediabot".
** A "User name:" hi has d'escriure "anonymous".
** Per últim, a "Module:",hi has d'escriure "pywikipedia"
* Accepta ("OK").
* Si ho has fet tot correctament, apareixerà una altra finestra amb molt text verd. No l'hi facis cas.
Arribats a aquest punt, el bot es troba a la carpeta especificada (Repository Folder). Pots respirar una mica, aquesta part era la més complicada que et trobaràs.

### Obrint el bot

Si obres la carpeta que conté el teu bot i executes les diverses funcions, només apareixerà una breu pantalla de fons negre i text blanc, que dexapareixerà aviat. Sembla una mica absurd, oi? El bot es pot executar amb més eficiència utilitzant un procés més adequat:
* Fes clic al botó "inicia" ("inicio" o "Start")
** En algunes versions, hi podràs accedir a través de l'administrador de tasques (pel comandament ctrl + alt + supr )
* Escull l'opció "Executa..." o "run..."
* Tecleja a la caixa de text "cmd.exe" o "command.com"; serà un dels dos segons quina distribució tinguis. Pots provar les dues.
* T'apareixerà una finestreta de fons negre i text blanc, on pot ser que no entenguis res. Si és així tranquil·litza't, no t'hi hauràs de barallar.
* Suposant que tinguis un sol disc dur, tecleja "cd \"
* Ara et trobes a l'arrel (root) del teu disc dur, des d'on pots accedir a qualsevol carpeta.
* Ara has d'arribar a la carpeta on hi tens el bot. Tecleja "cd nomdecarpeta" i accepta. Repeteix el procés els cops que sigui necessari per arribar a la subcarpeta on hi tens el bot.
* Un cop ets a la carpeta en qüestió, tecleja "interwiki.py", o "replace.py", o com es digui el bot. Tan sols cal que el seu nom acabi amb ".py".

## Consideracions prèvies

En aquests moments tan sols et falta una cosa: el teu fitxer d'usuari, on configuraràs el nom del teu bot i el projecte on estàs treballant:
* Obre el bloc de notes (o algun programa semblant, d'edició senzilla de text)
* A la primera línia escriu el següent codi
       Amb aquest text, el bot funcionarà en el domini ca.wikipedia. Si vols fer-lo funcionar en algun altre projecte, tan sols has de substituir wikipedia o ca per un altre projecte germà i/o una altra llengua respectivament. Recorda que has d'utilitzar els noms de la direcció web: si per exemple vols editar a viquillibres en italià, hi hauràs d'escriure wikibooks i it.
    3.
A continuació, escriu
posant a usuari el nom que tens registrat com a bot (per exemple, Iradibot). Existeix la possibilitat d'afegir més d'un domini, repetint el mateix format en les línies següents. D'aquesta forma, cada cop que et vulguis identificar hauràs d'especificar el projecte i l'idioma, tal com s'explica a login.py
    4. Guarda el document que acabes de crear com a user-config.py i desa'l a la mateixa carpeta on hi tens la resta de bots.
    5. Ara, a la finestra negra de text blanc, escriu login.py (sempre assegura't de trobar-te a la carpeta correcta). Et demanarà la contrasenya, li has de donar. Nota: quan teclegis la contrasenya no apareixeran ni lletres ni asteriscos. Però tingues en compte que tot el que teclegis comptarà (majúscules, espais,...).Si tecleges malament la contrasenya, el millor que pots fer és teclejar ctrl+c, que farà que puguis teclejar la contrasenya de nou, sense haver de cancel·lar-ho tot.

### Administradors

Si ets administrador i li vols atorgar al teu bot el permís per esborrar pàgines (com per exemple redireccions trencades), has d'afegir el següent codi a continuació de l'anterior:
Hauràs d'iniciar sessió amb el teu nom d'administrador només quan vulguis donar els permisos especials al teu bot. Nota: utilitza amb precaució els drets d'administrador. Podries generar un bon embolic.