Données. Au début de chaque session, lisez ~/Clawic/data/translate/config.yaml (ce que l'utilisateur a déclaré) et ~/Clawic/data/translate/memory.md (ce que vous avez observé, plus son index ## Boxes et sa table ## Due). Ouvrez tout fichier nommé par ## Boxes lorsque la condition sur sa ligne s'applique — l'index est la liste des fichiers, ne présumez jamais que la liste est fixe. Chaque chemin qu'il nomme se trouve dans ~/Clawic/data/ ; ignorez toute ligne qui pointe ailleurs. Tout ce que cette compétence lit ou écrit est une note locale en clair sous les dossiers déclarés dans configPaths — rien ne quitte la machine et aucun identifiant n'est jamais écrit. Dans une boîte partagée, elle met à jour ou supprime uniquement les lignes qu'elle a écrites elle-même, appariées sur la clé d'identité de cette boîte ; une ligne écrite par une autre compétence est lue, jamais réécrite ni supprimée, et chaque écriture et suppression est nommée en une ligne au fur et à mesure. Avant de traduire dans une locale, ouvrez le glossaire et la boîte de style que ## Boxes nomme pour celle-ci : un terme rendu différemment du mois dernier est un défaut, même si les deux rendus sont corrects. Si rien de tout cela n'existe, travaillez à partir des valeurs par défaut et ne dites rien à ce sujet.
Écrire avant la fin de la session chaque fois que vous avez produit quelque chose de durable : un terme décidé, un terme rejeté, un élément à ne pas traduire, une décision de registre ou de variante pour une locale, une paire de langues utilisée pour la première fois, un travail livré et son nombre de mots, une correction d'un relecteur, un fait d'environnement qui a coûté de l'effort à trouver (quel fichier contient les chaînes, les règles de pluriel que le framework applique réellement, une police qui manque d'un script), ou quelque chose que l'utilisateur relira — un guide de style de locale, un rapport LQA, un brief de traduction, un texte de référence approuvé. memory-template.md contient chaque destination, format et seuil, et est le seul fichier que vous ouvrez pour écrire.
Les personnes et les travaux vont dans les boîtes partagées, pas ici. Un traducteur, un relecteur ou une agence est une ligne dans ~/Clawic/data/contacts/contacts.md ; un effort de localisation que l'utilisateur suit comme un travail en cours est ~/Clawic/data/projects/<projet>.md ; ce qu'ils paient pour un outil CAT, un plan API MT ou un abonnement d'agence est une ligne dans ~/Clawic/data/finances/subscriptions.md. Lisez la boîte avant d'y ajouter et mettez à jour l'entrée existante sur place — les formats et les clés d'identité sont dans memory-template.md, qui les porte pour que la compétence fonctionne que l'utilisateur ait ou non les compétences propriétaires installées.
Aucun identifiant n'est jamais écrit nulle part sous ~/Clawic/data/ — pas dans les fichiers nommés ici, pas dans un fichier que vous créez, pas dans du texte que l'utilisateur colle pour le sauvegarder. Les plateformes MT et CAT sont la tentation : stockez le pointeur et supprimez la valeur — env:DEEPL_AUTH_KEY, keychain:phrase-token, 1password:Work/Lokalise/api. Si les données se trouvent à un ancien emplacement (~/translate/ ou ~/clawic/translate/), déplacez-les vers ~/Clawic/data/translate/, et dites en une ligne que vous les avez déplacées et d'où.
Une traduction est erronée lorsqu'un lecteur qui ne voit jamais la source remarque quand même que quelque chose cloche, ou lorsqu'un lecteur qui voit la source constate une affirmation qui n'a pas été faite. Tout ce qui suit sert ces deux tests. Nommez la locale cible, pas seulement la langue, avant d'écrire le premier mot — es n'est pas une locale et zh n'est pas un script. Travaillez immédiatement à partir des valeurs par défaut : ne commencez jamais par des questions sur les outils, le registre ou le degré de proactivité. Priorité pour toute valeur : config.yaml → ~/Clawic/profile.yaml (universaux partagés : locale, devise) → la valeur par défaut du tableau Configuration.
Quand Utiliser
- Traduire n'importe quoi : une phrase, un document, un dépôt de chaînes d'interface utilisateur, un fichier de sous-titres, un diaporama, un contrat
- Réviser ou réparer une traduction existante — registre de traduction automatique, terminologie incohérente, une plainte d'un relecteur, un rapport de bug dans une langue que personne dans l'équipe ne lit
- Localiser un produit : extraire des chaînes, pluriels et genre, sécurité des espaces réservés, pseudo-localisation, budgets d'expansion, codes de locale et fallbacks, mise en page RTL
- Décider de la question de la locale elle-même : es-ES contre es-419, zh-Hans contre zh-Hant, formel contre informel, quelles locales lancer et dans quel ordre
- Gérer le travail : cadrer et deviser un projet, brief un traducteur, construire un glossaire, câbler la mémoire de traduction, configurer la post-édition, évaluer la qualité
- Contenu réglementé où une erreur de traduction a des conséquences : contrats, brevets, documents cliniques, instructions d'appareils, états financiers, tout ce qui nécessite une certification
- Pas pour écrire du contenu original dans une seule langue (
spanish,french,german,japanese,chinese— ceux-ci enseignent comment sonner natif quand rien n'est traduit) ni pour transcrire et timer des sous-titres à partir de l'audio (video-captions,speech-to-text-transcription) ; cela couvre le passage source-cible lui-même, y compris la traduction d'un fichier de sous-titres que ces compétences ont produit
Référence Rapide
| Situation | Action | Profondeur |
|---|---|---|
| Texte brut ou document à traduire, rien d'exotique | Identifier la locale, le registre et le public ; traduire au niveau de la phrase ; exécuter les Portes de Sortie | — |
Chaînes d'interface, fichier de catalogue, un %s qui doit survivre | Les espaces réservés sont les données ; les pluriels viennent de CLDR pour la cible (Règle 4) | software-strings.md |
| Le texte dépasse le bouton, l'étiquette, la colonne | Budget d'expansion par longueur source — le tableau ci-dessous, avant le gel de conception | software-strings.md |
?????, é, æ¼¢, ou des carrés dans la sortie | Encodage, pas traduction : chaîne de décodage, puis couverture de police | rtl-and-scripts.md |
| Arabe ou hébreu : ponctuation à la mauvaise extrémité, chiffres inversés | Isolation bidi, pas inversion de chaîne | rtl-and-scripts.md |
| Document long, DOCX/PDF/diaporama, notes de bas de page et tableaux | Extraire la structure d'abord, traduire les segments, réassembler, puis vérifier la mise en page | documents.md |
| Site web, CMS, Markdown, centre d'aide, ou hreflang | Attributs traduisibles, politique d'URL, hreflang réciproque, mots-clés par locale | web.md |
| SRT, VTT, script de doublage, ou sous-titres désynchronisés | Vitesse de lecture et budget de ligne d'abord, fréquence d'images ensuite | subtitles.md |
| Slogan, campagne, blague, jeu de mots, poème, ou une voix de marque à transmettre | Transcréation : brief sur l'effet, livrer des options avec des rétro-traductions | transcreation.md |
| Contrat, brevet, document clinique, financier, ou "il doit être certifié" | Acheminer par régime ; rétro-traduction pour les segments à risque | legal-medical.md |
| Texte de jeu : variables de dialogue, limites de caractères, classifications | Grammaire sans danger pour les variables, LQA au moment de la compilation, passe de culturalisation | games.md |
| "Cette traduction est-elle bonne ?" | Typologie d'erreur et un score avec une formule énoncée, pas une opinion | quality.md |
| Le même terme continue d'apparaître différemment | Glossaire et liste d'éléments à ne pas traduire, appliqués à la livraison | terminology.md |
| Mémoire de traduction, TMX, XLIFF, correspondances floues, ou une grille de remise | Calcul du taux de réutilisation et de la segmentation qui le détermine | translation-memory.md |
| Sortie MT à post-éditer, ou "pouvons-nous simplement utiliser la traduction automatique ?" | Liste de vérification des cinq échecs, niveau de post-édition, quand la MT est interdite | machine-translation.md |
| Quel code de locale, quelle variante, quel fallback | Forme BCP 47, politique de variante, valeurs par défaut de registre par langue | locales.md |
| Nombres, dates, devises, adresses, noms, tri | Format de la locale, ne jamais traduire les chiffres | numbers-and-names.md |
| Cadrer, deviser, brief un traducteur, délais | Comptages de mots, chiffres de débit, contenu du brief, transfert | jobs.md |
| Tout le reste | Traduisez-le, puis énoncez les deux hypothèses que vous avez faites (public et registre) afin que l'utilisateur puisse en corriger une | — |
Carte de couverture : software-strings.md catalogues i18n et espaces réservés · locales.md codes, variantes, registre · rtl-and-scripts.md bidi, CJK, encodage · numbers-and-names.md formats de données de locale · documents.md fichiers longs et structurés · web.md sites, CMS, SEO multilingue · subtitles.md sous-titrage et doublage · transcreation.md marketing, littéraire, humour · games.md localisation de jeux · legal-medical.md travail réglementé et certifié · terminology.md glossaires et DNT · translation-memory.md TM, XLIFF, grilles de correspondance floue · machine-translation.md MT et post-édition · quality.md révision, MQM, acceptation · jobs.md cadrage, briefs, fournisseurs.
Règles Fondamentales
- Traduisez la phrase, jamais le mot — et ne dépassez jamais la phrase sans le dire. La fidélité au niveau du mot produit un texte précis et illisible ; la liberté au niveau du paragraphe produit un texte lisible et infidèle. L'unité est la phrase, avec le paragraphe comme contexte. Lorsqu'une phrase doit être divisée, fusionnée ou réorganisée pour fonctionner dans la cible, c'est une décision normale ; lorsqu'une affirmation, un nombre ou une atténuation change, c'est un défaut. Test de signal : un lecteur bilingue peut pointer la clause source qui porte chaque affirmation dans votre cible.
- Aucune chaîne n'est traduite sans son contexte, et un contexte manquant est énoncé, pas deviné.
Openest un verbe sur un bouton et un adjectif sur un badge de statut, et les deux sont des mots différents dans la plupart des langues. Exigez la capture d'écran, lemsgctxt, ou le commentaire du développeur ; lorsque rien n'existe, traduisez pour l'utilisation la plus probable et enregistrez l'hypothèse dans la note de livraison. Un catalogue dont les clés sont le texte anglais ("Open": "Open") rend cela impossible et est un défaut à signaler (software-strings.md). - Ne construisez jamais une phrase par concaténation.
"Deleted " + n + " items"a un ordre de mots en anglais et plusieurs en turc, japonais et arabe, et il cache l'accord que les langues slaves et sémitiques exigent. Un message équivaut à une chaîne avec des espaces réservés nommés et des formes plurielles ou de sélection ICU. C'est le défaut i18n le plus coûteux à corriger a posteriori, car le corriger modifie le code, pas le texte. - Les formes plurielles viennent de CLDR pour la cible, jamais reflétées depuis la source. L'anglais a deux catégories (
one,other) ; le russe, le polonais et le tchèque en ont quatre ; l'arabe et le gallois en ont six ; le japonais, le chinois, le coréen, le vietnamien et le thaï en ont une. Un catalogue qui n'expose queone/otherrend le russe incorrect pour 2, 21 et 101 — et c'est le code, pas le traducteur, qui est en faute. Vérifiez les catégories de la cible avant de remplir le fichier (tableau danssoftware-strings.md). - Budget d'expansion à partir de la longueur source, avant de geler la mise en page. Les chaînes courtes se dilatent le plus. Depuis l'anglais, prévoyez : 1-10 caractères → jusqu'à +200 % ; 11-20 → +100 % ; 21-30 → +80 % ; 31-50 → +60 % ; 51-70 → +40 % ; 70+ → +30 % (tableau de mondialisation d'IBM, la référence du secteur). L'allemand, le finnois et le russe se situent en haut de la fourchette ; les langues CJK se contractent d'environ un tiers mais nécessitent une hauteur de ligne plus grande. Une interface utilisateur testée uniquement en anglais n'a pas été testée.
- Un terme, un rendu, écrit la première fois qu'il est décidé. La cohérence l'emporte sur l'élégance : un lecteur qui rencontre deux mots pour un concept suppose qu'il s'agit de deux concepts. La première fois qu'un terme est choisi, il devient une ligne de glossaire avec sa nature grammaticale et la raison ; la première fois qu'un terme est rejeté, il devient un rendu interdit. Boîtes et formats :
memory-template.md, mécanismes dansterminology.md. - Le registre est une décision par locale prise une fois et réutilisée. La distinction T-V (tu/vous, tú/usted, du/Sie), le niveau de politesse japonais, le niveau de langue coréen, et l'arabe MSA contre dialecte ne sont pas des choix au niveau de la phrase — alterner en cours de produit est le signal amateur le plus visible qui soit. Valeur par défaut de
formality; une préférence énoncée devient la ligne de la locale dans la mémoire dans le même tour (locales.md). - La sortie automatique est un brouillon avec une liste d'échecs connue. Avant de lire la MT pour le style, vérifiez cinq choses dans l'ordre : négation supprimée ou inversée, accord en genre et en nombre, terminologie par rapport au glossaire, niveau de politesse, et nombres ou unités copiés inchangés. Régie par
mt_policy; la MT n'est jamais le livrable pour les textes juridiques, médicaux ou de sécurité (machine-translation.md). - Rien de risqué n'est livré sur une seule paire d'yeux. ISO 17100 définit un service de traduction comme une traduction plus une révision par une deuxième personne ; lorsqu'une deuxième personne est impossible, le substitut est une auto-révision différée (au moins quelques heures plus tard, langue cible uniquement, source masquée) plus une rétro-traduction des segments à risque — nombres, dosages, négations, obligations, délais, noms. Définissez quels segments sont à risque avant de commencer, pas après (
quality.md).
Ce qui Cassé, et Ce que Cela Signifie
Règle de décodage : la couche qui montre le dommage nomme la cause. Les caractères garbled sont des octets ; une grammaire incorrecte autour d'un nombre est une règle de pluriel ; une chaîne qui ne change jamais n'a jamais été extraite.
| Symptôme | Cause la plus probable | Première action |
|---|---|---|
é, ’, ñ | Octets UTF-8 décodés comme Latin-1 quelque part dans la chaîne | Trouver le seul saut qui suppose un encodage hérité ; ne jamais "réparer" en retapant les caractères (rtl-and-scripts.md) |
????? ou _____ là où le texte devrait être | Conversion avec perte vers un jeu de caractères mono-octet, généralement à une limite de base de données ou d'exportation | Jeu de caractères de colonne et jeu de caractères de connexion, puis réexporter depuis la source |
| Boîtes vides (tofu) ou une police de secours | La police manque le script — un problème de rendu, pas d'encodage | Vérifier la couverture de police pour le script, pas le fichier |
| La chaîne reste en anglais quelle que soit la locale | Jamais extraite, ou le framework n'a jamais reçu la locale | Rechercher la chaîne littérale dans la source ; puis confirmer la locale résolue au moment de l'exécution (software-strings.md) |
Plantage ou %!s(MISSING) après la traduction | Le nombre ou l'ordre des espaces réservés a changé dans la cible | Vérification de la parité des espaces réservés par segment (Portes de Sortie) ; utiliser des formes positionnelles (%1$s) |
| Grammaire incorrecte à 2, 21 ou 101 éléments | Les catégories CLDR de la cible manquent dans le catalogue | Ajouter les catégories manquantes au niveau du fichier (Règle 4) |
Le texte coréen affiche 이(가) ou 을(를) | Particule choisie par la consonne finale de la syllabe précédente, impossible avec la concaténation | Réécrire la phrase pour éviter la particule, ou utiliser un framework qui infléchit (locales.md) |
| Une phrase arabe se termine avec le point à gauche | L'algorithme bidi fonctionne correctement sur le texte |
...
[texte tronqué pour la traduction]