Documentation

Gérer les traductions avec des suggestions

Laissez des locuteurs natifs corriger le texte de votre site web, examinez leurs suggestions et appliquez-les via des pull requests classiques.

Un modèle identifie correctement la plupart des chaînes de caractères. Un lecteur natif repère néanmoins celles qu'il a mal interprétées. Grâce aux suggestions, ce lecteur corrige le texte sur votre site, vous le révisez dans Coroid, et la modification est intégrée à votre dépôt sous forme de pull request classique.

C'est ainsi que Coroid maintient son propre produit en treize langues. Les étapes ci-dessous supposent que le projet est internationalisé, comme décrit dans Internationaliser un projet. Tout ce contenu se trouve dans l'atelier du projet sous Localisation.

Activer les contributions

Les contributions nécessitent deux éléments dans .coroid/i18n.json: la liaison de suggestions du projet et une version d'engine qui les prend en charge. L'assistant d'internationalisation ajoute ces deux éléments par défaut.

Pour un projet non configuré avec ces éléments, ouvrez Contributeurs et sélectionnez Proposer d'activer les contributions. Coroid crée une tâche pour ajouter ces deux éléments, et vous fusionnez son pull request. En attendant, Contributeurs indique ce qui manque.

Inviter des contributeurs

Sélectionnez Inviter un contributeur, saisissez une adresse e-mail et les langues qu'ils peuvent traduire.

  • Révision. Conservez Réviser les suggestions avant application activé pour les nouveaux contributeurs. Désactivé, une suggestion est approuvée immédiatement, mais uniquement si son texte source correspond à celui de votre dépôt synchronisé.
  • Aucun siège. Un contributeur n'est pas ajouté à votre organisation et n'occupe pas de siège de membre. Son accès se limite à ce projet et aux langues choisies.
  • Un compte Coroid. La personne accepte dans les sept jours en se connectant à Coroid avec l'adresse invitée, ou en créant un compte gratuit via l'invitation. Ce compte possède son propre espace de travail, distinct du vôtre.

Révoquer l'accès empêche de nouvelles suggestions tout en conservant l'historique de la personne.

Le sélecteur sur votre site

Les contributeurs suggèrent depuis votre site, où ils voient le texte dans son contexte.

  1. Sous Paramètres → Accès et dépenses → Origines de site, ajoutez chaque adresse de site, une origine HTTPS par ligne, et activez-la. Les nouvelles origines restent désactivées jusqu'à ce qu'un propriétaire ou administrateur les active.
  2. Dans Contributeurs, sélectionnez Préparer la tâche d'intégration du site. Cette tâche ajoute le paquet de sélecteur de Coroid à votre site. Il ne se charge que lorsque l'adresse de la page contient ?coroid-translate=1, afin que les visiteurs ordinaires n'aient rien à télécharger.
  3. Un contributeur ouvre votre site avec ce paramètre, clique sur une chaîne de caractères, et la fenêtre pop-up de Coroid s'ouvre en affichant la clé, la source et la traduction actuelle.
ACMENeuheitenAngeboteMarken
Weiter zur Kasse gehen

Kostenloser Versand ab 50 € und 30 Tage Rückgabe.

Bestellung prüfen
Mode de traductionCliquez sur n'importe quel texteQuitter
Proposer une traduction
Clé
ui · cart.checkout
Source anglaise
Proceed to checkout
Traduction actuelle
Weiter zur Kasse gehen
Votre traduction
Zur Kasse

Gardez les éléments entre accolades et chevrons tels quels.

Envoyer la suggestion

Un site client en mode traduction : le contributeur clique sur un titre et propose une meilleure formulation en allemand dans la fenêtre contextuelle Coroid. Données illustratives.

La fenêtre pop-up vérifie les espaces réservés avant d'envoyer les données. Les contributeurs se connectent à Coroid depuis la fenêtre pop-up ; votre site ne gère jamais leurs identifiants. Les suggestions anonymes ne sont pas acceptées.

Révision

Suggestions liste toutes les suggestions avec leur clé, leur langue, la source, la traduction actuelle et la proposition de traduction. Filtrez par statut ou par langue, puis approuvez ou rejetez chaque suggestion. Vous pouvez également en rejeter plusieurs à la fois.

Localisation
Boutique en ligne
anglais source · 5 langues · vérifié il y a 2 heures à 3f2c9a1
  • Préparation au marché mondial
  • Culture
  • Aperçu
  • Chaînes
  • Suggestions
  • Échanger
  • Contributeurs
  • Automatisations
  • Paramètres
