Tutorial de bots/Descarga del bot

De Wikilibros, la colección de libros de texto de contenido libre.

El último paso es descargar el código del bot, llamado pywikipedia. Puede obtenerse el paquete completo en Sourceforge, pero la versión que encontraras no será la más reciente. No obstante es la forma más sencilla de hacerse con el código. Si deseas obtener la última versión, tendrás que descargártela mediante es:Subversion

Contenido 1 Sistemas tipo UNIX 1.1 Usando CVS 1.2 Usando SVN 2 Microsoft Windows 2.1 Software 2.1.1 Python 2.1.2 CVS 2.2 Descargando el bot 2.3 Abriendo el bot 3 Antes de empezar 3.1 Bibliotecarios

[editar] Sistemas tipo UNIX

[editar] Usando CVS

Colócate en el directorio en el cual quieras instalar el código del bot. Asegúrate de que tengas permisos de escritura en él, asegúrate también que tienes instalado cvs.

Para registrarte en el servidor CVS, escribe:

$ cvs -d :pserver:anonymous@pywikipediabot.cvs.sourceforge.net:/cvsroot/pywikipediabot login
Password: <ENTER>

Para descargar el código, escribe:

$ cvs -d :pserver:anonymous@pywikipediabot.cvs.sourceforge.net:/cvsroot/pywikipediabot co pywikipedia

Si deseas actualizar el código de un bot ya instalado, colócate en la carpeta pywikipedia y escribe:

$ cvs up

Para ejecutar un programa en python desde consola se debe entrar en el directorio correspondiente y poner python <comando> Por ejemplo:

$ python login.py

[editar] Usando SVN

Si tiene SVN instalado entonces ejecute los siguientes comandos en un terminal, situandose en un directorio donde descargará el código:

$svn checkout http://svn.wikimedia.org/svnroot/pywikipedia/trunk/pywikipedia/

[editar] Microsoft Windows

Utilizar el bot pywikipedia diseñado y proporcionado por otros wikipedistas como tú y yo es muy fácil. Esto es un pequeño tutorial para los usuarios del sistema operativo Windows. Siempre que sea posible, usaremos programas que tienen interfaces gráficas de usuario y con instrucciones sencillas.

[editar] Software

Hay dos programas no estándar de Windows que se necesitan para ejecutar el bot:

1. El lenguaje de programación Python
2. Una herramienta de CVS

[editar] Python

El bot pywikipedia está escrito en Python, así que para que tu computadora entienda los scripts, necesitas tener instalada una versión de Python. Para ello, puedes hacer clic aquí y seguir las instrucciones de instalación facilitadas por el programa de instalación.

[editar] CVS

CVS es un método para bajar archivos directamente de un servidor específico a tu computadora. La herramienta facilitará la descarga al igual que la actualización. Además, garantiza que bajes siempre la versión más reciente del paquete de bots, ya que casi todos los días se modifica. Para este tutorial, usaremos TortoiseCVS por su instalador GUI y su funcionamiento simple. Para bajarlo, haz clic aquí y selecciona el servidor local que más te convenga. Ahora que lo has bajado, instálalo siguiendo las instrucciones.

En el caso de que hayas instalado el cliente de línea de órdenes de cvs, puedes seguir las instrucciones detalladas para UNIX más arriba.

[editar] Descargando el bot

La instalación del bot en tu sistema es un proceso un poco más complejo:

1. Elige, usando el explorador de Windows, la carpeta en la que quieres instalar el paquete
2. Haz un clic con el botón derecho en dicha carpeta
3. Si has instalado TortoiseCVS correctamente, te aparecerá la opción "CVS Checkout...", que es la que tiene el icono de una tortuga. Haz clic en esa opción y te aperecerá una ventana muy, pero que muy confusa.
4. De la primera caja de texto, "CVSROOT", no te preocupes, irá llenándose solita.
5. En la segunda, "Protocol:", selecciona "Password server (:pserver:)"
6. Salta la tercera "Protol parameters:", no es pertinente
7. La cuarta, "Server:", es muy importante. Aquí, escribe "pywikipediabot.cvs.sourceforge.net" exactamente así, sin ninguna modificación.
8. Salta la quinta, "Port:"
9. "Repository folder:" también es importante. Aquí vas a escribir "/cvsroot/pywikipediabot", precisamente.
10. En "User name:" tienes que escribir "anonymous".
11. Ahora la última, "Module:", aquí escribe "pywikipedia"
12. Y ahora haces clic en "OK"
13. Si has hecho todo bien, aparece otra ventana con mucho texto verde a la que no debes hacer caso.

