Changes

Jump to navigation Jump to search
Re-write of the translation to Dolibarr sources section
Line 231: Line 231:  
= [[File:Language.png]] Distribute or include your translation into core source =
 
= [[File:Language.png]] Distribute or include your translation into core source =
   −
== Into official Dolibarr sources ==
+
== Including your translation in the official Dolibarr sources ==
The best thing once translation is complete, is to include it in the official version of Dolibarr.
     −
If you have completed the translation of already existing and incomplete lang files or if you have created lang files for a new language, you can:
+
Once you start translating, it's a smart decision to share it to be included into the official code of Dolibarr.
 +
If you keep it for you, others will not be able to improve it when new terms are added or previous terms are modified, and you will still have to manage the translation on your own.
   −
* If the translation was done by using the Transifex system for languages ​​other than en_US, no further action is needed. Your translation will be integrated during the next schedule of our regular synchronization with the official Git sources (at least once a month).
+
If you translated through the Transifex system, there's nothing to be done. Your translation will be included in the next version of Dolibarr. No additional work! In technical terms, the translation will be exported from Transifex and imported into Dolibarr by our developers, at least once every month.
* If the translation was made on files directly (it should be the case for en_US), it is possible to integrate using the GIT system. To do this, create an account on {{TemplateUrlSCM}}, fork the project, edit the relevant files and send a Pull Request.
     −
'' Note:'' The reference language is always complete:
+
If, however, you translated directly in Dolibarr files, then you will first have to transfer those translations to Transifex before they can be included. So, really, you should start translating into Transifex.
* English (Lang directory lang/en_US)
+
If you send us your translation through a Pull Request on Github, sadly, it will be overwritten by the next import from Transifex, so it would be very short-lived.
   −
All other language files are likely to be incomplete.
+
=== Adding new variables ====
 +
 
 +
The reference language is en_US and is always complete. You can find it in the htdocs/langs/en_US/ folder. All other language files are likely to be slightly or highly incomplete, depending on the language.
 +
 
 +
If you are developing a new module, you are likely going to need the addition of new language variables. This is done exclusively through the update of the en_US language (htdocs/langs/en_US/ folder). Just modify these files to add the variable you need and send the resulting folder as part of your Pull Request. Refer to the developer documentation to learn how to contribute code (you will need an account on {{TemplateUrlSCM}}.
    
== As an extension ==
 
== As an extension ==
241

edits

Navigation menu