X-Git-Url: https://git.mxchange.org/?a=blobdiff_plain;f=README.translate.md;h=83c24e05424022ef7103b9f765efb51ee511a601;hb=8eecad4c7f1c57e2f7a608cc40fa7cf9e7c85137;hp=861e98440ae91a3734f5d4c28c64cdc7634190d0;hpb=b067a1114679ebc3dc6132759c511c3ac8b73e49;p=friendica.git diff --git a/README.translate.md b/README.translate.md index 861e98440a..83c24e0542 100644 --- a/README.translate.md +++ b/README.translate.md @@ -56,6 +56,9 @@ Assuming you want to convert the German localization which is placed in view/lan repository, push it to your fork of the friendica repository at github and issue a pull request for that commit. +You should translate the PO files at Transifex. +Otherwise your work might get lost, when the translation from Transifex is included to the Friendica repository after it was updated there. + Utilities --------- @@ -64,5 +67,34 @@ If you only want to translate friendica into another language you wont need any For further information see the utils/README file. -[1]: https://www.transifex.com/projects/p/friendica/ +Transifex-Client +---------------- + +Transifex has a client program which let you interact with the translation files in a similar way to git. +Help for the client can be found at the [Transifex Help Center] [2]. +Here we will only cover basic usage. + +After installation of the client, you should have a `tx` command available on your system. +To use it, first create a configuration file with your credentials. +On Linux this file should be placed into your home directory `~/.transifexrc`. +The content of the file should be something like the following: + + [https://www.transifex.com] + username = user + token = + password = p@ssw0rd + hostname = https://www.transifex.com + +Since Friendica version 3.5.1 we ship configuration files for the Transifex client in the core repository and the addon repository. +To update the translation files after you have translated strings of e.g. Esperanto in the web-UI of transifex you can use `tx` to download the file. + $> tx pull -l eo + +And then use the `po2php` utility described above to convert the `messages.po` file to the `strings.php` file Friendica is loading. + + $> php util/po2php.php view/lang/eo/messages.po + +Afterwards, just commit the two changed files to a feature branch of your Friendica repository, push the changes to github and open a pull request for your changes. + +[1]: https://www.transifex.com/projects/p/friendica/ +[2]: https://docs.transifex.com/client/introduction