Manual:Pywikibot/Installation/ca

  Aquesta pàgina t'ajudarà a començar amb Pywikibot, ja sigui en el teu ordinador, a Toolforge o usant PAWS: A Web Shell.

  On PAWS 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 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:  A Toolforge 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
 * Instal·lació de Pywikibot
 * Configurar Pywikibot
 * Executar un script



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  en un terminal. To discover if Python version 3 or above is installed, run  in a console.

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

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 included by default in all supported Python versions. Run the following command to install this package:

In addition a MediaWiki markup parser is required. Please install (at least) one of the following (or both):



Instal·leu Pywikibot
If using pip, use  instead of   in examples below.

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

Descomprimeix aquest arxiu, per exemple a  o a.

Alternatively, you may retrieve the latest version using git or svn client from Gerrit, see. 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):




 * Windows:



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:

Segueix les indicacions per configurar el pywikibot.

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



Ú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 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 config.py per veure una llista dels paràmetres que pots 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
El Pywikibot incorpora dins l'arxiu comprimit un gran nombre de scripts en la carpeta "scripts". Pots executar-los fent servir

To learn more about running basic Pywikibot scripts, see:
 * Small wiki toolkits workshop about running basic Pywikibot scripts

A $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:

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