Manual:Pywikibot/Instalación

From MediaWiki.org
Jump to navigation Jump to search
This page is a translated version of the page Manual:Pywikibot/Installation and the translation is 86% complete.

Outdated translations are marked like this.
Other languages:
Bahasa Indonesia • ‎Deutsch • ‎English • ‎Lëtzebuergesch • ‎Nederlands • ‎asturianu • ‎català • ‎dansk • ‎español • ‎français • ‎italiano • ‎norsk nynorsk • ‎polski • ‎português do Brasil • ‎suomi • ‎čeština • ‎Ελληνικά • ‎български • ‎русский • ‎українська • ‎עברית • ‎العربية • ‎فارسی • ‎ไทย • ‎中文 • ‎日本語 • ‎한국어
Gnome-system-software-installer.svg
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
Unicorn paw logo.svg

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
Computer n screen.svg

Esta páxina ayudaráte colos primeros pasos pa instalar y executar Pywikibot nos tos ordenadores. Esti procesu tien cuatro pasos principales:

Toolforge logo.svg

Toolforge t'ufre una infraestructura d'agospiamientu estable que te permite executar bots de contino o nun horariu determináu.

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 python --version 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:

$ pip install requests

Instalar Pywikibot

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

Desempaqueta el ficheru descargáu, por casu en /home/username/pywikibot o en c:\users\username\pywikibot.

Alternativamente, puedes recuperar la última versión usando git o un veceru svn dende Gerrit, consulta Manual:Pywikibot/Gerrit#For users . 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):
$ cd ~/pywikibot
Windows:
$ c:
$ cd "\Users\username\pywikibot"

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

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

$ python pwb.py generate_user_files

Sigue les indicaciones pa configurar Pywikibot.

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

$ python pwb.py login

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 Manual:Pywikibot/Use on third-party wikis 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 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.

Executar un script

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

$ python pwb.py [name of the script]

La llista de tolos scripts ta disponible en Manual:Pywikibot/Scripts .

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:

$ pip install [name of the package]

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

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