Documentation

Modifier des traductions

Magic Translate traduit ton texte automatiquement, mais tu peux modifier n'importe quelle traduction toi-même sur magictranslate.io. Utilise-le pour corriger une mauvaise traduction, conserver le nom d'un produit ou faire correspondre le libellé de ta marque.

Modifier une traduction

  1. Traductions ouvertes. Il répertorie tous les textes traduits par ton application, par langue.
  2. Sélectionne la langue, puis clique sur le crayon à côté de la traduction que tu veux modifier.
  3. Modifie le texte et clique sur Enregistrer les modifications.

Les traductions éditées sont marquées « Modifiées par toi ». Ton application reçoit le nouveau texte dès lors, et la modification d'une traduction n'est pas prise en compte dans ton utilisation.

Pour revenir à la traduction artificielle, clique sur le bouton de réinitialisation à côté d'une traduction modifiée.

Les textes contenant des variables (React, Angular, Vue, JavaScript) affichent des espaces réservés tels que {0} où ton application insère une valeur. Conserve tous les espaces réservés dans ta traduction, chacun aussi souvent que dans l'original. Tu peux les déplacer là où la sentence l'exige.

Modifier un texte en une seule utilisation

Une traduction modifiée s'applique à chaque endroit où ton application affiche ce texte. Pour traduire le même texte différemment à un endroit, par exemple Enregistrer sur le bouton de paiement, donne un id à cet endroit :

// React, React SSR and Vue
<T id="checkout-save">Save</T>;
t('Save', { id: 'checkout-save' });
<!-- Angular -->
<t id="checkout-save">Save</t>
<button [title]="'Save' | t: { id: 'checkout-save' }"></button>
<!-- JavaScript -->
<t data-t-id="checkout-save">Save</t>

L'identifiant a sa propre ligne dans Translations, marquée d'un identifiant, que tu modifies comme les autres. En attendant, il affiche la traduction de son texte, y compris la modification que tu as apportée à ce texte si tu en as créé une.

Un identifiant signifie lui-même, pas son texte. Si tu modifies le texte de ton code, la ligne affiche le nouveau texte et conserve ta traduction modifiée. Les sites qui partagent un identifiant partagent sa traduction, donc donne à chaque site que tu veux traduire différemment son propre identifiant.

Un identifiant appartient à ton compte, et tu le modifies séparément pour chaque langue.

Les identifiants peuvent contenir jusqu'à 128 caractères. Un identifiant vide ou plus long est ignoré : le client enregistre une erreur et traduit le texte comme d'habitude. Un identifiant ne coûte rien de plus : son texte est traduit et pris en compte dans ton utilisation une seule fois, quel que soit le nombre d'identifiants qui l'utilisent.

Quand ton application affiche le changement

Les applications qui traduisent dans le navigateur affichent le nouveau texte au prochain chargement de la page.

Les pages traduites sur le serveur, avec le pré-rendu React SSR, Next.js ou Angular, conservent l'ancien texte jusqu'à ce qu'il soit à nouveau affiché. Pour les afficher à nouveau automatiquement, ajoute un webhook.

Webhooks

Ouvre la page de ton compte et ajoute une URL sous Webhooks. Chaque fois que tu sauvegardes ou réinitialise une traduction, Magic Translate envoie une requête POST à chaque URL dont le corps est le suivant :

{ "event": "translations.changed" }

Pour déployer à nouveau ton site sur Vercel, crée un deploy hook dans les paramètres de ton projet et ajoute son URL sous forme de webhook. D'autres hébergeurs, tels que Netlify et Render, proposent la version hooks similaire.

Les URL des webhooks doivent commencer par https://. Tu peux en ajouter jusqu'à 10.