X-Git-Url: https://git.immae.eu/?a=blobdiff_plain;f=docs%2Fen%2Fdeveloper%2Ftranslate.rst;h=1e5d500904e1664b5172f32be5e37f679324bd81;hb=a3477df5c93bc3d27baac08410a716fa6e92309f;hp=138d128cd408756deb619e9b4a0f5a8f4a4fe82a;hpb=befa6f2fe91337469a603c982821523787099ab3;p=github%2Fwallabag%2Fwallabag.git diff --git a/docs/en/developer/translate.rst b/docs/en/developer/translate.rst index 138d128c..1e5d5009 100644 --- a/docs/en/developer/translate.rst +++ b/docs/en/developer/translate.rst @@ -1,27 +1,38 @@ Translate wallabag ================== +wallabag web application +------------------------ + Translation files ------------------ +~~~~~~~~~~~~~~~~~ + +.. note:: -You can find translation files here: https://github.com/wallabag/wallabag/tree/v2/src/Wallabag/CoreBundle/Resources/translations. + As wallabag is mainly developed by a French team, please consider that french + translation is the most updated one and please copy it to create your own translation. -You have to create ``messages.CODE.yml`` and ``validators.CODE.yml``, where CODE is the the ISO 639-1 code of your language (`see wikipedia `__). +You can find translation files here: https://github.com/wallabag/wallabag/tree/master/src/Wallabag/CoreBundle/Resources/translations. + +You have to create ``messages.CODE.yml`` and ``validators.CODE.yml``, where CODE +is the ISO 639-1 code of your language (`see wikipedia `__). Other files to translate: -- https://github.com/wallabag/wallabag/tree/v2/app/Resources/CraueConfigBundle/translations. -- https://github.com/wallabag/wallabag/tree/v2/app/Resources/FOSUserBundle/translations. +- https://github.com/wallabag/wallabag/tree/master/app/Resources/CraueConfigBundle/translations. +- https://github.com/wallabag/wallabag/tree/master/src/Wallabag/UserBundle/Resources/translations. -You have to create ``CraueConfigBundle.CODE.yml``. +You have to create ``THE_TRANSLATION_FILE.CODE.yml`` files. Configuration file ------------------- +~~~~~~~~~~~~~~~~~~ You have to edit `app/config/config.yml -`__ to display your language on Configuration page of wallabag (to allow users to switch to this new translation). +`__ to display +your language on Configuration page of wallabag (to allow users to switch to this new translation). -Under the ``wallabag_core.languages`` section, you have to add a new line for with your translation. For example +Under the ``wallabag_core.languages`` section, you have to add a new line with +your translation. For example: :: @@ -32,6 +43,18 @@ Under the ``wallabag_core.languages`` section, you have to add a new line for wi fr: 'Français' -For the first column (``en``, ``fr``, etc.), you have to add the ISO 639-1 code of your language (see above). +For the first column (``en``, ``fr``, etc.), you have to add the ISO 639-1 code +of your language (see above). For the second column, it's the name of your language. Just that. + +wallabag documentation +---------------------- + +.. note:: + + Contrary to the web application, the main language for documentation is english. + +Documentation files are stored here: https://github.com/wallabag/wallabag/tree/master/docs + +You need to respect the ``en`` folder structure when you create your own translation.