Fichiers et formats
Découvrez tous les formats de fichiers acceptés par AI Glot, la taille maximale pour chacun, la structure préservée lors du cycle de traduction et comment préparer un export pour un réimportation fluide.
AI Glot accepte douze familles de formats. Quel que soit le fichier téléchargé, la promesse reste la même : les mots changent, mais la structure demeure, pour que le fichier puisse retourner exactement là d’où il vient.
Ce que vous pouvez télécharger
Les limites de taille sont définies par format et non de manière globale. Une limite adaptée à un tableur serait bien trop généreuse pour un fichier de localisation, où quelques mégaoctets représentent déjà un catalogue énorme.
| Format | Extensions | Limite |
|---|---|---|
| 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 sa limite est refusé avant même le stockage des octets : un téléchargement trop volumineux ne vous coûte donc que le temps de le constater.
Ce qui survit au cycle de traduction
La structure n’est pas un élément décoratif : c’est elle qui rend le résultat exploitable. Chaque famille a sa propre définition de ce qui ne doit pas changer.
| Famille | Préservé exactement |
|---|---|
| CSV, Excel | Ordre des colonnes, identifiants, prix, URLs, lignes vides, espaces |
| JSON, YAML | Chaque clé, niveau d’imbrication, ordre des tableaux, indentation et variable interpolée |
| XLIFF | Unités de localisation, placeholders et balisage en ligne |
| gettext | ID de message, contextes et formes plurielles |
| Android, iOS, .NET, Java | Clés de ressource et leurs spécificateurs de format |
| Sous-titres | Numérotation des indices et codes temporels |
| Archive | L’arborescence des dossiers et chaque nom de fichier à l’intérieur |
Les clés constituent la structure, pas les mots. Un fichier JSON traduit peut être réinjecté directement dans le dépôt car rien n’a bougé en dehors des valeurs.
Longueur par cellule
Chaque valeur source individuelle sélectionnée pour la traduction peut contenir jusqu’à 50 000 caractères Unicode. Divisez les contenus HTML ou éditoriaux plus longs en plusieurs lignes ou champs plus petits avant le téléchargement.
Une valeur traduite est souvent plus longue que sa source, c’est pourquoi AI Glot conserve une marge de stockage au-delà de la limite d’entrée pour le fichier final.
Une archive est également évaluée sur le nombre total de valeurs contenues dans ses membres, et pas seulement sur sa limite de 20 Mo : une traduction bien en dessous de cette limite de taille peut tout de même être refusée si ses fichiers, combinés, contiennent trop de valeurs à traduire. Si cela arrive, divisez une archive volumineuse en plusieurs archives plus petites.
Préparer un export de tableur
Le CSV et l’Excel sont les deux formats que les utilisateurs créent généralement à la main, et les deux où un export négligé cause le plus de problèmes par la suite.
Gardez des identifiants stables
Incluez la clé que votre système de destination utilise pour faire correspondre les lignes, comme un ID produit ou un ID d’enregistrement, et excluez-la de ce que vous demandez de traduire.
Donnez des noms uniques aux colonnes
Remplacez les en-têtes vides ou en double avant le téléchargement. description_en et description_fr sont bien plus claires que deux colonnes appelées toutes les deux description.
Exportez le CSV en UTF-8
Choisissez l’option CSV UTF-8 dans votre outil de tableur. Renommer l’extension d’un fichier ne convertit pas son contenu, mais vous n’avez plus besoin de conversion du tout, car le format .xlsx est accepté directement.
Gardez une copie source
La structure est préservée, mais l’export original reste le moyen le plus sûr de revenir en arrière si votre système de destination rejette un import pour ses propres raisons.
Spécificités du CSV
| Exigence | Comportement supporté |
|---|---|
| Encodage | UTF-8 strict |
| Délimiteur | Virgule ou point-virgule, détecté automatiquement |
| Fins de ligne | LF, CRLF ou CR |
| Citation | RFC 4180, incluant les virgules et sauts de ligne intégrés |
| En-têtes | Chaque colonne doit avoir un en-tête unique et non vide |
| Lignes | Au moins une ligne de données ; chaque ligne doit correspondre à la largeur de l’en-tête |
Fichiers refusés
Le navigateur applique les mêmes règles structurelles que le moteur de traduction avant le début du téléchargement : un fichier mal formé échoue donc immédiatement sous vos yeux plutôt que plusieurs minutes plus tard. Il rejette 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 avec un nombre incorrect de colonnes, les extensions non supportées et tout fichier dépassant la limite de son format.
Via l’API, ces mêmes refus apparaissent sous la forme de unsupported_format et file_too_large.