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

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

Locadex :

• Configure votre projet pour utiliser la bibliothèque i18n gt-next
• Modifie vos composants React et vos chaînes pour prendre en charge un contenu multilingue
• Traduit votre application dans autant de langues que vous le souhaitez
• Gère en continu l’internationalisation et la traduction à mesure que vous poussez du nouveau contenu

Procédure d’installation

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

Rendez-vous sur votre tableau de bord et connectez-vous à votre compte.

Étape 2 : Connecter GitHub

1. Accédez à la section d’intégration GitHub dans votre tableau de bord
2. Cliquez sur « Connect 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 accorder l’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. Cela relie votre dépôt à 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 vers quelles locales traduire

Étape 6 : Finaliser l’installation

1. Passez en revue vos paramètres de configuration
2. Cliquez sur « Install » pour activer Locadex sur votre dépôt
3. Vous serez redirigé vers une page récapitulative affichant votre dépôt GitHub connecté

Et ensuite ?

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 la fusion de la configuration initiale :

1. Locadex surveille votre branche principale ou la branche spécifiée afin de détecter 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 le commit de Locadex ajouté à la PR, vous pouvez fusionner en toute sécurité — votre nouveau code est internationalisé
4. Votre application reste traduite sans intervention manuelle

Suivi de votre dépôt

État du tableau de bord

Dans le tableau de bord, vous pouvez suivre :

• État du dépôt : Indicateur de surveillance active
• 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 avec l’App Router.