Manual:Pywikibot/Instalación
A continuación encontrarás un manual que te ayudará a comenzar con la instalación y a ejecutar Pywikibot en tu ordenador. Este proceso tiene cuatro pasos principales:
Toolforge te proporciona una infraestructura de alojamiento estable en la nube que te permite ejecutar tus bots continuamente o en un horario determinado.
Instalar Python
Descarga e instalar Python desde https://www.python.org/downloads/.
Make absolutely certain that you check the box at the bottom of the install wizard asking if you want to add Python to PATH!
That will allow you to access Python from any command prompt just by typing the keyword python.
Si ya has instalado Python, comprueba si tu versión es lo suficientemente reciente ejecutando python --version en una consola.
Para saber si está instalada la versión 3 o superior de Python, ejecute python3 --version en una consola.
Ubuntu 19.04 y superiores vienen con las versiones 2 y 3 instaladas.
Python v2 se ejecuta por defecto utilizando el comando de terminal python; para utilizar v3, utilice el comando de terminal python3.
Python 3.7 or higher is currently required to run the bot, but Python 3.8 or higher is recommended. En Windows, no olvide modificar la variable de entorno PATH para que Python y pip funcionen correctamente.
Instalar dependencias
Se requieren paquetes adicionales para ejecutar Pywikibot. Ejecute el siguiente comando para instalar estos paquetes:
$ python -m pip install "requests>=2.20.1"
$ python -m pip install "mwparserfromhell>=0.5.2"
$ python -m pip install packaging
Para Python 3.7 se requiere un paquete adicional. Instálalo con:
$ python -m pip install importlib_metadata
Se puede instalar un analizador de marcado MediaWiki alternativo con:
$ python -m pip install "wikitextparser>=0.47.5"
See also https://doc.wikimedia.org/pywikibot/stable/introduction.html#quick-start
Instalar Pywikibot
$ python -m pip install pywikibot
Si utiliza pip, utilice pwb en lugar de python pwb.py en los ejemplos siguientes.
Descargar versión actual de Pywikibot stable: .zip.
Desempaqueta el archivo descargado, por ejemplo en ~/pywikibot o %USERPROFILE%\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 ~/core
- Windows:
$ c: $ cd "%USERPROFILE%\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 config.py para una lista de todos los parámetros que puedes usar.
Configuración del proxy
Pywikibot se basa en requests para comunicarse con la web.
Puede utilizar las variables de entorno HTTP_PROXY y HTTPS_PROXY para que las peticiones utilicen un servidor proxy.
Consulte la documentación de las solicitudes para obtener más información.
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]
Para saber más sobre la ejecución de scripts básicos de Pywikibot, consulte:
- Pequeño taller de herramientas wiki sobre la ejecución de scripts básicos de Pywikibot
- Materiales de autoaprendizaje basados en el taller sobre pequeñas herramientas wiki
- Manual del taller basado en el taller sobre pequeñas herramientas wiki
Hay una lista con todos los scripts disponibles en Manual:Pywikibot/Scripts and doc.wikimedia.org/pywikibot.
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:
$ python -m pip install [name of the package]
Alternativamente, ejecuta el siguiente comando para instalar todas las dependencias de todos los scripts en una vez:
$ python -m pip install -r requirements.txt
- If you need more help on setting up your Pywikibot visit the #pywikibot IRC channel connect or pywikibot@ mailing list.