From b7d4d1ebaee92efea9b42f7c30de8718071e2c3f Mon Sep 17 00:00:00 2001 From: Tobias Diekershoff Date: Wed, 2 Oct 2013 08:16:35 +0200 Subject: [PATCH 1/2] adopted README.translate from friendica --- README.translate.md | 97 +++++++++++++++++++++++++++++++++++++++++++++ 1 file changed, 97 insertions(+) create mode 100644 README.translate.md diff --git a/README.translate.md b/README.translate.md new file mode 100644 index 000000000..bb2df1688 --- /dev/null +++ b/README.translate.md @@ -0,0 +1,97 @@ +Red translations +====================== + +Translation Process +------------------- + +The strings used in the UI of Red is translated at (Transifex)[1] and then +included in the git repository at github. If you want to help with translation +for any language, be it correcting terms or translating Red to a +currently not supported language, please register an account at transifex.com +and contact the Red translation team there. + +Translating Red is simple. Just use the online tool at transifex. If you +don't want to deal with git & co. that is fine, we check the status of the +translations regularly and import them into the source tree at github so that +others can use them. + +We do not include every translation from transifex in the source tree to avoid +a scattered and disturbed overall experience. As an uneducated guess we have a +lower limit of 50% translated strings before we include the language. This +limit is judging only by the amount of translated strings under the assumption +that the most prominent strings for the UI will be translated first by a +translation team. If you feel your translation useable before this limit, +please contact us and we will probably include your teams work in the source +tree. + +If you want to get your work into the source tree yourself, feel free to do so +and contact us with and question that arises. The process is simple and +Red ships with all the tools necessary. + +The location of the translated files in the source tree is + /view/LNG-CODE/ +where LNG-CODE is the language code used, e.g. de for German or fr for French. +For the email templates (the *.tpl files) just place them into the directory +and you are done. The translated strings come as a "message.po" file from +transifex which needs to be translated into the PHP file Red uses. To do +so, place the file in the directory mentioned above and use the "po2php" +utility from the util directory of your Red installation. + +Assuming you want to convert the German localization which is placed in +view/de/message.po you would do the following. + + 1. Navigate at the command prompt to the base directory of your + Red installation + + 2. Execute the po2php script, which will place the translation + in the strings.php file that is used by Red. + + $> php util/po2php.php view/de/message.po + + The output of the script will be placed at view/de/strings.php where + froemdoca os expecting it, so you can test your translation mmediately. + + 3. Visit your Red page to check if it still works in the language you + just translated. If not try to find the error, most likely PHP will give + you a hint in the log/warnings.about the error. + + For debugging you can also try to "run" the file with PHP. This should + not give any output if the file is ok but might give a hint for + searching the bug in the file. + + $> php view/de/strings.php + + 4. commit the two files with a meaningful commit message to your git + repository, push it to your fork of the Red repository at github and + issue a pull request for that commit. + +Utilities +--------- + +Additional to the po2php script there are some more utilities for translation +in the "util" directory of the Red source tree. If you only want to +translate Red into another language you wont need any of these tools most +likely but it gives you an idea how the translation process of Red +works. + +For further information see the utils/README file. + +Known Problems +-------------- + +Red uses the language setting of the visitors browser to determain the +language for the UI. Most of the time this works, but there are some known +quirks. + +One is that some browsers, like Safari, do the setting to "de-de" but Red +only has a "de" localisation. A workaround would be to add a symbolic link +from + $Red/view/de-de +pointing to + $Red/view/de + +Links +----- + +[1] http://www.transifex.com/projects/p/red-matrix/ + From 8b5b44cd751be593a6c39b985a346a05fc293ea5 Mon Sep 17 00:00:00 2001 From: tobiasd Date: Wed, 2 Oct 2013 08:27:37 +0200 Subject: [PATCH 2/2] Update README.translate.md some fixes for the markdown syntax --- README.translate.md | 54 ++++++++++++++++++++------------------------- 1 file changed, 24 insertions(+), 30 deletions(-) diff --git a/README.translate.md b/README.translate.md index bb2df1688..93e39dc7d 100644 --- a/README.translate.md +++ b/README.translate.md @@ -1,10 +1,10 @@ -Red translations +Translating the Red Matrix ====================== Translation Process ------------------- -The strings used in the UI of Red is translated at (Transifex)[1] and then +The strings used in the UI of Red is translated at [Transifex][1] and then included in the git repository at github. If you want to help with translation for any language, be it correcting terms or translating Red to a currently not supported language, please register an account at transifex.com @@ -40,30 +40,30 @@ utility from the util directory of your Red installation. Assuming you want to convert the German localization which is placed in view/de/message.po you would do the following. - 1. Navigate at the command prompt to the base directory of your - Red installation +1. Navigate at the command prompt to the base directory of your + Red installation - 2. Execute the po2php script, which will place the translation - in the strings.php file that is used by Red. +2. Execute the po2php script, which will place the translation + in the strings.php file that is used by Red. $> php util/po2php.php view/de/message.po - The output of the script will be placed at view/de/strings.php where - froemdoca os expecting it, so you can test your translation mmediately. + The output of the script will be placed at view/de/strings.php where + froemdoca os expecting it, so you can test your translation mmediately. - 3. Visit your Red page to check if it still works in the language you - just translated. If not try to find the error, most likely PHP will give - you a hint in the log/warnings.about the error. +3. Visit your Red page to check if it still works in the language you + just translated. If not try to find the error, most likely PHP will give + you a hint in the log/warnings.about the error. - For debugging you can also try to "run" the file with PHP. This should - not give any output if the file is ok but might give a hint for - searching the bug in the file. + For debugging you can also try to "run" the file with PHP. This should + not give any output if the file is ok but might give a hint for + searching the bug in the file. $> php view/de/strings.php - 4. commit the two files with a meaningful commit message to your git - repository, push it to your fork of the Red repository at github and - issue a pull request for that commit. +4. commit the two files with a meaningful commit message to your git + repository, push it to your fork of the Red repository at github and + issue a pull request for that commit. Utilities --------- @@ -79,19 +79,13 @@ For further information see the utils/README file. Known Problems -------------- -Red uses the language setting of the visitors browser to determain the -language for the UI. Most of the time this works, but there are some known -quirks. - -One is that some browsers, like Safari, do the setting to "de-de" but Red -only has a "de" localisation. A workaround would be to add a symbolic link -from - $Red/view/de-de -pointing to - $Red/view/de +* Red uses the language setting of the visitors browser to determain the + language for the UI. Most of the time this works, but there are some known + quirks. +* the early translations are based on the friendica translations, if you + some rough translations please let us know or fix them at Transifex. Links ------ - -[1] http://www.transifex.com/projects/p/red-matrix/ +------ +[1]: http://www.transifex.com/projects/p/red-matrix/