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.

  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 Aquesta pàgina t'ensenyarà com instal·lar i executar Pywikibot al teu ordinador. Hi ha quatre passos principals en aquest procés:  A Toolforge Toolforge et proporciona una infraestructura d'allotjament estable que et permet executar bots de manera continuada o seguint un calendari.
 * * Instal·lar Python
 * * Descarregar 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. Si tens Python 2.7.4 o superior, o Python 3.4 o superior, la teva versió de Python és prou recent. 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.

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:

Descarregar Pywikibot
Descarrega Pywikibot stable branch: .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.

També pots descarregar-te versions diàries a https://tools.wmflabs.org/pywikibot/.

Actualitzar Pywikibot
Cada tres mesos, aproximadament, es publiquen versions estables que poden ser descarregades des de la mateixa direcció.

Abans d'instal·lar-ne cap, fes una còpia de seguretat dels arxius de configuració i els script (user-config.py, qualsevol arxiu familiar o script personalitzat que hagis creat i qualsevol arxiu XML de bolcat que estiguis fent servir per a una wiki).

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

Configurar Pywikibot
Obre un terminal i "canvia de carpeta" (cd) a on hagis descomprimit el 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.

A continuació, crea a algun lloc un fitxer amb un text semblant a, obre l'arxiu user-config.py a la carpeta de Pywikibot i insereix-hi la línia

Ú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 config2.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

A trobaràs una llista de tots els scripts disponibles.

Dependencies
La majoria dels scripts no necessiten paquets addicionals per a funcionar, alguns, però, no funcionaran sense paquets extra. Pots trobar-los llistats a requirements.txt

Per a instal·lar dependències fes ús de $pip, que ja ve instal·lat amb la versió més recent de Python. Executa la següent comanda per a instal·lar els paquets:

O la comanda següent per instal·lar els paquets recomanats: