• Ressources et conventions
• Directives et communication
• Bases à connaitre pour appliquer les traductions dans CiviCRM
  • quels fichiers ?
  • processus de mise à jour des traductions
  • Emplacements des fichiers
  • Traduire une extension
    • officielle
    • un fork ou une extension custom
    • comment être sûr que les .mo soient bien appliqués dans CiviCRM ?
    • Exemples
      • Exemple CiviCase :
• Nom des composants
• Général
  • Verbes et expression
• Contacts
• Autres
• CiviContribution
• CiviEvent
  • CiviMail
• CiviGrant / CiviSubvention
  • CiviBooking/Réservations
  • CiviCase / Dossiers
  • CiviMember /Adhésions
• Débats

French translation resources / Ressources de traduction pour la traduction de CiviCRM en français.

Ressources et conventions

• Traduction du guide d'utilisation et administration : https://github.com/civicrm-french/civicrm-user-guide
• La traduction est gérée sur le site Transifex en deux versions du français : fr_FR et fr_CA
• Pour le fr_FR le glossaire est utilisé pour aider les contributeurs à harmoniser (même si ce n'est pas parfait).
• Office québécois de la langue française : http://www.granddictionnaire.com
• Glossaire de Drupal (Google Docs)
• Conventions typographiques de Wikipédia Fr
• Traduction épicène: utiliser les règles de traduction francophone de Wordpress

Directives et communication

• Si vous n'êtes pas d'accord avec un terme de la traduction québécoise, déplacez le terme dans la colonne fr_CA et ajoutez un commentaire pour expliquer pourquoi. Nous voulons harmoniser les deux traductions le plus possible.
• Contactez-nous sur le canal francophone du Mattermost de CiviCRM. Pour fr_CA: bgm, samuelsov, urlisse. Pour fr_FR : usha.makoa.
• Si c'est un bug dans le code original (i.e. une chaîne absente de Transifex), ouvrir un billet sur le projet 'Translation' du Gitlab de CiviCRM ou faire un PR (ajouter E::ts() en général).

Bases à connaitre pour appliquer les traductions dans CiviCRM

quels fichiers ?

• le fichier .po est éditable. Il contient les chaînes à traduire et leur traduction : c'est dans ce fichier qu'on ajoute des traductions.
• le fichier .mo est compilé (pour permettre une recherche rapide des chaines traduites à l'extension)

processus de mise à jour des traductions

• Le Core et les extensions officielles sont traduisibles dans https://www.transifex.com/civicrm/ et https://www.transifex.com/civicrm_extensions/ (il faut créer un compte et une autorisation)
• Toutes les nuits, civicrm.org récupère les traductions du Core depuis transifex.
  • On peut trouver une mise à jour quotidienne des .mo ici :
    • Core - http://download.civicrm.org/civicrm-l10n-core/mo/fr_CA/civicrm.mo
    • Extension - https://download.civicrm.org/civicrm-l10n-extensions/mo/monextension/fr_FR/monextension.mo
• Les CiviCRM installés devraient se mettre à jour quotidiennement ensuite. Mais ca bugue souvent.
• L'extension uplang (2023) de CiviCRM permet de récupérer aussi les traductions pour les extensions.
• Les chaines à traduire sont marquées par la fonction ts() dans le code.

Emplacements des fichiers

• les fichiers de lang des extensions sont placés dans l'extension : /l10n/fr_FR/LC_MESSAGES
• l'extension uplang télécharge les .mo dans un dossier par langue ici civicrm/l10n/

Traduire une extension

officielle

Une extension officielle est publiée sur le site CiviCRM et a déjà un fichier de traduction sur transifex

• se placer dans le dossier de l'extension par exemple : ext/org.civicrm.cdntaxreceipts/
• créer le dossier où les traductions sont attendues : l10n/fr_FR/LC_MESSAGES
• cd l10n/fr_FR/LC_MESSAGES
• télécharger le fichier .mo qui a été créé sur le dépot de civicrm la nuit dernière : wget https://download.civicrm.org/civicrm-l10n-extensions/mo/cdntaxreceipts/fr_FR/cdntaxreceipts.mo
• valider que les fichiers de traduction ont bel et bien la traduction présente : msgunfmt cdntaxreceipts.mo -o cdntaxreceipts.po .

un fork ou une extension custom

Dans ce cas le fichier de traduction n'existe pas ou est partiel sur transifex (nouvelles chaines à traduire qui n'apparaitront pas dans transifex)

• se placer dans le dossier de l'extension par exemple : ext/org.civicrm.cdntaxreceipts/
• créer le dossier où les traductions sont attendues : l10n/fr_FR/LC_MESSAGES
• créer le fichier .po
  • générer le fichier .po avec les chaines à traduire à partir du code de l'extension
    • se placer à la racine de l'extension pour scanner les ts() dans les fichiers
    • vérifier que civistrings est installé sur le serveur https://github.com/civicrm/civistrings
    • civistrings -o l10n/fr_FR/LC_MESSAGES/cdntaxreceipts.po .
  • si c'est un fork d'une extension officielle on peut récupérer ce qui est déjà traduit en téléchargeant le fichier .po avec les traductions depuis transifex (aller dans civicrm_ressources et l'extension et télécharger les traductions)
• éditer le fichier .po (soit dans un éditeur de texte soit avec POEdit) pour traduire les chaines manquantes
• se placer dans /l10n/fr_FR/LC_MESSAGES
• compiler le fichier .po en .mo msgfmt -o cdntaxreceipts.mo cdntaxreceipts.po

comment être sûr que les .mo soient bien appliqués dans CiviCRM ?

Normalement rien n'est nécessaire. Au pire, redémarrer php-fpm

Exemples

Exemple CiviCase :

cd uk.co.compucorp.civicase
civistrings -o l10n/fr_FR/LC_MESSAGES/civicase.po .
# ajouter une en-tête au .po (c.f. autres .po)
# traduire
# ..puis compilation
msgfmt -o l10n/fr_FR/LC_MESSAGES/civicase.mo l10n/fr_FR/LC_MESSAGES/civicase.po

Nom des composants

Pour éviter d'alourdir inutilement la traduction, on laisse tomber le préfixe "Civi" des composantes. Elles devraient être traduits selon le lexique suivant :

Général

Verbes et expression

Contacts

Autres

Autres termes (à trier?) qui ne sont pas spécifiques à une composante:

CiviContribution

Pour les traductions de termes comptables / finances on pourra se référer à ce glossaire/lexique relativement complet

CiviEvent

CiviMail

CiviGrant / CiviSubvention

CiviBooking/Réservations

CiviCase / Dossiers

CiviMember /Adhésions

Débats

• Est-ce qu'on traduit les noms de composantes? (CiviMail, CiviMember, etc)

  • XD: on en avait discuté, et la conclusion est que tu traduis pas (tu utilises pas microsoft fenêtre pour écrire avec microsoft mot)
  • ML: mais on parle ici de composantes, pas du nom du logiciel. Par exemple, dans Drupal, les "views" deviennent des "vues". Même pour les marques, on dit "Microsoft" et non "Maycrosoft". On dit "tableur" ou feuille de calcul, et non Excel. Je serais même tenté de dire que CiviMail devrait tout simplement être "Envois massifs". CiviMail veut rien dire. Tout comme CiviMember devrait tout simplement être "Adhésions". C'est normal d'adapter quand on le peut, i.e. quand ça ne cause pas de confusion. Au Québec de nombreux magasins ou compagnies ont un nom français et anglais. Les gens peuvent être bilingues ou trilingues, mais ils vont généralement préférer un terme en français, surtout à l'écrit.
  • JC: L'équipe fr_CA a décidé de traduire les termes. Les noms "Civi" ne sont probablement pas importants pour les utilisateurs finaux, ce qui compte c'est la sémantique. Par contre on reconnaît l'importance d'être 100% consistants dans la traduction, pour éviter la confusion des administrateurs/développeurs. Voir le lexique.

• Ponctuation : on ajoute un espace avant :? ! et :   ?

  • JC: L'équipe fr_CA est d'accord de mettre des espaces réguliers devant ces caractères. L'insertion d'espaces insécables devraient se faire automatiquement (en PHP).

• Guillemets : on les copie tels-quels de l'anglais ou on convertit aux guillements français ? -> afin d'éviter de générer des bugs en traduisant, il est préférable d'utiliser (autant que possible) les mêmes quotes (simple ou double) que dans la version anglaise et de banir toute utilisation des guillemets (telle qu'utilisée dans les logiciels de bureautique << >>).

  • JC: L'équipe fr_CA est d'accord pour utiliser les guillemets français, selon la norme Wikipedia Fr.

• La traduction litérale des termes peut générer des aberrations dans l'interface, il est préférable de traduire les libellés en fonction de leur contexte. -> Oui mais pour les traductions dont le terme anglais a le même sens, il faut choisir un seul terme français. La cohérence est un gros problème dans la traduction actuelle.

• Comptes-rendus ou rapports ?
  UFM : "Report" a longtemps été traduit par "Compte-rendu" en français de France (fr_FR) dont la définition selon Wikipedia est : "Un compte rendu est un document qui fait état d'un rapport, exposé, ou relation de certains faits particuliers ou d’une réunion." On préférera la traduction "Rapport" plus neutre en ce sens qu'il n'est pas lié à une "réunion". On aurait aussi pu utiliser "Etat" (encore plus large) mais cela aurait pu prêter à confusion avec "état" au sens de "statut"/status.

• En 2020/2021 un sprint a permis de passer la traduction en français de 70% à 100% (notamment après tous les contributeurs du passé, avec usha.makoa et guillaume_allinappli).

• Mailings ou envois massifs ou envois en masse ?

  2023 : UFM : Mailings est plus clair pour les utilisateurs, c'est ce qu'on a harmonisé en français.
  2020 : UFM : Nous excluons l'anglicisme "mailings". En français de France (fr_FR) il nous apparaît que "envois en masse" est le plus approprié (il nous semble que c'est en masse, au sens de "en lot", que se fait l'envoi mais que l'envoi n'est pas à proprement parler "massif", comme l'or ou le bois le serait ;-) ). Mais nous avons laissé "envois massifs" dans la version fr_CA qui semble convenir.