31,026
edits
Translator documentation: Difference between revisions
Jump to navigation
Jump to search
m
no edit summary
mNo edit summary |
|||
| Line 1: | Line 1: | ||
= To translate Dolibarr into another language = | |||
Dolibarr languages files are developed in French and English by default. | Dolibarr languages files are developed in French and English by default. | ||
| Line 5: | Line 5: | ||
There are 4 methods for translating Dolibarr (1 automatic: autotranslator, 3 manual: phpLangEditor, iniTranslation and the completely manual method). They are in order of preference: | There are 4 methods for translating Dolibarr (1 automatic: autotranslator, 3 manual: phpLangEditor, iniTranslation and the completely manual method). They are in order of preference: | ||
== Automatic Translation with autotranslator.php tool == | |||
* OS transltor: All | * OS transltor: All | ||
| Line 20: | Line 20: | ||
Your PHP must also have permissions to write into htdocs/langs directory and must have curl functions availables. | Your PHP must also have permissions to write into htdocs/langs directory and must have curl functions availables. | ||
== Manual Translation with the Firefox plugin phpLangEditor == | |||
* OS translator: All | * OS translator: All | ||
| Line 36: | Line 36: | ||
# Edit the file with a text editor to remove or correct the first comment line. Indeed, with phpLangEditor, it is not possible to translate the lines Discussed (starting with #), the file contains translated once recorded the comment line of the source file. A small manual editing is needed to correct or delete this line, although this does not adversely affect the proper functioning of the new file. Lang. | # Edit the file with a text editor to remove or correct the first comment line. Indeed, with phpLangEditor, it is not possible to translate the lines Discussed (starting with #), the file contains translated once recorded the comment line of the source file. A small manual editing is needed to correct or delete this line, although this does not adversely affect the proper functioning of the new file. Lang. | ||
== Manual Translation with iniTranslator == | |||
* Translator OS: Windows | * Translator OS: Windows | ||
| Line 51: | Line 51: | ||
Attention, iniTranslator has a serious defect. It does not retain the original order of the parameters and the generated file sorting alphabetically rather than keys in the order of the source file. In addition, areas comments source files are not reflected in the destination file translated. | Attention, iniTranslator has a serious defect. It does not retain the original order of the parameters and the generated file sorting alphabetically rather than keys in the order of the source file. In addition, areas comments source files are not reflected in the destination file translated. | ||
== Manual translation == | |||
To translate Dolibarr into another language, go to the langs directory and create a folder named with the code language to translate (Following the same format as those already existing, for example en_US, en_GB, es_ES, de_DE, etc.. ..). Then copy the files from a directory lang already translated (for example en_US / or main.lang en_GB / bills.lang), copy them into the directory of the new language that we have just created and bring the contents of these files. | To translate Dolibarr into another language, go to the langs directory and create a folder named with the code language to translate (Following the same format as those already existing, for example en_US, en_GB, es_ES, de_DE, etc.. ..). Then copy the files from a directory lang already translated (for example en_US / or main.lang en_GB / bills.lang), copy them into the directory of the new language that we have just created and bring the contents of these files. | ||
| Line 74: | Line 74: | ||
must be added to the files. lang | must be added to the files. lang | ||
= Integrate its translation into Dolibarr = | |||
If you have completed existing but incomplete .lang files | If you have completed existing but incomplete .lang files | ||
| Line 92: | Line 92: | ||
You can use indifferently one or the other (which arrange) as a reference because the 2 are up to date. All other language files are likely to be incomplete. | You can use indifferently one or the other (which arrange) as a reference because the 2 are up to date. All other language files are likely to be incomplete. | ||
= Distribute your translation = | |||
When you create a new language, if it is not integrated into Dolibarr, it can still be spread to others. You can build a package to distribute the script build / makepack-dolibarrlang.pl | When you create a new language, if it is not integrated into Dolibarr, it can still be spread to others. You can build a package to distribute the script build / makepack-dolibarrlang.pl | ||
The .tgz made file just needs to be unzipped in the directory Dolibarr that language is available. This file can be posted to the website http://www.dolibarr.org in space download modules / addon or the mailing list developer dolibarr-dev@nongnu.org of Dolibarr. | The .tgz made file just needs to be unzipped in the directory Dolibarr that language is available. This file can be posted to the website http://www.dolibarr.org in space download modules / addon or the mailing list developer dolibarr-dev@nongnu.org of Dolibarr. | ||