Manual:Pywikibot/Installation/ast

 Esta páxina va ayudate nos primeros pasos con Pywikibot, yá sía nel to propiu ordenador, en Toolforge, o usando PAWS: A Web Shell.

  En PAWS PAWS: A Web Shell ye la manera más cenciella d'empezar con Pywikibot. Nun se precisa nenguna instalación, y utilices una interfaz web pa unviar comandos.

 Nel to propiu ordenador Esta páxina ayudaráte colos primeros pasos pa instalar y executar Pywikibot nos tos ordenadores. Esti procesu tien cuatro pasos principales:  En Toolforge Toolforge t'ufre una infraestructura d'agospiamientu estable que te permite executar bots de contino o nun horariu determináu.
 * Instalación de Python.
 * Instalación de Pywikibot.
 * Configuración de Pywikibot.
 * Execución d'un script.

Instalar Python
Descarga ya instala Python dende https://www.python.org/downloads/.

Si yá instalasti Python, comprueba si la to versión ye recién abondo executando  nuna consola. Si tienes instaláu Python 2.7.4 o mayor, o Python 3.4 o mayor, la to versión de Python ye recién abondo. However, Python versions below 3.5 can be dropped in near future. It is strictly recommended to use Python 3.5 or higher.

Modify the path
On Windows systems, even after installing python, the command line interface may not initially know where the python installation is located (although the installer has an option to make it know). In other words, if you enter the command

C:\Users\Joe>python

it may result in the following error:

'python' is not recognized as an internal or external command, operable program or batch file.

To fix this, you need to modify the environment variable named "path" and add the folder which contains "python.exe". On Windows 10, this is under Settings > System > About > System info > Advanced System Settings > Environment Variables. Closing and re-opening the command line, entering "python" should give some information about your current python installation. This same process can be repeated for pip. If you enter the command

C:\Users\Joe>pip

and it displays an error, also add the folder containing "pip.exe" to the path.

Instalar les dependencies
Ríquese un paquete más, llamáu «requests», pa executar Pywikibot. Usa pip, que yá ta instaláu si tienes Python 2.7.9 o mayor, o Python 3.4 o mayor. Executa'l siguiente comandu pa instalar esti paquete:

Instalar Pywikibot
Descargar el Pywikibot actual stable branch: .tar.gz, .zip.

Desempaqueta el ficheru descargáu, por casu en  o en.

Alternativamente, puedes recuperar la última versión usando git o un veceru svn dende Gerrit, consulta. Esta ye la manera encamentada pa que los operadores de bot activos y los desendolcadores usen Pywikibot.

Hai versiones más antigües disponibles en https://tools.wmflabs.org/pywikibot/.

Anovar Pywikibot
Ten actualizada la infraestructura del to bot. Salen nueves versiones de siguío, y tán disponibles nel mesmu llugar.

Si tas usando la versión de git o svn, puedes saltar esta nota. Otramiente, sé consciente de que precises faer copia de los ficheros de configuración y scripts («user-config.py», cualquier ficheru de la familia, o script personalizáu que creares o editares, y cualquier ficheru actual de volcáu XML que teas usando pa una wiki) antes d'instalar una nueva versión.

Desempaqueta la nueva versión sobre la versión antigua, sobreescribiendo tolos ficheros.

Configurar Pywikibot
Abre Terminal nos sistemes tipu-Unix (Linux/BSD/Solaris) o Símbolu del sistema en Windows (xeneralmente baxo les carpetes Sistema Windows o Accesorios del menú Toles aplicaciones o Tolos programes dientro del Menú d'entamu), y cambia de direutoriu a onde estraxisti Pywikibot:


 * Tipu-Unix (Linux/BSD/Solaris):




 * Windows:



Naturalmente, sustituye l'allugamientu pol direutoriu onde desempaquetaste Pywikibot.

Sigue col siguiente comandu pa xenerar el ficheru de configuración d'usuariu:

Sigue les indicaciones pa configurar Pywikibot.

Finalmente, executa'l siguiente comandu p'aniciar sesión na to wiki:

Utilizar en wikis de terceros
Pywikibot ta pre-configuráu pa una gran cantidá de wikis; sicasí, posiblemente non pa la que quies utilizar. Visita pa saber cómo configurar Pywikibot pa la to wiki.

Más opciones de configuración
Pywikibot apurre una amplia gama d'opciones de configuración pa camudar el comportamientu del to bot. Puedes cambiar estes opciones nel ficheru user-config.py. Ver en config2.py la llista de tolos parámetros que puedes usar.

Proxy configuration
Pywikibot relies on  for communicating with the web. You can use  and   environment variables to make requests use a proxy server. Refer to requests' documentation for more info.

Executar un script
Pywikibot trai nel paquete un gran númberu de scripts nel direutoriu scripts. Puedes executar toos estos usando:

La llista de tolos scripts ta disponible en.

Otres dependencies
La mayoría de los scripts nun riquen otros paquetes; sicasí, dalgunos nun funcionarán ensin ellos. La llista d'estos paquetes ta en requirements.txt xunto coles sos dependencies.

Pa instalar les dependencies de dalgún script, usa "pip", y executa'l siguiente comandu:

Alternativamente, executa'l siguiente comandu pa instalar toles dependencies de tolos scripts d'una vegada: