Manuel:Pywikibot/i18n

Cette page doit vous aider à comprendre le système d'i18n (internationalisation) de pywikibot.

Pour les utilisateurs

Le module est vital pour le lancement des robots. Que vous vouliez le lancer sur un wiki en anglais ou dans une autre langue. Si vous voulez l'installer vous pouvez exécuter les commandes suivantes :

$ cd scripts
$ git clone https://gerrit.wikimedia.org/r/pywikibot/i18n.git

Si vous avez cloné pywikibot avec l'option --recursive ou téléchargé l'archive quotidienne, vous n'avez rien à faire.

Avec le sous-module SVN qui doit toujours être configuré et mis à jour séparément en faisant :

$ cd scripts
$ svn co https://github.com/wikimedia/pywikibot-i18n/trunk i18n

Les fichier d'i18n sont des fichiers json localisés dans des répertoire i18n séparés par langue et par script. Par exemple les traductions en Persan pour category.py sont dans:

scripts --> i18n --> category --> fa.json

Changer ou ajouter à l'internationalisation

Si vous voulez gérer l'internationalisation de certains scripts de votre langue, allez sur translatewiki.net et mettez à jour le sous-module d'i18n après une ou deux semaines. Pour mettre à jour le sous-module i18n, exécutez les commandes suivantes :

$ cd scripts
$ cd i18n
$ git pull

ou en tant qu'administrateur lancez:

$ git pull --recurse-submodules

Si vous ne pouvez attendre, changez le manuellement mais ce n'est pas recommandé parce que ça pourrait faire échouer de futures mises à jour.

Pour les développeurs

La classe i18n est présente dans i18n.py, dans le répertoire pywikibot, les documents connexes peuvent être trouvés dans la documentation. Exemple simple:

>>> from pywikibot import i18n
>>> print(i18n.twtranslate('es', 'pywikibot-enter-new-text'))
Escribe el nuevo texto:
>>> print(i18n.twtranslate('arz', 'featured-good'))
بوت: %(page)s هي مقالة جيدة # Puisque la traduction arz n'existe pas, elle retourne ar i18n

Vous pouvez fournir un objet de site à la place d'un code de langue:

>>> import pywikibot
>>> print(pywikibot.i18n.twtranslate(pywikibot.Site('el'), 'featured-good'))
Ρομπότ: το %(page)s είναι καλό άρθρο

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