Manuel:Pywikibot/Windows

Accès à Python avec PATH

Pour faciliter l'exécution de Python, son exécutable doit figurer dans PATH.

Pour vérifier l'installation correcte de Python : ouvrez une fenêtre cmd.exe en tant qu'administrateur et exécutez la commande :

  C:\> python --version

Si le système ne trouve pas Python, réinstallez ce dernier en choisissant l'option pour placer python.exe dans la variable PATH de votre environnement.

Créer un raccourci

Comment créer un raccourci rapide pour exécuter les commandes (utilisateurs Windows) :

Dans le cas où Pywikibot est installé dans un dossier tel que Mes documents, l'utilisation répétée de la commande chdir peut poser problème pour accéder au répertoire pour exécuter les robots.

Sous Windows, vous pouvez créer un raccourci vers une invite de commande permettant d'utiliser votre robot facilement. Il suffit de suivre ces instructions :

1. Cliquer-droit sur le dossier où Pywikibot est installé,
2. Cliquer sur l'option Créer un raccourci. Un nouveau raccourci avec une flèche sera créé.
3. Cliquer-droit sur le nouveau raccourci, puis ouvrir le menu Propriétés,
4. Dans la fenêtre de propriétés, taper « cmd.exe »,
5. Dans la boîte « Démarrer », taper l'adresse complète du dossier d'installation de Pywikibot,
6. Cliquer sur OK.
7. Cliquer sur le raccourci et cmd.exe ouvre avec le chemin d'accès complet.

   Si vous pressez F5 pour rafraîchir la fenêtre (ou si vous ré-ouvrez les propriétés du raccourci), vous verrez une icône différente.

Configurer Unicode

Le shell Windows (cmd.exe) est médiocre quand il est question d'utiliser Unicode. Pywikibot est utilisé massivement sur les sites MediaWiki non anglophones, donc nous vous permettons les sorties de données en utilisant Unicode. Si vous devez utiliser Unicode pour la langue sur laquelle vous travaillez, il est conseillé d'utiliser par exemple le programme ConEmu Windows console à la place de la console Windows native (c'est à dire cmd.exe).

Si toutefois vous décidez d'utiliser la console native cmd.exe, vous devrez impérativement changer la police de caractère, sinon vous verrez beaucoup de points d'interrogation, un par caractère non reconnu.

Pywikibot permet alternativement d'utiliser la translitération, par exemple Вики peut devenir Viki sur les systèmes d'Europe de l'Ouest. Ceci fonctionne aussi sans changer de police.

Il est impossible de déterminer la police utilisée. Il vous est donc demandé de fournir explicitement l'option que vous souhaitez utiliser. Si vous ne le faites pas, vous aurez l'avertissement suivant :

WARNING: Running on Windows and transliteration_target is not set.
Please see https://www.mediawiki.org/wiki/Manual:Pywikibot/Windows

Sortie en Unicode uniquement (suggéré)

Pour obtenir des sorties en Unicode uniquement, vous devez changer la police de cmd.exe en ajoutant la ligne suivante à votre user-config.py :

Changer la police

1. Lancez cmd.exe ou n'importe quel script Pywikibot.
2. Cliquez sur l’icône en haut à gauche ("C:\") ou cliquez-droit sur la barre de titre
3. Allez dans Propriétés
4. Allez à l'onglet Polices
5. Sélectionnez une police qui commence par le logo TT - sur Windows XP, c'est Lucida Console ; pour les versions plus récentes, vous pouvez choisir Consolas.
6. Cliquez sur OK
7. Choisissez Enregistrez les paramètres pour tous les écrans avec ce titre

Votre cmd.exe est dorénavant capable de tout produire en Unicode !

Modifier votre user-config.py

Ajouter à user-config.py la ligne suivante :

transliteration_target = None

Blocages sur les sorties des commandes

C'est parce que la police de caractères ne peut pas afficher tous les glyphes, que vous voyez parfois des caractères comme : ☐. Mais il est néanmoins possible de copier le texte pour afficher la page sur un wiki à l'aide d'un copier / coller des caractères.

Si vous préférez avoir des caractères translitérés, lisez la section suivante.

Prise en charge de la translitération

Si vous souhaitez plutôt avoir des caractères translittérés, vous pouvez ajouter la ligne suivante à user-config.py :

transliteration_target = console_encoding

ou, si vous voulez revenir aux caractères ASCII,

transliteration_target = 'ascii'

Vous pouvez utiliser tout encodage de caractères standard de Python à cet effet.

Cependant, la sortie est maintenant Viki à la place de Вики. Cela signifie que vous ne pouvez plus copier/coller le titre de la page : en effet, ru:Viki n'est pas du tout ru:Вики !

Si vous avez besoin de plus d'aide pour configurer votre Pywikibot, consultez le canal IRC #pywikibot ^connecter ou la liste de diffusion pywikibot@.