Documentation

Gérer les traductions grâce aux suggestions

Laissez des locuteurs natifs corriger le texte sur votre site, examinez leurs propositions 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 l'examinez dans Coroid, et la modification arrive dans 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 configuré comme décrit dans Traduire votre projet.

Activer les contributions

Les contributions nécessitent deux éléments dans .coroid/i18n.json: la liaison des suggestions du projet et une version du moteur qui les prend en charge. Sur la Contributeurs onglet, choisissez Proposer d'activer les contributions. Coroid crée une tâche qui ajoute ces deux éléments, et vous fusionnez son pull request. Jusqu'à ce moment-là, l'onglet indique ce qui manque.

Inviter des contributeurs

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

  • Examiner. Gardez Réviser les suggestions avant de les appliquer activé pour les nouveaux contributeurs. Si cette option est désactivée, une suggestion est approuvée immédiatement, mais uniquement si son texte source correspond à celui de votre dépôt synchronisé.
  • Aucun siège. Le contributeur n'est pas ajouté à votre organisation et n'occupe pas de siège de membre. L'accès se limite à ce projet et aux langues choisies.
  • Les invitations expirent. La personne se connecte ou crée un compte avec l'adresse invitée et accepte dans les sept jours.

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 Configuration → 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 un administrateur les active.
  2. Sur la Contributeurs onglet, choisissez Préparer la tâche d'intégration du site. La 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, donc les visiteurs ordinaires ne téléchargent rien.
  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 avec la clé, le texte 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 contributeurs se connectent à Coroid dans la fenêtre pop-up ; votre site ne gère jamais leurs identifiants. Les suggestions anonymes ne sont pas acceptées.

Révision

L' Suggestions onglet liste toutes les suggestions avec leur clé, leur langue, le texte source, la traduction actuelle et la proposition. Filtrez par statut ou par langue, puis approuvez ou rejetez chacune. Vous pouvez également rejeter plusieurs à la fois.

Boutique en ligne
Configuré · source en · 4 locales cibles
AperçuConfigurationParamètresContributeursSuggestionsAutomatisations
En attente de révisionApprouvéAppliquées
Préparer la tâche de correction
  • 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

L'onglet Suggestions : corrections en attente de révision, vérifiées par rapport à la source synchronisée. Données illustratives.

Coroid compare le texte source de chaque suggestion avec celui de votre branche par défaut synchronisée. Si le texte source a changé après que le contributeur l'a vu, l'approbation est refusée et la ligne l'indique ; rejetez-la pour que le contributeur puisse proposer à nouveau.

ÉtatSignification
Nécessite une révisionEn attente d'un réviseur
ApprouvéPrêt pour la prochaine tâche de correction
En file d'attenteUne tâche de correction l'applique
AppliquéÉcrit dans un pull request ; il sera en ligne une fois fusionné et déployé
Texte source modifiéLe texte source a changé avant son application
InvalideIl n'a pas passé les vérifications du moteur, par exemple à cause 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 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 texte source, écrit uniquement les catalogues cibles, et indique ce qui a été appliqué, ce qui est obsolète et ce qui était invalide.

  • Maintenant. Sur la Suggestions onglet, choisissez Préparer la tâche de correction. Une seule tâche traite jusqu'à 500 suggestions approuvées dans tout le projet.
  • Chaque nuit. Sur la Automatisations onglet, choisissez Installer les corrections nocturnes. Le planning s'exécute à 02:00 UTC, sans passer par le modèle, et crée une tâche uniquement si quelque chose est approuvé. 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 personnes modifient également des chaînes de caractères dans des pull requests que Coroid n'a pas générées. Installez Traduire les chaînes de caractères fusionnées en dehors de Coroid sur la Automatisations onglet. Lorsqu'un tel pull request est fusionné dans votre branche par défaut, Coroid lit le résultat de la vérification de traduction déjà effectuée sur ce pull request. Si des chaînes de caractères manquent ou sont obsolètes, une tâche de traduction est créée pour cette fusion. Sinon, rien ne se produit.

Cela nécessite l'activation de la Traduction pour les demandes de fusion et de la Réviser chaque PR automatisation afin que la vérification s'exécute avant la fusion.

Audits et notifications

L' Audit de traduction contrôle vérifie chaque catalogue selon un calendrier planifié. Pour être informé d'un échec, installez Notifications d'audit en échec sur la Automatisations onglet. Il envoie un message via les outils de messagerie configurés dans votre organisation, comme Slack ou l'e-mail. Les échecs liés à la validation des tâches et aux demandes de fusion ne génèrent pas de notification ; ils apparaissent déjà là où le travail est effectué.

Déplacer les paramètres vers une autre organisation

L'export et l'import des paramètres conservent le calendrier nocturne ainsi que les deux automatisations associées. Ils sont activés en état de pause dans le projet de destination, les origines de site sont désactivées et les contributeurs ne sont pas copiés : invitez-les à nouveau dans la nouvelle organisation.