|
Este tutorial explica como instalar y utilizar el sistema de [[Wikipedia:bots|bots]] del proyecto de [http://pywikipedia.sourceforge.net pywikipedia] para automatizar o simplificar tareas de edición en cualquier proyecto de Wikimedia. El tutorial intenta dar una introducción al uso del bot para realizar automáticamente numerosas ediciones, y da por sentado que el usuario ya está familiarizado con la interfaz de Wikipedia y las convenciones de la misma. Si necesitas ayuda en este sentido, por favor, consulta [[Manual de edición wiki]] y [[Wikilibros:Manual de Estilo]] antes de comenzar.
==Preliminares==
*[[Tutorial de bots/Programas necesarios|Programas necesarios]]
===Python===
*[[Tutorial de bots/Instalación y pasos previos|Instalación y pasos previos]]
*[[Tutorial de bots/Descarga del bot|Descargar el bot]]
El sistema de bots de pywikipedia está escrito en [[Python]]. Si bien el entorno de programación de Python es standard en la mayoría de las distribuciones de Linux, normalmente no está instalado en los equipos que corren Microsoft Windows. Es necesario disponer de la versión 2.3 o posterior para emplear el bot.
*[[Tutorial de bots/Usar pywikipedia|Usar pywikipediabot]]
Para comprobar si Python está instalado, abre una consola y escribe:
$ python -V
Si Python está instalado, recibirás un mensaje como:
$ python -V
Python 2.3.5
Si, por el contrario, la orden arroja un error de programa no encontrado o similar, probablemente no cuentes con Python, y necesitarás descargarlo. Sigue las instrucciones correspondientes a tu sistema operativo para hacerlo.
====Sistemas tipo UNIX====
Para compilar e instalar Python desde código fuente, puedes descargar un tarball comprimido de http://www.python.org/download/.
Es posible que exista un paquete precompilado para tu distribución. Consulta el archivo de software de la misma para asegurarte de ello.
=====Debian GNU/Linux=====
Debian dispone de una versión adecuada de Python desde la versión 3.0, ''Woody''. Para instalarla, sencillamente escribe
# apt-get install python2.3
=====Fedora y similares=====
Hay paquetes RPM actualizados en [http://www.python.org/2.4.1/rpms.html el sitio web de Python].
====Mac OS X====
Los usuarios de Mac OS X pueden optar por compilar su propio Python, al igual que en cualquier otra versión de UNIX o descargar el instalador automático del sitio de Python. Si optas por esta última opción, ten en cuenta que la última versión para la que está disponible es la 2.3.1; podrás correr el bot de pywikipedia, pero no estarás completamente actualizado.
====Microsoft Windows====
La última versión de Python está disponible [http://www.python.org/download/releases/ aquí] en un instalador de Windows. Descarga el programa y sigue las instrucciones en pantalla para instalar Python en tu equipo.
===CVS===
El código fuente del sistema de bots se actualiza constantemente; por ello, no está disponible para su descarga por FTP o desde un sitio web. Para poder descargar y actualizar tu versión del código de pywikipedia, deberás disponer de un cliente CVS, un sistema diseñado para mantener actualizados repositorios de software.
====Sistemas tipo UNIX====
CVS es parte de la mayoría de las instalaciones de sistemas UNIX. En caso de que no estuviera instalado, en https://www.cvshome.org/ están disponibles tarballs del código fuente.
====Microsoft Windows====
Existen varios clientes de CVS para Windows; si bien está disponible una versión del código original en https://www.cvshome.org/, puede ser más sencillo emplear un cliente gráfico como [http://www.tortoisecvs.org/ TortoiseCVS]. Para instalarlo, descarga la última versión y sigue las instrucciones del instalador.
===pywikipedia===
El último paso es descargar el código del bot.
====Sistemas tipo UNIX====
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.
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 <code>pywikipedia</code> y escribe:
$ cvs up
====Microsoft Windows====
Si has instalado el cliente de línea de órdenes de cvs, puedes seguir las instrucciones detalladas para UNIX más arriba.
Si, en cambio, empleas TortoiseCVS, sigue los
----
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.
== Software ==
Hay dos programas no estándar de Windows que se necesitan para ejecutar el bot:
#El lenguaje de programación Python
#Una herramienta de CVS
===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 [http://www.python.org/ftp/python/2.4.1/python-2.4.1.msi aquí] y seguir las instrucciones de instalación facilitadas por el programa de instalación.
===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 [http://www.tortoisecvs.org/ TortoiseCVS] por su instalador GUI y su funcionamiento simple. Para bajarlo, haz clic [http://prdownloads.sourceforge.net/tortoisecvs/TortoiseCVS-1.8.14.exe aquí] y selecciona el servidor local que más te convenga. Ahora que lo has bajado, instálalo siguiendo las instrucciones.
==Descargando el bot==
La instalación del bot en tu sistema es un proceso un poco más complejo:
# Elige, usando el explorador de Windows, la carpeta en la que quieres instalar el paquete
#Haz un clic con el botón derecho en dicha carpeta
#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.
#De la primera caja de texto, "CVSROOT", no te preocupes, irá llenándose solita.
#En la segunda, "Protocol:", selecciona "Password server (:pserver:)
#Salta la tercera "Protol parameters:", no es pertinente
#La cuarta, "Server:", es muy importante. Aquí, escribe "pywikipediabot.cvs.sourceforge.net" exactamente así, sin ninguna modificación.
#Salta la quinta, "Port:"
#"Repository folder:" también es importante. Aquí vas a escribir "/cvsroot/pywikipediabot", precisamente.
#En "User name:" tienes que escribir "anonymous".
#Ahora la última, "Module:", aquí escribe "pywikipedia"
#Y ahora haces clic en "OK"
#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. ¡¡joy!!
== 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.
#Haz clic en "inicio" o "Start"
#Elige "ejecutar..." o "run..."
#Teclea en la caja de texto "cmd.exe" o "command.com", dependiendo de la versión de Windows que tengas; intenta los dos.
#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.
#Suponiendo que tienes un solo disco duro, teclea "cd \"
#Ahora, estás en la raíz de tu disco duro, desde donde puedes ir a cualquier otra carpeta.
#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''".
#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.
==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 la wikipedia con la que estás trabajando:
#Abre el bloc de notas o algo parecido.
#En la primera línea (sin texto en negrita, formato, estilo, ni nada así) escribe <code>"mylang = 'es'</code>". 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...
#En la segunda línea escribe <code>"usernames['wikipedia']['es'] = 'TUNOMBREDEUSUARIO'</code>" reemplazando "TUNOMBREDEUSUARIO" por tu verdadero nombre de usuario, el que está registrado como bot, preferiblemente.
#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.
#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, CAPSLOCK, etc.). Si tecleas la contraseña mal, lo mejor que hacer es presionar CTRL+C. Cancela todo y puedes volver a usar la orden "login.py".
== ¿Qué hace cada bot?==
Cada bot se puede abrir con un editor de texto (Bloc de notas, IDLE, Word, etc.) y se encontrará casi siempre una breve descripción sobre qué es lo que hace el bot y cual es la sintaxis correcta.
== Interwiki.py ==
Interwiki.py es un bot diseñado para verificar que todos los enlaces interlingüísticos existan y sean correctos. Es un bot muy fácil utilizar y de los más populares. No es muy divertido, pero el proceso es simple:
===Una sola página===
Lo más fácil (y menos útil) es comprobar una sola página:
#En la pantalla negra teclea interwiki.py (otra vez, asegúrate que estés en la carpeta correcta)
#Te pregunta qué página quieres checar <!--checar cuesta entenderlo en España. ¿"Verificar", "probar", "analizar"...?-->(Which page to check: )
#Tecleas el título de la página (ej: Helen Keller)
#Checa todo y te pregunta si tiene dudas y si no hay nada que hacer te dice "No changes needed"
===Más de una página===
Para comprobar más de una página, se complica un poco el proceso: tienes que usar parámetros:
*'''-start:''' especifica dónde comenzar, por orden alfabético.
*'''-autonomous''' hace que el bot opere solito, poniendo todas sus dudas en un documento en tu computadora.
*'''-continue''' Continúa desde la última página que se verificó antes de que se detuviera el bot.
Entonces para checar todas las páginas, sin que te haga preguntas o te pida confirmaciones, darías la orden "interwiki.py -start:! -autonomous"
Si quisieras checar todas las páginas empezando con la letra "B", darías la orden "interwiki.py -start:B"
:*NOTA: Con esta última orden, el bot te va a pedir confirmaciones porque no has puesto -autonomous. Te preguntará cuál es el enlace correcto si encuentra dos interwikis enlazados al mismo idioma.
| 