Fichiers et formats
Découvrez tous les formats de fichiers acceptés par AI Glot, la taille maximale pour chacun d'eux, la structure préservée lors de l'aller-retour et la méthode pour préparer un export qui se réimporte sans accroc.
AI Glot prend en charge douze familles de formats. Quel que soit le fichier téléversé, la promesse reste la même : les mots changent mais la structure demeure intacte, permettant au fichier de réintégrer sa place d’origine.
Ce que vous pouvez téléverser
Les plafonds de taille sont définis par format et non de manière globale. Une limite adaptée à une feuille de calcul serait bien trop généreuse pour un fichier de localisation, où quelques mégaoctets représentent déjà un catalogue immense.
| Format | Extensions | Plafond |
|---|---|---|
| CSV | .csv | 60 Mo |
| Excel | .xlsx | 50 Mo |
| Archive | .zip | 20 Mo |
| XLIFF | .xlf, .xliff | 12 Mo |
| Ressources Android | .xml | 12 Mo |
| Ressources .NET | .resx | 12 Mo |
| JSON | .json, .arb | 8 Mo |
| YAML | .yaml, .yml | 4 Mo |
| gettext | .po, .pot | 4 Mo |
| Chaînes iOS | .strings | 4 Mo |
| Propriétés Java | .properties | 4 Mo |
| Sous-titres | .srt | 4 Mo |
Tout fichier dépassant son plafond est rejeté avant même que le moindre octet ne soit stocké : un téléversement trop volumineux ne vous coûte donc rien de plus que le temps de vous en apercevoir.
Ce qui est préservé lors de l’aller-retour
La structure n’est pas un simple détail : c’est elle qui rend le résultat directement exploitable. Chaque famille de formats possède ses propres exigences sur ce qui ne doit pas changer.
| Famille | Préservé à l’identique |
|---|---|
| CSV, Excel | Ordre des colonnes, identifiants, prix, URL, lignes vides, espaces |
| JSON, YAML | Chaque clé, niveau d’imbrication, ordre des tableaux, indentation et variable interpolée |
| XLIFF | Unités de localisation, balises réservées (placeholders) et balisage inline |
| gettext | Identifiants de messages (msgid), contextes et formes plurielles |
| Android, iOS, .NET, Java | Clés de ressources et leurs spécificateurs de format |
| Sous-titres | Numérotation des répliques et codes temporels (timecodes) |
| Archive | Arborescence des dossiers et nom de chaque fichier inclus |
Les clés relèvent de la structure, pas du texte. Un fichier JSON traduit s’intègre directement dans le dépôt, car aucun élément en dehors des valeurs n’a été déplacé.
Longueur par cellule
Chaque valeur source sélectionnée pour la traduction peut contenir jusqu’à 50 000 caractères Unicode. Si vous disposez de contenus HTML ou rédactionnels plus longs, scindez-les en plusieurs lignes ou champs plus courts avant le téléversement.
Une valeur traduite étant souvent plus longue que sa source, AI Glot prévoit une marge de stockage au-delà du plafond d’entrée pour le fichier final.
Préparer l’export d’une feuille de calcul
Le CSV et l’Excel sont les deux formats les plus souvent créés manuellement, et ceux où un export négligé engendre le plus de complications par la suite.
Conservez des identifiants stables
Incluez la clé employée par votre système de destination pour faire correspondre les lignes (comme un ID produit ou un ID d’enregistrement), et excluez-la des éléments à traduire.
Nommez chaque colonne de manière unique
Remplacez les en-têtes vides ou en double avant le téléversement. description_en et description_fr sont bien plus faciles à distinguer que deux colonnes toutes deux intitulées description.
Exportez le CSV en UTF-8
Choisissez l’option CSV UTF-8 dans votre tableur. Renommer l’extension d’un fichier ne convertit pas son contenu ; toutefois, la conversion n’est plus indispensable puisque le format .xlsx est directement accepté.
Conservez une copie source
La structure est préservée, mais l’export d’origine reste la solution de secours la plus sûre si votre système de destination refuse un import pour des raisons qui lui sont propres.
Spécificités du format CSV
| Exigence | Comportement pris en charge |
|---|---|
| Encodage | UTF-8 strict |
| Délimiteur | Virgule ou point-virgule, détecté automatiquement |
| Fins de ligne | LF, CRLF ou CR |
| Guillemets | Conformes à la RFC 4180, y compris les virgules et sauts de ligne imbriqués |
| En-têtes | Chaque colonne requiert un en-tête unique et non vide |
| Lignes | Au moins une ligne de données ; chaque ligne doit correspondre au nombre de colonnes de l’en-tête |
Fichiers rejetés
Le navigateur applique les mêmes règles structurelles que le moteur de traduction avant même le début du téléversement : un fichier mal formé est ainsi signalé immédiatement plutôt que plusieurs minutes après. Sont rejetés : les fichiers vides, l’UTF-8 invalide, les guillemets non fermés ou non échappés, les en-têtes vides ou en double, les lignes de données manquantes, les lignes ayant un nombre incorrect de colonnes, les extensions non prises en charge ainsi que tout fichier dépassant le plafond de son format.
Via l’API, ces mêmes refus sont signalés par les erreurs unsupported_format et file_too_large.