This manual is deprecated. Please visit https://groupoffice.readthedocs.io for the latest documentation.

Difference between revisions of "Translate Group-Office"

From Group-Office Groupware and CRM Documentation
Jump to: navigation, search
Line 1: Line 1:
You can translate Group-Office by copying all en.inc.php files to nl.inc.php and en.js files to nl.js. In case you are translating to the Dutch (nl) language. Look up your ISO language code here:
+
Example: You can translate Group-Office by copying all en.php files to de.php. In this case you are translating to the German (de) language. Look up your ISO language code here:
  
 
http://www.loc.gov/standards/iso639-2/php/code_list.php
 
http://www.loc.gov/standards/iso639-2/php/code_list.php
Line 6: Line 6:
  
 
<pre>
 
<pre>
language/*/en.inc.php
+
language/*/en.php
language/*/en.js
+
 
</pre>
 
</pre>
  
Line 13: Line 12:
  
 
<pre>
 
<pre>
modules/*/language/en.inc.php
+
modules/*/language/en.php
modules/*/language/en.js
+
 
</pre>
 
</pre>
 
You must remove these lines from the *.js files:
 
 
<pre>
 
Ext.namespace('GO.<module>');
 
GO.<module>.lang={};
 
</pre>
 
 
In the *.inc.php files you must uncomment this lines:
 
<pre>
 
require_once($GO_LANGUAGE->get_fallback_language_file('<module>'));
 
</pre>
 
 
If you don't do this the language won't fall back on English if a string doesn't exist.
 
  
 
<b>Important!</b>Make sure you save your files in <b>UTF-8</b> encoding! Otherwise Group-Office will display garbage when you use non-ascii characters.
 
<b>Important!</b>Make sure you save your files in <b>UTF-8</b> encoding! Otherwise Group-Office will display garbage when you use non-ascii characters.
  
You must add your language to language/languages.inc.php and language/Languages.js to enable it in Group-Office.
+
You must add your language to language/languages.inc.php to enable it in Group-Office.
  
 
==Contributing your translation==
 
==Contributing your translation==
 
It would be great if you would let other people of the Group-Office community benefit from your translation. If you send it to info@intermesh.nl, your language will be put into the main distribution.
 
It would be great if you would let other people of the Group-Office community benefit from your translation. If you send it to info@intermesh.nl, your language will be put into the main distribution.
  
==Check differences between languages==
+
===Check differences between languages===
We created a script that checks differences between English and your language. This way it's easy to add missing strings when a new version of Group-Office appears. You can get it here:
+
We created a script that checks differences between two languages. This way it's easy to add missing strings when a new version of Group-Office appears. When you're logged in as admin, you can run it from the browser:
  
http://group-office.svn.sourceforge.net/viewvc/group-office/trunk/scripts/check_lang.php
+
http://my.groupoffice.net/?r=maintenance/checkLanguage&lang1=en&lang2=de
  
Put it in the root of your Group-Office folder and open it in the browser:
+
The above URL will show a comparison between English (lang1) and German (lang2).
  
http://your.host/groupoffice/check_lang.php?lang1=en&lang2=nl
+
===Extract language files from Group-Office===
  
This will compare english with dutch.
+
You can extract all the language files from Group-Office by logging in as admin and running the following URL in the browser:
  
==Extract language files from Group-Office==
+
http://my.groupoffice.net/?r=maintenance/zipLanguage&lang=en
 
+
If you are on Linux you can extract all the language files from Group-Office with this script:
+
 
+
http://group-office.svn.sourceforge.net/viewvc/group-office/trunk/scripts/getlang.sh?view=log
+
 
+
Put it anywhere and use it like this:
+
 
+
<pre>
+
./getlang.sh /path/to/groupoffice en
+
</pre>
+
  
This will save all english language files in a folder "en" at the current working directory.
+
This URL will save all English language files in a zip file called "en.zip" which you can download. It can be easily unpacked to the Group-Office root.

Revision as of 09:38, 5 July 2012

Example: You can translate Group-Office by copying all en.php files to de.php. In this case you are translating to the German (de) language. Look up your ISO language code here:

http://www.loc.gov/standards/iso639-2/php/code_list.php

The core language files are located in:

language/*/en.php

and for the modules:

modules/*/language/en.php

Important!Make sure you save your files in UTF-8 encoding! Otherwise Group-Office will display garbage when you use non-ascii characters.

You must add your language to language/languages.inc.php to enable it in Group-Office.

Contributing your translation

It would be great if you would let other people of the Group-Office community benefit from your translation. If you send it to info@intermesh.nl, your language will be put into the main distribution.

Check differences between languages

We created a script that checks differences between two languages. This way it's easy to add missing strings when a new version of Group-Office appears. When you're logged in as admin, you can run it from the browser:

http://my.groupoffice.net/?r=maintenance/checkLanguage&lang1=en&lang2=de

The above URL will show a comparison between English (lang1) and German (lang2).

Extract language files from Group-Office

You can extract all the language files from Group-Office by logging in as admin and running the following URL in the browser:

http://my.groupoffice.net/?r=maintenance/zipLanguage&lang=en

This URL will save all English language files in a zip file called "en.zip" which you can download. It can be easily unpacked to the Group-Office root.