Manual:Pywikibot/Instalación

From mediawiki.org
This page is a translated version of the page Manual:Pywikibot/Installation and the translation is 80% complete.
Outdated translations are marked like this.
Esta página te ayudará a comenzar con Pywikibot, ya sea en su propia computadora, en Toolforge o utilizando Pywikibot: A Web Shell (PAWS).
En PAWS

PAWS: A Web Shell es la manera más sencilla de empezar con Pywikibot. No es necesaria ninguna instalación y utilizas una interfaz web para enviar comandos.

En tu propio ordenador

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/.

Si ya has instalado Python, comprueba si tu versión es lo suficientemente reciente ejecutando python --version en una consola. To discover if Python version 3 or above is installed, run python3 --version in a console.

Ubuntu 19.04 and up comes with versions 2 & 3 installed. Python v2 runs by default using terminal command python; to use v3, use terminal command python3.

Python 3.7 or higher is currently required to run the bot. En Windows, no olvide modificar la variable de entorno PATH para que Python y pip funcionen correctamente.

Instalar dependencias

Additional packages are required to run Pywikibot. Run the following command to install these packages:

$ python -m pip install "requests>=2.20.1"
$ python -m pip install "mwparserfromhell>=0.5.2"
$ python -m pip install packaging

For Python 3.7 an additional package is required. Install it with:

$ python -m pip install importlib_metadata

An alternate MediaWiki markup parser may be installed with:

$ 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

If using pip, use pwb instead of python pwb.py in examples below.

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]

To learn more about running basic Pywikibot scripts, see:

Hay una lista con todos los scripts disponibles en $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:

$ 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.