Aide:Pywikipedia/category.py

category.py est un script de Pywikipedia pour les catégories.

Syntaxe

python category.py action [-option]

action peut être :

* add    - ajouter la catégorie à une liste d'articles
* remove - enlever la catégorie aux pages contenues à l'intérieur
* move   - modifier toutes les pages dans la catégorie dans une autre catégorie
* tidy   - ranger une catégorie en mettant les articles dans une sous-catégorie
* tree   - dessiner un arbre des sous-catégories

et option peut être:

* -person     - trier les gens par leur nom (action 'add')
* -rebuild    - réinitialiser la base de donnée
* -from:      - la catégorie de laquelle déplacer les pages (action 'move')
                ''ou'' la catégorie de laquelle supprimer les pages (action 'remove')
                ''ou'' la catégorie pour laquelle créer une liste (action 'listify')
* -to:        - la catégorie vers laquelle déplacer les pages (action 'move')
                ''ou'' le nom de la page où la liste sera créée (action 'listify')
* -batch      - ne pas demander de confirmation pour la suppression de catégories vides (le faire automatiquement)
* -summary:   - un résumé d'édition personnalisé
* -inplace    - ne pas nettoyer (réarranger) les catégories dans la page (tri alphabétique, emplacement)
* -nodelsum   - utiliser le résumé d'édition spécifié en -summary lors de la suppression d'une page plutôt que le résumé par défaut
* -delsum     - alias de -nodelsum
* -overwrite  - écraser la page où faire la liste même si elle existe (action 'listify')
* -showimages - afficher les images au lieu de les lier dans la liste (action 'listify')
* -talkpages  - insérer pour chaque élément de la liste un lien vers sa page de discussion (action 'listify')
* -recurse    - inclure dans la requête les sous-catégories de manière récursive
* -match      - exécuter la requête seulement sur les pages dont le titre correspond à l'expression régulière (actions 'move' et 'remove')

Attention : Vous devez encadrer d'apostrophes les noms des catégories comprenant des espaces. Le cas échéant, les mots séparés sont considérés comme des paramètres.

Pour les action tidy et tree, le bot sauve la catégorie localement dans le fichier category.dump. L'heure est aussi sauvée mais si le bot veut réutiliser les données plus tard, elles risquent d'être périmées.

Exemple

Si vous voulez ajouter une catégorie à une déjà existante il faut écrire :

category.py move

Le bot va vous demander la catégorie à remplacer, il faut écrire:

Nom_ancienne_catégorie

Le bot va vous demander le nouveau nom de la catégorie, il faut écrire:

Nom_nouvelle_catégorie

Si vous souhaitez supprimer massivement des catégories:

 category.py remove -recurse -batch -from:"cible"

en batch ça donne:

FOR /F "delims=|" %%f in (test.txt) DO category.py remove -recurse -batch -from:"%%f"

le fichier "test.txt" est juste une liste des catégories a supprimer.