Automatisez la localisation GitLab pour lancer plusieurs langues rapidement

Pour créer une nouvelle requête pull sur GitLab comprenant toutes les modifications apportées dans Lokalise, accédez à la page Télécharger et trouvez la section « Déclencheurs d’application ». Activez l’option « GitLab » et choisissez votre dépôt. Si vous ajoutez un nom du dépôt lors de la configuration initiale, il apparaîtra dans le menu déroulant. D’abord, utilisez le bouton « Aperçu » afin de visualiser la structure finale des fichiers/dossiers avant de créer une PR. Nous recommandons de déclencher des PR uniquement vers les dépôts de la plateforme correspondant au type de fichier que vous exportez. Par exemple, si vous exportez au format JSON, Lokalise créera uniquement des PR dans les dépôts avec la plateforme web. Pour créer une PR sur GitLab, cliquez sur « Build uniquement ». Ainsi, vous ne téléchargerez pas de bundle de traduction sur votre PC local. Pour vérifier le statut de création de la PR, retournez sur la page de l’application GitLab et cliquez sur le bouton « Journaux ».

Accédez à GitLab. Cliquez sur votre avatar dans le coin supérieur droit, puis cliquez sur « Préférences ». Vérifiez que vous disposez des autorisations nécessaires à l’administration des projets et à la gestion des paramètres. Ensuite, cliquez sur « Jetons d’accès », puis sur « Ajouter un nouveau jeton », saisissez le nom du nouveau jeton et activez la portée API. Cliquez sur « Créer un jeton d’accès personnel ». Pensez à bien copier le jeton, car vous ne pourrez plus le consulter après avoir fermé la page.

Assurez-vous que l’option « Remplacer les valeurs modifiées » est activée dans les paramètres d’extraction. Vous pouvez en savoir plus sur les différents paramètres d’importation en consultant l’article Importer des fichiers .

Pour que la structure corresponde à celle de vos fichiers, vous devez donner un nom adapté à vos fichiers et sélectionner les options adéquates lors de la création de votre PR. Pour cela, vous pouvez simplement activer l’option « Inclure le chemin complet dans les noms de fichiers » dans les paramètres généraux de l’application GitLab depuis Lokalise. Ensuite, lors du téléchargement, sélectionnez « Plusieurs fichiers par langue (utiliser les noms de fichiers assignés) », puis modifiez ou supprimez le préfixe. Pour en savoir plus, consultez l’article Noms de fichiers .

Pour prendre en charge les noms des clés répétés dans Lokalise, assurez-vous que l’option « Différencier les clés par fichier » est activée dans les paramètres d’extraction de l’application.

Lokalise demande l’accès à tous les dépôts afin de les répertorier lors de la configuration, pour que vous puissiez spécifier quel dépôt connecter à Lokalise. Il n’existe aucune portée OAuth plus restrictive à cet effet. Une fois l’application configurée, Lokalise fonctionne uniquement avec le dépôt que vous avez sélectionné.

Lokalise se contente de créer des demandes de fusion et de récupèrer les fichiers que vous avez sélectionnés lors de la configuration. L’application GitLab de Lokalise ne modifie pas les paramètres du dépôt.

Les portées d’autorisations des utilisateurs GitLab limitent l’accès des jetons OAuth. Les accès de l’application Lokalise sont limités par les autorisations de l’utilisateur qui configure l’intégration. Si vous devez limiter l’accès de l’intégration à un dépôt spécifique, vous pouvez le faire en modifiant les autorisations du compte GitLab de l’utilisateur habilitant.

Les utilisateurs GitLab peuvent à tout moment révoquer un jeton ou modifier ses portées pour obtenir un meilleur contrôle sur les capacités de l’intégration.