Dolibarr ERP CRM Wiki - User contributions [en]

Documentation traducteur

2017-04-04T12:21:52Z

Clement.correia: /* File:Language.png Traduire la documentation du wiki */

<keywords content="traduction, documentation, traducteur, localisation, localiser, internationalise, langage" />
= [[File:Language.png]] Traduire l'application Dolibarr dans une autre langue =
Dolibarr est livré avec plusieurs langues. Par défaut, l'Anglais est toujours complet. Les autres langues dépendent des contributions. Cette documentation vous présente comment traduire les fichiers langues pour ajouter une langue non traduite ou traduite de manière incomplète.

Il existe 3 méthodes pour réaliser la traduction de Dolibarr:
# Manuelle en utilisant Transifex.com (officielle et recommandée).
# Manuelle par modification des fichiers langues
# Automatique avec autotranslator.php

Les voici par ordre de préférences:

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

Transifex est une solution web qui fournit une plateforme pour la traduction des projets. Cela inclut la gestion d'équipes et de discussions, la mémoire de traduction, glossaires, and nombreuses autres fonctionnalités.
C'est assez simple d'utilisation et toute traduction peut être soumise ou récupérer à traver de l'interface web ou en utilisant le client TX dans un terminal.
Transifex est un projet Open Source avec une "édition communautaire" qui peut être téléchargé librement, mais on va utilier le service hébergé en ligne.

{{ToTranslate}}

==Créer un compte transifex et choisissez votre langue==
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.
Si elle existe (plusieurs équipes sont disponibles pour travailler sur le projet), vous pouvez demander à rejoindre l'équipe et commencer à traduire tout de suite. S'il n'existe pas d’équipe pour votre langue, vous pouvez demander une nouvelle équipe sur Transifex. Cela peut être fait directement sur le site Web de http://transifex.com

===Using the web interface (for translators) ===
If language is already available onto page http://transifex.com/projects/p/dolibarr/, just create an account and follow instruction of transifex web site to translate files.

Note, that this web interface must not be used to translate en_US language that is source. Any change on source language must be done by submiting code change using GitHub Pull Requests.

=== 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]

