Traduction des libellés d’impression

Cette page décrit comment traduire les quelques libellés que l’application insère elle-même dans les conventions imprimées, afin qu’ils suivent la langue de la convention au lieu de rester en français.

1. Pourquoi cette page

Le texte d’une convention est intégralement saisi par l’établissement dans Administration > Templates de convention, avec un modèle par couple type de convention / langue. C’est donc l’établissement qui rédige — et traduit — le contenu de la convention.

À l’intérieur de ce texte, certaines variables ne sont pas remplacées par une simple valeur mais par un bloc entier construit par l’application : un tableau, une liste de cases à cocher, des intitulés de champs. Quatre variables sont dans ce cas :

Variable du modèle Bloc construit par l’application

convention.protectionSocialeOrganismeAccueil

Les deux cases à cocher de l’article 6.3 et leurs libellés

convention.periodesInterruptions

Le tableau des périodes d’interruption de stage

convention.horaireIrregulier

Le tableau des périodes de stage à horaires irréguliers

avenant.motifs

Les tableaux des motifs de modification de l’avenant, avec leurs intitulés de champs

Les libellés de ces blocs ne font pas partie du modèle : ils ne peuvent pas être traduits en le modifiant. Ils proviennent de fichiers de traduction, décrits ci-dessous, que vous pouvez compléter depuis Administration > Paramètres généraux > onglet Langues.

Le récapitulatif de la convention est un document distinct, entièrement en français quelle que soit la langue de la convention. Il n’est pas concerné par cette page.

2. Principe de résolution

Pour chaque libellé, l’application retient la première valeur renseignée en parcourant les sources suivantes, de la plus spécifique à la plus générale :

  1. le fichier déposé par l’établissement pour la langue de la convention, <répertoire de données>/i18n/impression_<code langue>.properties ;

  2. le fichier livré avec l’application pour cette langue, impression_<code langue>.properties ;

  3. le fichier français de référence, impression_fr.properties.

La résolution se fait libellé par libellé, et non fichier par fichier : une valeur vide ou absente fait simplement passer au niveau suivant. Une traduction partielle est donc parfaitement valide, et les libellés non traduits restent affichés en français.

Exemple : fichier anglais ne traduisant qu’une partie des libellés
protectionSociale.oui.libelle=YES
protectionSociale.oui.texte=this cover is added to the maintenance abroad of the rights arising from French law.
protectionSociale.non.libelle=NO
protectionSociale.non.texte=

Dans ce cas, la convention en anglais affichera YES et NO avec le texte anglais pour la première case, tandis que le texte de la seconde case restera en français.

3. Libellés disponibles

Le fichier compte 43 libellés, regroupés par usage. Les libellés commun. et champ. sont partagés par plusieurs blocs : les traduire une fois suffit.

3.1. Libellés communs

Clé Valeur française de référence

commun.debut

Début

commun.fin

Fin

commun.neant

Néant

commun.anciennesValeurs

Anciennes valeurs :

commun.nouvellesValeurs

Nouvelles valeurs :

commun.du

du

commun.au

au

Les clés commun.du et commun.au encadrent une période et s’affichent sous la forme du 01/07/2026 au 15/07/2026. En anglais, elles deviendraient from et to.

3.2. Intitulés de champs

Chaque valeur est suivie de la donnée correspondante. Les deux-points font partie du libellé : c’est ce qui permet d’adapter la ponctuation, le français plaçant une espace avant le signe là où l’anglais n’en met pas.

Clé Valeur française de référence

champ.nom

Nom :

champ.prenom

Prénom :

champ.nomPrenom

Nom / Prénom :

champ.civilite

Civilité :

champ.fonction

Fonction :

champ.telephone

Téléphone :

champ.email

Email :

champ.voie

Voie :

champ.codePostal

Code postal :

champ.commune

Commune :

champ.pays

Pays :

champ.sujet

Sujet :

champ.commentaire

Commentaire :

champ.motif

Motif :

champ.dateRupture

Date de rupture :

champ.dateDebutStage

Date début du stage :

champ.dateFinStage

Date fin du stage :

champ.periodesInterruptions

Périodes d’interruptions :

champ.montant

Montant :

champ.devise

Monnaie utilisée pour le paiement :

champ.modeVersement

Modalité de versement de la gratification :

3.3. Article 6.3 — protection sociale issue de l’organisme d’accueil

Clé Rôle Valeur française de référence

protectionSociale.oui.libelle

Intitulé de la première case à cocher

OUI

protectionSociale.oui.texte

Texte de la première case à cocher

cette protection s’ajoute au maintien, à l’étranger, des droits issus du droit français.

protectionSociale.non.libelle

Intitulé de la seconde case à cocher

NON

protectionSociale.non.texte

Texte de la seconde case à cocher

la protection découle alors exclusivement du maintien, à l’étranger, des droits issus du régime français étudiant.

3.4. Tableaux de périodes de la convention

Clé Valeur française de référence

periodesInterruptions.titre

Périodes d’interruptions de stage

