Traduire un fichier JSON i18n en japonais

Ce qui change quand une interface passe en japonais

Le japonais mêle trois écritures (kanji, hiragana, katakana) et ne met pas d'espace entre les mots. Une chaîne japonaise compte souvent moins de caractères que sa source, mais chaque caractère occupe une pleine chasse, et les emprunts écrits en katakana s'allongent vite : « Download » devient ダウンロード, « Account settings » アカウント設定. Un bouton calibré pour l'anglais ou le français peut donc déborder comme sembler vide.

La ponctuation change aussi : virgule 、, point 。, point d'interrogation pleine chasse ？. Un « Saved! » devient plutôt 保存しました。.

• Retour à la ligne : faute d'espaces, le navigateur coupe entre les caractères. Déclarez lang="ja" sur la page et testez line-break: strict pour éviter qu'un 。 ou un 、 ne se retrouve en début de ligne.
• Polices : les kanji partagent leurs points de code avec le chinois. Sans police japonaise dans la pile font-family et sans lang="ja", certains caractères s'affichent sous leur forme chinoise.

Ces réglages relèvent de votre CSS : Manuce ne touche qu'au fichier de chaînes.

Pluriels, variables et ordre des mots

Le japonais n'a qu'une catégorie de pluriel CLDR : other. Il n'y a donc aucune catégorie à ajouter, contrairement au polonais ou à l'arabe. Avec i18next, seule la clé items_other sert en japonais ; une clé items_one héritée de la source reste dans le fichier, puisque les clés ne sont jamais modifiées, mais les règles du japonais ne la sélectionnent pas. En ICU, {count, plural, other {#件のメッセージ}} suffit ; seules les sélections exactes comme =0 ou =1 restent actives.

Le vrai piège est l'ordre des mots : le verbe va en fin de phrase et la variable se déplace, suivie d'une particule.

• "Delete {{count}} files?" devient "{{count}}件のファイルを削除しますか？", avec un classificateur (件, 個, 人) qui dépend de l'objet compté.
• "Welcome back, {name}" devient "おかえりなさい、{name}さん" : le suffixe さん s'ajoute après la variable.

Une phrase découpée en plusieurs clés puis assemblée dans le code (t('sentBy') + name) ne peut pas être remise dans l'ordre japonais. Regroupez-la en une seule valeur avec variable avant l'envoi.

Registre : boutons, messages et keigo

Une interface professionnelle japonaise emploie la forme polie en -masu / -desu pour les phrases, et des noms courts pour les actions. On attend 保存 ou 送信 sur un bouton, パスワードが正しくありません。 pour une erreur, et non la forme neutre 正しくない, jugée abrupte.

Le mélange des registres d'un écran à l'autre se remarque immédiatement. C'est l'un des points à contrôler sur l'extrait gratuit : un paragraphe de votre fichier traduit au niveau choisi, avant de payer. Pour une interface destinée à des clients japonais, le niveau Professionnel (spécialiste du domaine) ou Premium (moteur le plus avancé puis relecture croisée) est le plus adapté ; Essentiel convient pour comprendre ou tester en interne.

Les noms de marque et termes de produit : vérifiez sur l'extrait puis sur la traduction s'ils restent en alphabet latin ou passent en katakana, selon l'usage de votre marché.

Ce que Manuce rend, et ce qu'il ne fait pas

Vous récupérez le même fichier : indentation, ordre des clés, guillemets, commentaires, fins de ligne, encodage et BOM conservés. Seules les valeurs sont en japonais. JSON plat ou imbriqué et tableaux de chaînes sont pris en charge.

• Chaque valeur est comparée à la source : {name}, {{count}}, %s et les messages ICU (plural, select) doivent apparaître à l'identique, autant de fois. En cas d'écart persistant, la valeur source est gardée et le rapport le signale.
• Ne sont pas traduits : clés, valeurs vides, URL, adresses email, nombres, couleurs, formats de date, identifiants, et tout ce qui est marqué non traduisible.
• Le rapport liste les chaînes traduites et celles laissées telles quelles, avec la raison.

Manuce ne modifie ni votre CSS ni vos composants, ne convertit pas l'encodage et n'adapte pas un format de date : "MM/DD/YYYY" reste tel quel, alors qu'au Japon on écrit 2025/03/14 ou 2025年3月14日. Passez par Intl.DateTimeFormat('ja-JP') ou corrigez cette valeur vous-même. Le prix porte sur les mots des valeurs, clés et balises exclues, avec un coefficient ×1.6 propre au japonais.

Préparer le fichier et vérifier le rendu

1. Encodage : l'encodage d'origine est conservé. Un fichier en Latin-1 ne peut pas contenir de japonais ; enregistrez-le en UTF-8 avant le dépôt.
2. Concaténations : fusionnez les fragments de phrase en valeurs complètes avec variables, pour que l'ordre japonais soit possible.
3. Contexte des compteurs : une clé comme count seule ne dit pas ce qui est compté ; une valeur complète ("{{count}} files") permet le bon classificateur.
4. Après livraison : lisez le rapport, puis affichez l'application en ja et contrôlez boutons, menus étroits et coupures de ligne.

En pratique

1. Enregistrez le fichier JSON en UTF-8 et regroupez les phrases découpées en plusieurs clés.
2. Déposez le fichier : le devis s'affiche aussitôt, calculé sur les mots des valeurs.
3. Vérifiez l'extrait gratuit : registre poli, ponctuation 、。, position des variables.
4. Récupérez le fichier japonais et son rapport, puis remettez-le dans le dossier des locales.
5. Testez l'interface en ja : débordements, retours à la ligne et police japonaise.