Manual:Pywikibot/Instalación
Esta página te ayudará a comenzar con la instalación y a ejecutar Pywikibot en tu ordenador. Este proceso tiene cuatro pasos principales:
 |
| Pywikibot |
|---|
|
Instalar Python
Descarga e instalar Python desde https://www.python.org/downloads/.
Si ya has instalado Python, comprueba si tu versión es lo suficientemente reciente ejecutando python --version en una consola.
Si tienes Python $py2 o superior, o Python $py3 o superior instalado, tu versión es suficientemente reciente.
Sin embargo, las versiones de Python inferiores a 3.5 se pueden eliminar en un futuro. Se recomienda estrictamente usar Python 3.5 o superior.
En Windows, no olvide modificar la variable de entorno PATH para que Python y pip funcionen correctamente.
Instalar dependencias
Un paquete adicional llamado "requests" se requiere para ejecutar Pywikibot. Usa pip, que ya está instalado si tienes Python 2.7.9 o superior, o Python 3.4 o superior. Ejecuta el siguiente comando para instalar este paquete:
$ pip install "requests>=2.20.1"
For Python 2.7 additional packages are mandatory:
$ pip install "enum34>=1.1.6!=1.1.8"
$ pip install ipaddress
$ pip install pathlib2
Instalar Pywikibot
Python 2.7 users should download the stable python2 branch: .tar.gz, .zip instead.
Desempaqueta el archivo descargado, por ejemplo en ~/pywikibot o C:\Users\username\pywikibot.
Alternativamente, puedes recuperar la última versión usando git o un cliente svn desde Gerrit, véase Manual:Pywikibot/Gerrit#For users. Esta es la manera recomendada para que los operadores de bot activos y desarrolladores usen Pywikibot.
Otras versiones están disponibles en https://pywikibot.toolforge.org/.
Actualizando Pywikibot
Mantén el framework de tu bot actualizado. Salen nuevas versiones continuamente, y están disponibles en la misma ubicación.
Si estás usando git o svn, puedes saltarte está nota. De la contrario, sé consciente de que necesitas hacer un backup de tus archivos de configuración y scripts ("user-config.py", cualquier archivo familiar, o script personalizado que hayas creado o modificado, y cualquier archvo de volcado XML que estés usando en una wiki) antes de instalar una nueva actualización.
Desempaqueta la nueva versión sobre la versión antigua, sobrescribiendo todos los archivos.
Configuración de Pywikibot
Abre Terminal en un sistema operativo tipo-Unix (Linux/BSD/Solaris) o Símbolo del sistema en Windows (generalmente debajo de Sistema Windows o la carpeta Accesorios en el menú Todas las aplicaciones o Todos los programas dentro del menú de inicio), y cambia el directorio a donde extrajiste Pywikibot:
- Tipo-Unix (Linux/BSD/Solaris):
$ cd ~/pywikibot
- Windows:
$ c: $ cd "\Users\username\pywikibot"
Por supuesto, sustituye la ubicación donde desempaquetaste Pywikibot.
Continua con el siguiente comando para generar el archivo de configuración de usuario:
$ python pwb.py generate_user_files
Sigue las indicaciones para configurar Pywikibot.
Finalmente ejecuta el siguiente comando para identificarte en tu wiki:
$ python pwb.py login
Utilizar en wikis de terceros
Pywikibot está pee-configurado para una gran cantidad de wikis, sin embargo, posiblemente no para la que quieres utilizar. Véase Manual:Pywikibot/Use on third-party wikis para cómo configurar Pywikibot para tu wiki.
Más opciones de configuración
Pywikibot proporciona una amplia gama de opciones de configuración para cambiar el comportamiento de tu bot. Puedes cambiar estas opciones en tu archivo 'user-config.py'. Véase config2.py para una lista de todos los parámetros que puedes usar.
Proxy configuration
Pywikibot relies on requests for communicating with the web.
You can use HTTP_PROXY and HTTPS_PROXY environment variables to make requests use a proxy server.
Refer to requests' documentation for more info.
Ejecutando un script
Pywikibot trae consigo un gran número de scripts en la carpeta scripts. Puedes ejecutar todos estos usando
$ python pwb.py [name of the script]
Hay una lista con todos los scripts disponibles en Manual:Pywikibot/Scripts.
Otras dependencias
La mayoría de los scripts no requieren paquetes adicionales, sin embargo, algunos no funcionarán sin ellos. Estos paquetes están listados en requirements.txt junto con sus dependencias.
Para instalar dependencias, usa "pip", y ejecuta el siguiente comando:
$ pip install [name of the package]
Alternativamente, ejecuta el siguiente comando para instalar todas las dependencias de todos los scripts en una vez:
$ pip install -r requirements.txt
- If you need more help on setting up your Pywikibot visit the #pywikibot IRC channel conectar or pywikibot@ mailing list.