WikiRobots/fr

Présentation
Les tâches répétitives peuvent être automatisées à l'aide de robots ou de bots, c'est-à-dire de programmes logiciels fonctionnant seuls sur le wiki.

Les robots classiques et les plus utilisés pour les sites wiki sont fournis par MediaWiki, sous le nom de paquet Pywikibot. Voir Manuel:Pywikibot pour des informations complètes.

En un mot, Pywikibot est une collection de scripts Python capables d'utiliser l'API wiki native pour agir sur les sites wiki. Pour voir la liste des API pour le wiki de FreeCAD, visitez http://www.freecadweb.org/wiki/api.php.

Pour utiliser Pywikibot, vous devez :


 * 1) installer le package Pywikibot
 * 2) configurez Pywikibot pour qu'il fonctionne sur le Wiki FreeCAD.
 * 3) lancez les scripts dont vous avez besoin pour la tâche à accomplir.

Il existe une multitude d'informations sur la façon d'installer, de configurer et d'utiliser Pywikibot. Cependant, soyez conscient que ces informations, bien qu'utiles, peuvent être trompeuses, car elles mélangent des instructions relatives à deux bases de code Pywikibot différentes et différentes versions de la collection de scripts Pywikibot.

Dans ce qui suit, vous trouverez les instructions de base pour configurer et utiliser Pywikibot sur le wiki FreeCAD. Cela vous permettra d'effectuer les tâches les plus courantes. Pour une utilisation avancée, référez-vous au Manuel:Pywikibot et au code source Python.

Installation
Allez sur http://tools.wmflabs.org/pywikibot/ et téléchargez. (le projet est aussi sous github, gerrit, etc... mais c'est un moyen simple d'obtenir un paquet complet et autonome).

Décompressez le contenu dans le répertoire de votre choix.

À moins que vous ne vouliez installer les bibliothèques dans vos librairies Python, vous avez terminé (si vous voulez toujours les installer, vérifiez le fichier dans le répertoire de base).

Pywikibot fonctionne avec Python 2.6 et 2.7 sans problème. Python 3 n'a pas été testé jusqu'à présent avec FreeCAD wiki fonctionne également.

Configuration
You must save the following Python code as a file with the name in the base directory where you unzipped  (to be clear, in the same directory where you already find a file called ).

In the above code:


 * replace <> with your Wiki user name
 * replace cp437 with your console_encoding. To find out what is your console encoding, for Windows and Linux, launch the Python interpreter, enter followed by . Python will write your  on the screen.

Then you must save the following Python code as a file with the name under the sub-directory  (together with the other  files).

Usage
You are now all set to launch the Pywikibot scripts. The scripts themselves are contained in the subdirectory, from which you can know the names.

To launch the scripts, open a shell and move to the base directory (the installation one, NOT the subdirectory), and write

where of course you replace < > with the name of the script you are interested in, and < > with the parameter(s) required for the given script.

To have a description of the usage and parameters of any script, simply use the -help parameter. For instance, to have a description of the script (one of the most useful), type

There is another very useful parameter, valid for all the scripts, called -simulate, that allows you to test commands without harming the Wiki. Use it, before going 'live'.

Examples
This command will log into the wiki

This command will print a list of all the pages containing a link to SourceForge

This command will replace all the links to the old SourceForge Forum with a link to the new freecadweb.org-hosted Forum

This command will print a list of all the pages containing the word 'PartDesign', starting with the page titled "2d Drafting Module" and going on alphabetically

This command will replace all the secure links to the old SourceForge Forum with a link to the new freecadweb.org-hosted Forum in the translated pages

FreeCAD Wiki Related Commands
Count all pages that a specific wiki templates is used in

List all pages that a specific wiki templates is used in

Replace a string in all the pages listed in the Arch category (a/k/a )