Locadex pour Next.js App Router

Automatisez la traduction de votre application Next.js

Traduire votre application Next.js en français 🇫🇷, en espagnol 🇪🇸, en japonais 🇯🇵, ou dans toute autre langue est pénible et chronophage.

Locadex est un agent IA conçu pour prendre en charge 100 % de votre internationalisation (i18n). L’installation prend 5 minutes.

Écran d’installation de Locadex

Locadex :

  • Configure votre projet pour utiliser la bibliothèque i18n gt-next
  • Modifie vos composants React et vos chaînes pour gérer du contenu multilingue
  • Traduit votre application dans autant de langues que nécessaire
  • Gère en continu l’internationalisation et la traduction à mesure que vous publiez du nouveau contenu

Procédure de configuration

Étape 1 : Connectez-vous au tableau de bord General Translation

Accédez à votre tableau de bord et connectez-vous à votre compte.

Étape 2 : Connecter GitHub

  1. Accédez à la section d’intégration GitHub de votre tableau de bord
  2. Cliquez sur « Connecter GitHub » pour associer votre compte GitHub
  3. Vous serez redirigé vers GitHub pour autoriser la connexion

Étape 3 : Installer l’application GitHub

  1. Après avoir connecté GitHub, vous serez redirigé pour installer l’application GitHub Locadex
  2. Choisissez à quels dépôts donner accès à Locadex :
    • Installer sur tous les dépôts, ou
    • Sélectionner des dépôts spécifiques
  3. Cliquez sur « Install » pour terminer l’installation de l’application GitHub

Étape 4 : Lier le dépôt au projet

  1. De retour sur votre tableau de bord GT, sélectionnez le dépôt que vous souhaitez internationaliser
  2. Votre dépôt sera alors relié à vos paramètres de traduction et à vos langues cibles
  3. Un seul dépôt peut être lié à un projet, mais vous pouvez créer plusieurs projets, chacun avec un dépôt différent

Étape 5 : Configurer les paramètres

Sur l’écran de configuration, effectuez les réglages suivants :

  • Langues cibles : Choisissez les locales vers lesquelles traduire

Écran d’installation de Locadex

Étape 6 : Finaliser l’installation

  1. Vérifiez vos paramètres de configuration
  2. Cliquez sur « Install » pour activer Locadex pour votre dépôt
  3. Vous serez dirigé vers une page d’aperçu affichant votre dépôt GitHub connecté

Et maintenant ?

Configuration initiale

Une fois l’installation terminée :

  1. Création immédiate d’une PR : Locadex crée une pull request sur votre branche principale
  2. Configuration complète : Cette PR exécute la commande de configuration complète de Locadex qui :
    • Installe les bibliothèques GT
    • Configure votre projet pour l’internationalisation
    • Met en place l’infrastructure de traduction
  3. Relecture et fusion : Relisez la PR et fusionnez-la pour finaliser votre configuration i18n

Internationalisation continue

Après avoir fusionné la configuration initiale :

  1. Locadex surveille votre branche principale ou la branche spécifiée pour les pull requests
  2. Lorsque vous poussez du nouveau code contenant du contenu traduisible, attendez que Locadex ajoute son commit à la PR
  3. Une fois que Locadex a ajouté son commit à la PR, vous pouvez fusionner en toute sécurité — votre nouveau code est internationalisé
  4. Votre application reste traduite sans intervention manuelle

Surveiller votre dépôt

Panneau de connexion GitHub de Locadex

Panneau de configuration de Locadex

État du tableau de bord

Dans le tableau de bord, vous pouvez suivre :

  • État du dépôt : indicateur de surveillance actif
  • Configuration : paramètres actuels et langues cibles

Intégration GitHub

  • Vérifications d’état : Locadex ajoute des mises à jour d’état aux pull requests
  • Exécutions de vérification : GitHub affiche l’état de traitement de Locadex

Résolution des problèmes

Problèmes courants

Locadex ne crée pas de PR

  • Vérifiez que l’application GitHub a accès au référentiel
  • Vérifiez que les commits contiennent du contenu traduisible

Modifications de configuration requises

  • Mettez à jour les paramètres de branche dans votre tableau de bord GT
  • Les modifications s’appliqueront aux nouveaux commits après la mise à jour

Frameworks pris en charge

Actuellement, Locadex ne prend en charge que les applications Next.js utilisant l’App Router.

Comment trouvez-vous ce guide ?