Manual:Pywikibot/Instalación
Esta páxina ayudaráte colos primeros pasos pa instalar y executar Pywikibot nos tos ordenadores. Esti procesu tien cuatro pasos principales:
Instalar Python
Descarga ya instala Python dende 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 yá instalasti Python, comprueba si la to versión ye recién abondo executando python --version nuna 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, but Python 3.8 or higher is recommended.
On Windows please do not forget to modify PATH environment variable to make Python and pip work properly.
Instalar les dependencies
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.
Desempaqueta el ficheru descargáu, por casu en ~/pywikibot o en %USERPROFILE%\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://pywikibot.toolforge.org/.
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 ~/core
- Windows:
$ c: $ cd "%USERPROFILE%\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 config.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]
To learn more about running basic Pywikibot scripts, see:
- Small wiki toolkits workshop about running basic Pywikibot scripts
- Self-study materials based on the small wiki toolkits workshop
- Workshop handbook based on the small wiki toolkits workshop
La llista de tolos scripts ta disponible en $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:
$ python -m pip install [name of the package]
Alternativamente, executa'l siguiente comandu pa instalar toles dependencies de tolos scripts d'una vegada:
$ 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.