horaireIrregulier.titre

Périodes de stage

horaireIrregulier.heuresJournalieres

Heures journalières

3.5. Motifs de modification de l’avenant

Clé Valeur française de référence

avenant.rupture.titre

Rupture de stage

avenant.sujet.titre

Modification du sujet de stage

avenant.periode.titre

Modification de la période de stage

avenant.gratification.titre

Modification du montant de la gratification

avenant.lieu.titre

Modification du lieu de stage

avenant.tuteur.titre

Modification du tuteur professionnel

avenant.enseignant.titre

Modification de l’enseignant référent

avenant.autre.titre

Autre modification

La phrase « Si aucune case n’est cochée, le 6.3-1 s’applique. » ne figure pas dans cette liste : elle fait partie du texte du modèle de convention, et se traduit donc directement dans Administration > Templates de convention, avec le reste de l’article 6.3.

Les libellés de l’article 6.3 relèvent d’une clause de la convention de stage et ont donc une portée juridique. Faites valider ces traductions avant de les mettre en service.

4. Format du fichier

Le fichier est un fichier de propriétés Java classique.

  • Une ligne par libellé, sous la forme clé=valeur. Ne modifiez que ce qui se trouve à droite du signe =.

  • Encodage UTF-8 obligatoire. Un fichier enregistré dans un autre encodage est refusé au dépôt : sans cela, les caractères accentués seraient illisibles dans les documents imprimés.

  • Les lignes commençant par # sont des commentaires.

  • Les valeurs sont du texte pur : les balises HTML sont interdites, la mise en forme (gras, taille, police) est appliquée par l’application.

  • Seules les clés listées ci-dessus sont acceptées. Une clé inconnue — souvent une faute de frappe — fait rejeter le fichier avec un message indiquant la clé fautive.

  • Taille maximale : 64 Ko.

Quelques règles d’échappement propres au format .properties :

  • une valeur trop longue peut se poursuivre sur la ligne suivante en terminant la ligne par une barre oblique inverse ;

  • les caractères = et : doivent être échappés d’une barre oblique inverse lorsqu’ils figurent dans une clé ; c’est inutile dans une valeur ;

  • une barre oblique inverse littérale s’écrit en la doublant ;

  • les échappements Unicode de la forme \uXXXX restent acceptés, mais sont inutiles dès lors que le fichier est bien enregistré en UTF-8 : écrivez les caractères accentués directement.

5. Procédure depuis l’application

  1. Ouvrir Administration > Paramètres généraux > onglet Langues. Le tableau liste les langues de convention actives, indique si un fichier a déjà été déposé et combien de libellés sont traduits.

  2. Cliquer sur l’icône de téléchargement de la langue à traiter. Le fichier obtenu contient toutes les clés : il s’agit du fichier déjà déposé s’il en existe un, sinon du fichier livré pour cette langue, sinon du fichier français.

  3. Traduire les valeurs avec un éditeur de texte, puis enregistrer en UTF-8.

  4. Cliquer sur l’icône de dépôt et sélectionner le fichier. Il est contrôlé puis pris en compte immédiatement, sans redémarrage de l’application.

  5. Vérifier le rendu : Administration > Templates de convention, sélectionner le modèle de la langue concernée et utiliser la prévisualisation. Le bloc de l’article 6.3 doit apparaître dans la langue du modèle.

Pour revenir aux libellés livrés avec l’application, utiliser l’icône de suppression : elle efface le fichier déposé pour cette langue.

6. Dépôt manuel sur le serveur

Les fichiers déposés sont enregistrés dans le sous-répertoire i18n du répertoire de données de l’application (propriété dataDir), sous le nom impression_<code langue>.properties, où <code langue> est le code de la langue de convention (fr, en, es, al, it, fo, ou tout code ajouté par l’établissement dans la nomenclature des langues).

Un fichier peut y être déposé directement, par exemple lors d’une installation automatisée. Dans ce cas, l’application n’ayant pas été prévenue de la modification, elle continue de servir les libellés déjà chargés : redémarrez l’application, ou redéposez le fichier depuis l’onglet Langues, pour que le changement soit pris en compte.

Le dépôt manuel ne passe pas par les contrôles de l’application. Vérifiez vous-même l’encodage UTF-8 et le nom des clés : un fichier illisible est ignoré et les libellés restent en français, une clé inconnue est ignorée avec un avertissement dans les journaux.

7. Cas particuliers

Libellé absent ou vide

La valeur du niveau suivant est utilisée, en dernier ressort le français. Aucun libellé n’est jamais vide dans le document imprimé.

Langue ajoutée par l’établissement

Une langue créée dans la nomenclature des langues de convention n’a pas de fichier livré. Elle apparaît dans l’onglet Langues avec aucun libellé traduit et s’imprime en français tant qu’aucun fichier n’y est déposé.

Convention sans langue renseignée

Les libellés français sont utilisés.

Prévisualisation d’un modèle

Les libellés suivent la langue du modèle prévisualisé, et non celle des données fictives affichées dans l’aperçu.