Suggestions
Préparer la tâche de correction
En attente de révisionApprouvéAppliquées
  • cart.checkoutdeLena · Allemand
    en
    Proceed to checkout
    de
    Weiter zur Kasse gehen
    de
    Zur Kasse
    ApprouverRejeter
  • product.inStockfrHugo · Français
    en
    In stock
    fr
    En stock
    fr
    Disponible
    ApprouverRejeter
  • nav.dealsdeLena · Allemand

    La source soumise diffère du dépôt synchronisé.

    en
    Weekly deals
    de
    Angebote
    de
    Angebote der Woche
    ApprouverRejeter

Suggestions dans le poste de travail : des corrections en attente de décision, vérifiées par rapport à la source synchronisée. Données illustratives.

Coroid compare la source de chaque suggestion avec celle de votre branche par défaut synchronisée. Si la source a changé après que le contributeur l'a vue, l'approbation est impossible et la ligne l'indique ; rejetez-la pour permettre au contributeur de proposer à nouveau une traduction.

ÉtatSignification
Nécessite une révisionEn attente d'un réviseur
ApprouvéPrêt pour la prochaine tâche de correction
Dans la file d'attenteUne tâche de correction est en cours d'exécution
AppliquéÉcrit dans un pull request ; il prend effet dès son fusionnement et déploiement.
Source modifiéeLe texte source a été modifié avant son application.
InvalideIl ne passe pas les vérifications du moteur, par exemple en raison d'un espace réservé incorrect.
RejetéUn réviseur l'a refusé.

Appliquer les suggestions approuvées

Il existe deux façons de transformer les suggestions approuvées en un pull request. Les deux utilisent la même tâche de correction : elle exécute la commande apply-claim du moteur sélectionné, vérifie à nouveau chaque source, écrit uniquement les catalogues cibles, et indique ce qui a été appliqué, ce qui est obsolète et ce qui est invalide.

  • Maintenant. Dans Suggestions, sélectionnez Préparer la tâche de correction, ou Valider sous Chaînes de caractères. Une seule tâche peut traiter jusqu'à 500 suggestions approuvées dans l'ensemble du projet, ainsi que les modifications apportées dans l'espace de travail.
  • Chaque nuit. Le programme d'installation applique les corrections nocturnes par défaut ; sinon, choisissez Installer les corrections nocturnes dans Automatisations. Le planning s'exécute à 02:00 UTC ; il n'effectue aucun appel de modèle et ne crée une tâche que lorsqu'une modification est approuvée. Mettez-le en pause ou reprenez-le depuis le planning dans l'Usine.

Chaînes de caractères fusionnées en dehors de Coroid

Les utilisateurs modifient également des chaînes de caractères dans les demandes de tirage que Coroid n'a pas rédigées. L'assistant installe Traduire les chaînes de caractères fusionnées en dehors de Coroid par défaut ; sinon installez-le dans Automatisations. Lorsqu'une telle pull request est fusionnée dans votre branche par défaut, Coroid lit la vérification de Globalisation qu'il a déjà effectuée sur cette pull request. Si des chaînes de caractères manquent ou sont obsolètes, il crée une tâche de traduction pour cette fusion. La tâche traduit uniquement les chaînes ajoutées ou modifiées par pull request (avec coroid-i18n 1.19.0 ou une version ultérieure) ; ainsi, les fusions traduites simultanément ne modifient jamais les chaînes de l'autre, et il ouvre un pull request avec celles-ci. Si la vérification bloque du texte ou des phrases dans le code, il crée également une tâche pour internationaliser ce code. S'il n'y a rien à faire, rien ne se produit. Les chaînes laissées en suspens par une tâche attendent Traduire l'arriéré de travail chaque nuit, installé au même endroit : chaque nuit, il lit votre branche par défaut et crée une tâche pour tout ce qui est encore en attente, et ne fait rien si rien n'est en attente.

Cela nécessite le Globalisation de vérification sur les demandes de tirage et le Réviser chaque PR automatisation, afin que la vérification s'exécute avant la fusion.

Déplacer les paramètres vers une autre organisation

L'exportation et l'importation des paramètres incluent le planning nocturne et l'automatisation des chaînes de caractères fusionnées. Elles arrivent en état de pause dans le projet de destination, les origines de site arrivent désactivées, et les contributeurs ne sont pas copiés : invitez-les à nouveau dans la nouvelle organisation.