====TX Client configuration====
First install TX Client.
With Debian/Ubuntu/Mint:
<source lang="bash">
apt-get install python-pip
pip install transifex-client
</source>
Then you have to initialize your TX environment. This is done by running '''tx init''' into dolibarr project root directory.
<source lang="bash">
cd git/dolibarr
tx init
</source>
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:
<code><pre>
.
|-- build
|-- build.xml
|-- ChangeLog
|-- COPYING
|-- COPYRIGHT
|-- dev
|-- doc
|-- .gitignore
|-- htdocs
|-- INSTALL
|-- pom.xml
|-- quickbuild.xml
|-- README
|-- README-FR
|-- README.md
|-- robots.txt
|-- scripts
|-- test
`-- .tx
</pre></code>

The current config file can be downloaded from https://github.com/Dolibarr/dolibarr/tree/develop/.tx , put it into .tx directory, overwriting the one created by '''tx init'''

This project configuration file is used to store the project’s details and the file-to-resource mappings.

That is a sample of what the config file contains:

<source lang="ini">
[main]
host = https://www.transifex.com
lang_map = uz: uz_UZ

[dolibarr.admin]
file_filter = htdocs/langs/<lang>/admin.lang
source_file = htdocs/langs/en_US/admin.lang
source_lang = en_US
type = MOZILLAPROPERTIES
</source>

Here is an explanation of the sections and options used in the config file:

<nowiki>[main] section</nowiki>

In this section we have project-wide options, such as the default transifex host for all projects. These can be overriden by each resource, in case it is needed.

<nowiki>[dolibarr.resource]</nowiki>

source_lang: this is the source language of the resource. 
source_file: this points to the source file directly. 
file_filter: here we hold the expression used to identify translation files under the specific project. ''not mandatory'' 
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'' 
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'' 

====TX Client use====
Some useful information on '''tx''' commands.

'''tx status'''

Show status of translations

'''tx push'''

Used to push changes from your computer to Transifex server 
Additional options for the tx push command are:
<code><pre>
-h - Shows the help screen for the command
-l <lang> - Specify which translations you want to push (defaults to all)
-r <resource> - Specify the resource for which you want to push the translations (defaults to all)
-f - Push source files without checking modification times
--skip - Don't stop on errors. Useful when pushing many files concurrently.
-s - Push the source file to the server
-t - Push the translation files to the server
--no-interactive - Don't require user input when forcing a push</pre></code>

'''tx pull'''

Used to pull changes from Transifex server to your computer 
Additional options for the tx pull command are:
<code><pre>
-h - Shows the help screen for the command
-l <lang> - Specify which translations you want to pull (defaults to all)
-r <resource> - Specify the resource for which you want to pull the translations (defaults to all)
-a - Fetch all translation files from server (even new ones)
-s - Force the fetching of the source file (default: False)
-f - Force download of translations files
--skip - Don't stop on errors. Useful when pushing many files concurrently.
--disable-overwrite - By default Transifex will fetch new translations files and replace existing ones. Use this flag if you want to disable this feature.
--minimum_perc=VALUE - Specify the minimum acceptable percentage of a translation in order to download it.</pre></code>

'''Examples'''

To pull translation files, you can use:

<source lang="bash">
tx -d pull -l it_IT # Get italian language only
tx -d pull -a # Get all languages
</source>

To push source files, just type:

<source lang="bash">
tx -d push -t -l it_IT [-r dolibarr.file] # To push only a specific translation file
tx -d push -s # To push source file
</source>

=== Other questions on transifex process ===
This is short questions and answer yuo may also ask about transifex translation process:

1) Is the sync on a regular time interval ?

No. It is done where there is enough translation submited. It is also done on a beta branch just before creating the final release package.

2) Are all the translations synced to git, or only the reviewed translations. Do I need to review before sync is done ?

When a Sync is done, transifex files overwrites files into git, but only if there is at least on record modified for the file.
You don't have to make review before sync is done. Making review is above all to know which lines were manually reviewed and wich one were intially translated using a robot.

3) In which Dolibarr releases will translations be available ? Are transifex translations also synced to maintenance releases ?

Sync is always done on develop and/or beta.
So transifex changes appear in all version whose branch is created after the transifex change (a sync is always done before creating a new branch). Once a branch is created, then new changes into transifex will be available only for next branch. Reason of this is that transifex is not able to manage branch/versions (not yet).

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

Pour traduire Dolibarr dans une autre langue, il faut aller dans le répertoire langs et créer un répertoire ayant pour nom le code langue à traduire (En suivant le même format que ceux déjà existant, par exemple en_US, fr_FR, es_ES, de_DE, etc...).
Il faut ensuite recopier les fichiers lang depuis un répertoire déjà traduit (par exemple en_US/main.lang ou fr_FR/bills.lang), les recopier dans le répertoire de la nouvelle langue que l'on vient de créer et traduire le contenu de ces fichiers.

Ces fichiers sont constitués de la manière suivante:

<source lang="ini">
Code1=Phrases à traduire 1
Code2=Phrases à traduire 2
...
Coden=Phrases à traduire n
</source>

Seules les phrases à droite du = sont à traduire, le code doit rester inchangé.
Il est possible de traduire les fichiers un par un, sans tous les traduire d'un coup. Si un fichier n'a pas été traduit dans la nouvelle langue, Dolibarr utilisera l'anglais.

Pour avoir une chaine variable selon la langue dans le code PHP, tout ce que vous avez à faire et de charger le fichier lang et d'utiliser la méthode pour récupérer la variable traduite. Ceci peut se faire de la manière suivante:

<source lang="php">
$langs->load("nomdufichier"); // ou $langs->load("nomdufichier@monmodule") si monfichier.lang est dans le répertoire htdocs/monmodule/langs/xx_XX

print $langs->trans("CodeX")
</source>

Et une entrée du type
<source lang="ini">
CodeX=Phrase X
</source>

doit être ajoutée aux fichiers .lang

== Traduction automatique avec l'outil autotranslator.php (non recommandée) ==

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

Pour traduire ou mettre à jour tous les fichiers dans une nouvelle langue, lancez simplement le script:
<source lang="bash">
php autotranslator.php lang_code_source lang_code_target GOOGLEAPIKEY
</source>
Par exemple :
<source lang="bash">
php autotranslator.php en_US pt_PT GOOGLEAPIKEY
</source>
pour traduire en portugais (pt_PT) en utilisant l'anglais (en_US) comme fichiers sources.

Tous les fichiers non existant seront créés, et ceux existant déjà seront mis à jour pour être complétés avec les chaines manquantes.
Les chaines déjà traduites sont conservées tel quelles.
L'outil utilise le service de [http://translate.google.com traduction Google] pour trouver la valeur traduite d'une chaine, aussi un accès internet depuis le poste où est lancé la commande est requis.
De plus, une clé pour utiliser les API Google Translate sont nécessaire et Google fait payer l'utilisation de cette API (20 $ / 1 000 000 de caractères traduits).
Votre PHP doit de plus avoir les permissions d'écrire dans le répertoire '''htdocs/langs''' directory et doit avoir les fonctions de l'extension curl disponibles.

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

La meilleure chose à faire, après avoir réalisé une traduction, est de les inclure dans la version officielle de Dolibarr.

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}}.

''Remarque:'' Il y a une langue maitre toujours complète:
* L'anglais (fichiers .lang du répertoire lang/en_US)
Tous les autres fichiers langues sont susceptibles d'être incomplets.

= [[File:Language.png]] Traduire la documentation du wiki =
Le wiki est maintenu en 3 langues: Anglais, Français et Espagnol.
Si vous voulez améliorer la documentation d'une de ces langues, il vous suffit de créer un compte sur ce wiki.
Ensuite, vous pouvez modifier toute page qui possède une traduction incorrecte ou traduire une page qui attend d'être traduite. La liste de ces pages est disponible sur la page [[:Category:Page_waiting_for_translation]].

List of modules id

2017-04-04T08:10:14Z

Clement.correia:

[[Category:Core]]
{{TemplateDocDevEn}}
{{TemplateDocDevEs}}
{{TemplateDocDevFr}}

{{Flag en}} This page list all reserved modules numbers / ID. If you build or want to build your own modules (like this [[:Category:Complementary_modules|complementary module]]), you should take an ID range here.

{{Flag fr}} Cette page recense tous les numéros / ID réservés de modules. Si vous avez réalisé ou voulez réaliser vos propres modules (comme les [[:Category:Modules complémentaires|modules complémentaires suivant]]), vous devriez prendre une plage d'ID ici.

{{Flag sp}} Esta página contiene un listado de todos los id reservados para los módulos. Si ha creado o quiere realizar sus propios módulos, (como estos [[:Category:Módulos_complementarios|módulos complementarios]]), deberá reservarse un rango de ID aquí.

= ID 0 - 99999 =
{{Flag en}} Reserved for Dolibarr's internal modules.

{{Flag fr}} Réservé aux modules internes de Dolibarr.

{{Flag sp}} Reservado a los módulos internos de Dolibarr.

= ID 100000 - 499999 =
{{Flag en}} Reserved area for editors in need for an ID range. You can edit this page to add your own range (limited to 1000 values per editor)

{{Flag fr}} Zone réservé aux éditeurs qui ont besoin d'une plage d'ID spécifiques. Vous pouvez modifier cette page pour réserver votre plage (limité à 1000 valeurs par éditeur)

{{Flag sp}} Área reservada para los partners que necesiten un rango de ID. Puede modificar esta página para reservar su rango (limitado a 1000 valores por editor)

* ID 100000 - 100999: OpenThink (http://www.openthink.be)
* ID 101000 - 101999: NLTechno (http://www.nltechno.com)
* ID 102000 - 102999: Tiaris (http://www.tiaris.fr)
* ID 103000 - 103999: Open-concept.pro (http://www.open-concept.pro)
* ID 104000 - 104999: ATM Consulting (http://www.atm-consulting.fr)
* ID 105000 - 105999: GPC.solutions
* ID 106000 - 106999: PHPASSO
* ID 107000 - 107999: TecLib (http://www.teclib.com) / Auguria (http://www.auguria.net)
* ID 108000 - 108999: ETHICWEB
* ID 109000 - 109999: Aplose (http://www.aplose.fr)
* ID 110000 - 110999: Aternatik
* ID 111000 - 111999: Asset IT (www.assetit.ch)
* ID 112000 - 112999: Aarboard AG (www.aarboard.ch)
* ID 113000 - 113999: Asilib - Alexandre Spangaro
* ID 114000 - 114999: Iceleaf OÜ
* ID 115000 - 115999: 2A2C Conseil - Cyril ZEKSER
* ID 116000 - 116999: Wolftec GmbH
* ID 117000 - 117999: Oscim (http://www.oscim.fr)
* ID 118000 - 118999: Oarces Web (dev.oarces.com)
* ID 119000 - 119999: Manuel Berrocal - Absolacom
* ID 120000 - 120999: Régis Houssin (http://www.inodbox.com)
* ID 121000 - 121999: Oscss - Shop
* ID 122000 - 122999: MrSof - la Nation du Web
* ID 123000 - 123999: Bruno Généré (webiseasy.org)
* ID 124000 - 124999: backbone internet service (www.backbone.co.at)
* ID 125000 - 125999: ProgSI (www.progsi.ma)
* ID 126000 - 126999: Catalanet
* ID 127000 - 127999: Virgilio Filho pt-BR Brasil (@dolibarr.br)
* ID 128000 - 128999: Nicolas Frappé France (www.sospc.info)
* ID 130000 - 130999: Technicks ICT (http://www.technicks.eu)
* ID 140000 - 140999: Altairis
* ID 150000 - 150999: Jeffinfo
* ID 160000 - 160999: Charles-François BENKE (http://www.patas-monkey.com)
* ID 162000 - 162999: Jacques Rébiscoul
* ID 163000 - 163999: Open-DSI (https://www.open-dsi.fr)
* ID 180000 - 180999: Triangle Ingénierie
* ID 190000 - 190999: Diciannove (http://19.coop)
* ID 199000 - 199999: RFMS
* ID 200000 - 200999: Noxiome
* ID 201000 - 201999: Sasa Ostrouska (saxa)
* ID 202000 - 202999: Z-Application
* ID 203000 - 203099: Elidee - elidee.com
* ID 203100 - 203999: Garcia MICHEL (soamichel.fr)
* ID 204000 - 204999: Ari Elbaz elarifr - accedinfo.com
* ID 205000 - 205999: Kreiz IT
* ID 206000 - 206999: GBINFO (www.gbinfo.fr)
* ID 300000 - 300999: AtooNet (http://www.atoo-net.com)
* ID 400000 - 400999: 2byte.es (http://www.2byte.es)
* ID 401000 - 401999: B&D Informática
* ID 402000 - 402999: Marcos García de La Fuente (marcosgdf)
* ID 403000 - 403999: Sergibyte (http://www.sergibyte.com)
* ID 404000 - 404999: Aikhan
* ID 405000 - 405999: AIME (http://www.aime.mx)
* ID 420000 - 420099: BBS Concept
* ID 420100 - 420199: LeMousticProduction (www.lemousticproduction.info) -< module DoliRH
* ID 420200 - 421199: VatCheck (www.abnc.be)
* ID 422200 - 422999: Artaban (http://artaban.fr)
* ID 423000 - 423050: cyberesprit
* ID 424000 - 424999: A3sys - Mon-Dolibarr (http://www.mon-dolibarr.fr)
* ID 425000 - 425999: Sébastien SERRE Thivinfo (www.thivinfo.com)
* ID 426000 - 426099: Arkesis-Solution
* ID 426100 - 426149: GetLandy (www.getlandy.com)
* ID 426150 - 426649: OOB Software
* ID 426650 - 426849: Soft-Task Serviços e Sistemas (www.soft-task.com.br)
* ID 426850 - 427000: Bruno Caldas (https://github.com/BCaldas)
* ID 427001 - 427999: Kevin GUERRIER (alias xcl.saian)
* ID 428000 - 428099: af83
* ID 429000 - 429999: induslab
* ID 430000 - 430099: Mixity sprl (www.mixity.be)
* ID 430100 - 430199: sgiraud
* ID 430200 - 430299: Merlion TI (www.merlion-si.com.br)
* ID 430300 - 431299: Libre Expert (www.libre-expert.com)
* ID 431300 - 431399: ptibogxiv (www.ptibogxiv.net)
* ID 431400 - 431499: Befox (www.befox.fr)
* ID 431500 - 431599: rue Béjo (www.ruebejo.fr)
* ID 431600 - 431699: Avizzeo (www.avizzeo.com)

= ID > 500000 =
{{Flag en}} If you don't already have reserved ids and need some, please don't use hazardous number and use a number higher than 500000, but it is better to ask a wiki account, and reserve your own range by editing the 100000 - 499999 range (1000 ids maximum per partner).

{{Flag fr}} Si vous n'avez pas de numéros réservés et en avez besoin, n'utilisez pas de chiffres au hasard et utilisez une valeur supérieure à 500000, toutefois, il est préférable d'obtenir un compte wiki, et réserver vous-même votre plage en ajoutant votre entrée dans la zone 100000 - 499999 (pas plus de 1000 numéros par partenaire).

{{Flag sp}} Si no dispone de número reservado y necesita, no use cifras redondeadas y usa un valor superior a 500000. Si tiene una cuenta wiki, puede reservarse usted mismo sus id añadiendo su entrada en la zona 100000 - 499999 (no más de 1000 id por partner).