X-Git-Url: https://git.mxchange.org/?a=blobdiff_plain;f=doc%2Ftranslations.md;h=61d91bee5b04b594b919f9ade19d652573741851;hb=dad6a61be4b7d23bcf5c19dd782e80aa4886b3a3;hp=861e98440ae91a3734f5d4c28c64cdc7634190d0;hpb=8fc558b8e65024c1e1e9a95d598a2c40b0679600;p=friendica.git

diff --git a/doc/translations.md b/doc/translations.md
index 861e98440a..61d91bee5b 100644
--- a/doc/translations.md
+++ b/doc/translations.md
@@ -1,6 +1,8 @@
 Friendica translations
 ======================
 
+* [Home](help)
+
 Translation Process
 -------------------
 
@@ -64,5 +66,35 @@ If you only want to translate friendica into another language you wont need any
 
 For further information see the utils/README file.
 
+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