Clés de traduction - Lingo.dev CLI

Introduction

Une clé de traduction est un identifiant unique qui relie un élément de contenu à ses traductions correspondantes dans différentes langues. Lors de la configuration de certains types de buckets, vous pouvez utiliser ces clés pour activer des fonctionnalités spécifiques aux buckets, telles que le verrouillage de clés ou l'ignorance de clés.

Clés définies par l'utilisateur

Dans certains formats de fichiers, les clés de traduction doivent être explicitement définies. Par exemple, dans le fichier JSON suivant, title, description et version sont les clés de traduction :

{
  "title": "Hello, world!",
  "description": "A simple demo app",
  "version": "1.0.0"
}

Vous avez un contrôle total sur la dénomination de ces clés.

Clés générées automatiquement

Dans certains formats de fichiers, les clés de traduction sont générées automatiquement en fonction de la structure du fichier. Voici, par exemple, des exemples de clés générées automatiquement pour un fichier HTML :

head/0/0
head/1#content
body/0/0
body/1/0
body/1/1/0

Pour identifier une clé générée automatiquement pour un élément de contenu spécifique, consultez le fichier i18n.lock du projet.

Renommage des clés

Lorsque vous refactorisez votre code et renommez les clés pour une meilleure organisation, Lingo.dev CLI détecte automatiquement que le contenu est le même et préserve les traductions existantes. Cela évite un travail de retraduction inutile lorsque seul l'identifiant de la clé change, et non le contenu réel.

Pour en savoir plus, consultez Renommage de clés.

Verrouillage des clés

Certains contenus comme les identifiants techniques, les noms de composants ou les termes de marque doivent rester identiques dans toutes les langues. Le verrouillage des clés vous permet d'exclure des clés spécifiques du processus de traduction, en copiant directement les valeurs sources dans tous les fichiers cibles.

Pour en savoir plus, consultez Verrouillage de clés.

Ignorer des clés

Le contenu de développement, de test ou interne n'a souvent pas besoin d'être traduit et ne devrait pas apparaître dans les fichiers de production. L'ignorance des clés exclut complètement ces clés du processus de traduction, les gardant entièrement hors des fichiers cibles.

Pour en savoir plus, consultez Ignorance de clés.