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 traduit 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'espace de travail du projet sous Localisation.

Activer les contributions

Pour que les contributions fonctionnent, deux éléments sont nécessaires dans .coroid/i18n.json: la liaison de suggestion du projet et une version du moteur 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éviser. Conservez Réviser les suggestions avant application 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. Son 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 des modifications 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, 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 la suggestion. 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 chaque suggestion avec sa clé, sa langue, le texte source, la traduction actuelle et la proposition. Filtrez par statut ou 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
  • 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 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 impossible et la ligne l'indique ; rejetez-la pour permettre au contributeur de ressayer.

ÉtatSignification
Nécessite une révisionEn attente de réviseur
ApprouvéPrêt pour la prochaine tâche de correction
En file d'attenteUne tâche de correction est en cours d'application
AppliquéÉcrit dans un pull request ; actif dès sa fusion et son déploiement
Texte source modifiéLe texte source a changé avant son application
Non valideLa suggestion 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 non valide.

  • Maintenant. Dans Suggestions, sélectionnez Préparer la tâche de correction, ou Valider sous Chaînes de caractères. Une seule tâche traite jusqu'à 500 suggestions approuvées dans tout le projet, ainsi que les modifications effectuées dans l'espace de travail.
  • Chaque nuit. L'assistant installe par défaut les corrections nocturnes ; sinon, sélectionnez Installer les corrections nocturnes dans Automatisations. Le planning s'exécute à 02:00 L'heure UTC n'entraîne aucun appel de modèle, et une tâche n'est créée que lorsqu'une validation est obtenue. Mettez-le en pause ou reprenez-le depuis le calendrier dans l'Usine.

Les 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 d'installation procède à Traduire les chaînes de caractères fusionnées en dehors de Coroid par défaut ; sinon, installez-le dans Automatisations. Lorsqu'un tel pull request est fusionné dans votre branche par défaut, Coroid lit le contrôle de traduction qu'il a déjà exécuté sur ce 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. Si rien ne nécessite de traduction, aucune action n'est effectuée.

Cela requiert le Traductions contrôle sur les demandes de tirage et le Réviser chaque PR automatisation, afin que le contrôle 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 calendrier 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 sont désactivées, et les contributeurs ne sont pas copiés : invitez-les à nouveau dans la nouvelle organisation.