docs/fr/developer/translate.rst

   1 Traduire wallabag
   2 =================
   3
   4 L'application web
   5 -----------------
   6
   7 Fichiers de traductions
   8 ~~~~~~~~~~~~~~~~~~~~~~~
   9
  10 .. note::
  11
  12     Comme wallabag est principalement dévelopée par une équipe française, c'est
  13     cette traduction qui est considérée comme la plus récente. Merci de vous baser
  14     sur celle-ci pour créer votre traduction.
  15
  16 Les principaux fichiers de traduction se trouvent ici : https://github.com/wallabag/wallabag/tree/master/src/Wallabag/CoreBundle/Resources/translations.
  17
  18 Vous devez créer les fichiers ``messages.CODE.yml`` et ``validators.CODE.yml``,
  19 où CODE est le code ISO 639-1 de votre langue (`cf wikipedia <https://fr.wikipedia.org/wiki/Liste_des_codes_ISO_639-1>`__).
  20
  21 Autres fichiers à traduire :
  22
  23 - https://github.com/wallabag/wallabag/tree/master/app/Resources/CraueConfigBundle/translations.
  24 - https://github.com/wallabag/wallabag/tree/master/src/Wallabag/UserBundle/Resources/translations.
  25
  26
  27 Vous devez créer les fichiers ``LE_FICHIER_DE_TRADUCTION.CODE.yml``.
  28
  29 Fichier de configuration
  30 ~~~~~~~~~~~~~~~~~~~~~~~~
  31
  32 Vous devez éditer `app/config/config.yml
  33 <https://github.com/wallabag/wallabag/blob/master/app/config/config.yml>`__ pour
  34 afficher votre langue dans la page Configuration de wallabag (pour permettre aux
  35 utilisateurs de choisir cette nouvelle traduction).
  36
  37 Dans la section ``wallabag_core.languages``, vous devez ajouter une nouvelle ligne
  38 avec votre traduction. Par exemple :
  39
  40 ::
  41
  42     wallabag_core:
  43         ...
  44         languages:
  45             en: 'English'
  46             fr: 'Français'
  47
  48
  49 Pour la première colonne (``en``, ``fr``, etc.), vous devez ajouter le code ISO 639-1
  50 de votre langue (voir ci-dessus).
  51
  52 Pour la seconde colonne, c'est juste le nom de votre langue.
  53
  54 Documentation de wallabag
  55 -------------------------
  56
  57 .. note::
  58
  59     Contrairement à l'application, la langue principale de la documentation est l'anglais
  60
  61 Les fichiers de documentation se trouvent ici : https://github.com/wallabag/wallabag/tree/master/docs
  62
  63 Vous devez respecter la structure du dossier ``en`` quand vous crééz votre traduction.