Documentation traducteur: Difference between revisions

 

<seo metak="traduction, documentation, traducteur, localisation, localiser, internationalise, langage" />

= [[File:Language.png]] Traduire l'application Dolibarr dans une autre langue =

# Manuelle en utilisant Transifex.com (officielle et recommandée).

# Manuelle par modification des fichiers langues

# Automatique avec autotranslator.php

== Traduction manuelle en utilisation le service en ligne de traduction Transifex (recommandé) ==

Si vous souhaitez contribuer à la traduction de Dolibarr dans votre langue, référez-vous s'il vous plaît au lien suivant : http://transifex.com/projects/p/dolibarr/,

puis vérifiez si votre langue est prise en compte.

===Utilisation de l'interface Web (pour les traducteurs) ===

Si la langue est déjà disponible sur la page http://transifex.com/projects/p/dolibarr/ , créez un compte et suivez les instructions du site Web de transifex pour traduire les fichiers.

=== Using TX command line client (for Dolibarr [[:Category:Yoda]] team) ===

This describe how to use Transifex from command line. However, this is reserved to Dolibarr admin users to synchronize Transifex with Dolibarr main sources.

[http://docs.transifex.com/developer/client/ Official documentation]

First install TX Client.

With Debian/Ubuntu/Mint:

Then you have to initialize your TX environment. This is done by running '''tx init''' into dolibarr project root directory.

Accept to overwrite config file. Keep default value for Transifex instance, then enter your Transifex login and password.

After this, a .transifexrc has been created into your HOME dir and a generic config file has been created as '''.tx/config''' in project's root.

So your directory's contents will look like that:

source_lang: this is the source language of the resource.<br/>

source_file: this points to the source file directly.<br/>

file_filter: here we hold the expression used to identify translation files under the specific project. ''not mandatory''<br/>

trans.<lang>: this is used for translation files that don’t follow a common naming schema and the file expression cannot be used to track them. ''not mandatory''<br/>

host: in case the project doesn’t use the default Transifex server as specified in the [main] section, it can override it using this option. ''not mandatory''<br/>

Used to pull changes from Transifex server to your computer<br/>

=== Other questions on transifex process ===

== Traduction manuelle complètement (non recommandé) ==

 

* OS du traducteur: Tous

* Outil: autotranslator.php fourni avec Dolibarr dans le répertoire '''dev/translation'''.

Par exemple :

= [[File:Language.png]] Diffusion ou intégration en standard de votre traduction =

Si vous avez complété des fichiers .lang existant déjà dans Dolibarr mais incomplets ou si vous avez créé des nouveaux fichiers .lang pour une nouvelle langue, vous pouvez :

* Si la traduction a été faite en utilisant le système Transifex, il n'y a rien de particulier à faire. Votre traduction sera intégré lors des synchros régulières qui ont lieu avec les sources Git officielles (au moins 1 par mois).

* Si la traduction a été faite dans des fichiers directement pour les langues en_US, pt_BR, xx_ES, ..., il est possible de les intégrer si vous connaissez le système GIT. Pour cela, créer un compte sur {{TemplateUrlSCM}}, forker le projet, modifier les fichiers concernés et envoyer une Pull Request. A défaut de savoir utiliser GIT, envoyer vos fichiers sur la mailing-list des développeurs '''dolibarr-dev''' (Inscription sur {{TemplateURLMLDev}}.

* L'anglais (fichiers .lang du répertoire lang/en_US)

= [[File:Language.png]] Traduire la documentation du wiki =