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. Donc si vous voulez l'installer vous devriez:

$ 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.

With SVN submodule must be always configured and updated separately using:

$ 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 ll|translatewiki.net et mettez à jour le sous-module d'i18n après une ou deux semaines. Pour cela vous devez lancer:

$ 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 (pour core et pour compat), les documents connexes. 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 هي مقالة جيدة # Since arz translation doesn't exist, it returned 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 ^connect ou la liste de diffusion pywikibot@.