Ahora tienes el bot en la carpeta que elegiste cuando hiciste el checkout. Celébralo, que eso fue lo más difícil.

[editar] Abriendo el bot

Si abres la carpeta en la que tienes tu bot y haces clic en las diversas funciones te aparece brevemente una pantalla de fondo negro y texto blanco y luego desaparece. Qué tontería, ¿no?. Para hacer funcionar el bot con más eficacia hay un proceso mucho mejor.

1. Haz clic en "inicio" o "Start"
2. Elige "ejecutar..." o "run..."
3. Teclea en la caja de texto "cmd.exe" o "command.com", dependiendo de la versión de Windows que tengas; intenta los dos.
4. Te aparece una ventana con fondo negro y texto blanco de la que probablemente no entiendes ni madres. No te preocupes, no es necesario entenderla.
5. Suponiendo que tienes un solo disco duro, teclea "cd \"
6. Ahora, estás en la raíz de tu disco duro, desde donde puedes ir a cualquier otra carpeta.
7. De acuerdo, tienes que ir a la carpeta en la que tienes tu bot usando la orden "cd"; esta carpeta varía de un usuario a otro. Teclea "cd carpeta donde está tu bot".
8. Desde ahí, puedes teclear "interwiki.py", o "replace.py", o lo que sea. Sólo tienes que añadir ".py" al título del bot.

[editar] Antes de empezar

Ahora tienes todo lo que necesitas menos una cosita, tu fichero de usuario, donde configurarás el nombre de tu bot y el proyecto con el que estés trabajando:

1. Abre el bloc de notas o algo parecido.
2. En la primera línea (sin texto en negrita, formato, estilo, ni nada así) escribe:

family= 'wikipedia'
mylang = 'es'

Se supone que vas a estar usando el bot en es.wikipedia. Si no es así, puedes cambiar "es" por cualquier otro dominio; por ejemplo: en, eo, it, fr... y sino estás trabajando en Wikipedia, puedes cambiar 'wikipedia' por otro nombre de proyecto como ser wikibooks', 'wiktionary', etc.

3. En las siguientes líneas escribe

usernames['wikipedia']['es'] = 'TUNOMBREDEUSUARIO'

4. Agregar en la línea siguiente

use_api = True 

reemplazando "TUNOMBREDEUSUARIO" por tu verdadero nombre de usuario, el que está registrado como bot, preferiblemente. Puedes añadir más de un dominio, continuando en las siguientes líneas y modificando los valores pertinentes. De esta forma cada vez que quieras identificarte tendrás que especificar el proyecto y el idioma, como se explica en login.py

[editar] Bibliotecarios

Para aquellos bibliotecarios que deseen dar a su bot permisos de bibliotecario para borrar páginas (redirecciones rotas, etc) deben añadir a continuación:

sysopnames['wikibooks']['es'] = 'TUNOMBREDEUSUARIO'

Deberás iniciar la sesión con tu nombre de bibliotecario solamente cuando quieras dar permisos especiales a tu Bot. NOTA: Usa con cuidado los derechos de bibliotecario. Puedes armar un buen lío.

1. Guarda el documento que acabas de crear con el bloc de notas como "user-config.py" en la misma carpeta que están todos tus bots.
2. Ahora, en la ventana famosa negra de texto blanco, escribe "login.py" (asegúrate que estás en la carpeta correcta). Te pide la contraseña y se la das.

• NOTA: Cuando tecleas la contraseña no aparecen las letras, ni asteriscos, nada. Ten por seguro, sin embargo, que todo cuenta (mayúsculas, espacios, bloqueo de mayúsculas, etc.). Si tecleas la contraseña mal, lo mejor que puedes hacer es presionar CTRL+C. De esta forma no es necesario volver a abrir la ventana de comandos, cancela todo y puedes volver a usar la orden "login.py".