Manual:Pywikibot/Instal·lació

This page is a translated version of the page Manual:Pywikibot/Installation and the translation is 73% complete.
Aquesta pàgina t'ajudarà a començar amb Pywikibot, ja sigui en el teu ordinador, a Toolforge o usant PAWS: A Web Shell.
Gnome-system-software-installer.svg
On PAWS
PAWS (no text).svg

PAWS: A Web Shell (PAWS com a Servei Web) és la manera més senzilla de començar amb Pywikibot. No fa falta cap instal·lació, i es fa servir una interfície web per enviar les comandes.

Al teu ordinador
Computer n screen.svg

A continuació es mostra un manual per ajudar-vos a configurar Pywikibot i funcionar al vostre propi ordinador. Hi ha quatre passos principals en aquest procés:

Toolforge logo.svg

Toolforge us proporciona una infraestructura estable núvol als servidors Wikimedia que us permet executar bots contínuament o segons una programació.

Instal·lar Python

Descarrega i instal·la Python des dehttps://www.python.org/downloads/.

Si ja tens Python instal·lat, comprova que la teva versió és prou recent executant la comanda python --version en un terminal. If you have Python 3.5 or higher installed, your version of Python is recent enough.

On Windows please do not forget to modify PATH environment variable to make Python and pip work properly.

Install dependencies

An additional package named requests is required to run Pywikibot. Use pip, which is already installed if you have Python 2.7.9 or higher, or Python 3.4 or higher. Run the following command to install this package:

$ pip install "requests>=2.20.1"

Instal·leu Pywikibot

Descarregueu la branca actual de Pywikibot stable: .tar.gz, .zip.

Python 2.7 users should download the stable python2 branch: .tar.gz, .zip instead.

Descomprimeix aquest arxiu, per exemple a ~/pywikibot o a c:\users\username\pywikibot.

Alternatively, you may retrieve the latest version using git or svn client from Gerrit, see Manual:Pywikibot/Gerrit#For users . This is the recommended way for active bot operators and developers to use Pywikibot.

Altres versions estan disponibles a https://pywikibot.toolforge.org/.

Actualitzar Pywikibot

Mantingueu actualitzat el vostre framework de bot. Les noves versions es publiquen contínuament i estan disponibles al mateix lloc.

Si feu servir git o svn release, podeu ometre aquesta nota. En cas contrari, tingueu en compte la necessitat de fer una còpia de seguretat dels fitxers de configuració i dels scripts (user-config.py, qualsevol fitxer familiar o script personalitzat que pugueu haver creat o canviat i qualsevol fitxer de buidatge XML actual que utilitzeu per a una wiki) abans d’instal·lar una nova versió.

Després descomprimeix la nova versió sobre la vella de manera que la sobreescriguis.

Configurar Pywikibot

Open Terminal on Unix-like (Linux/BSD/Solaris) or Command Prompt on Windows (typically under Windows System or Accessories folders in All apps or All programs menu inside the Start menu), and change directory to where you unpacked Pywikibot:

Unix-like (Linux/BSD/Solaris):
$ cd ~/core
Windows:
$ c:
$ cd "\Users\username\pywikibot"

Naturalment has de substituir la ubicació d'exemple per la ubicació on has descomprimit pywikibot.

Continue with the following command to generate user configuration file:

$ python pwb.py generate_user_files

Segueix les indicacions per configurar el pywikibot.

Finally run the following command to log in to your wiki:

$ python pwb.py login

Ús en wikis de tercers

El Pywikibot està configurat per a un gran nombre de wikis, però possiblement no per a aquella en què tu vols treballar. Mira Manual:Pywikibot/Use on third-party wikis per saber com configurar el Pywikibot per a la teva wiki.

Més opcions de configuració

El Pywikibot proporciona un gran nombre d'opcions de configuració per a canviar el comportament del teu bot. Pots canviar aquests ajustos en el fitxer 'user-config.py'. Mira config2.py per veure una llista dels paràmetres que pots 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

El Pywikibot incorpora dins l'arxiu comprimit un gran nombre de scripts en la carpeta "scripts". Pots executar-los fent servir

$ python pwb.py [name of the script]

A Manual:Pywikibot/Scripts trobaràs una llista de tots els scripts disponibles.

Other dependencies

La majoria dels scripts no requereixen paquets addicionals, però alguns no funcionaran sense. Aquests es mostren en requirements.txt juntament amb les seves dependències.

Per instal·lar dependències d'algun script, utilitzeu pip i executeu l'ordre següent:

$ pip install [name of the package]

Com a alternativa, executeu l'ordre següent per instal·lar totes les dependències de tots els scripts alhora:

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