Traduire une application Laravel en japonais

Ce que le japonais change dans vos chaînes Laravel

Le japonais place le verbe en fin de phrase et enchaîne les mots sans espace. Les paramètres de Laravel changent donc de place et se collent au texte : "Bon retour, :name !" devient par exemple "おかえりなさい、:nameさん。". Le paramètre doit rester écrit exactement comme dans la source, y compris :Name ou :NAME : les majuscules n'ont aucun sens en japonais, mais Laravel s'en sert pour mettre en forme la valeur insérée.

• Pluriel : le japonais n'a qu'une catégorie CLDR, other. Pour cette langue, Laravel retient toujours la première forme d'une chaîne de trans_choice. Si "un élément|:count éléments" garde deux segments, c'est le premier qui s'affiche quel que soit le nombre : il doit donc contenir :count. Les intervalles explicites comme {0} restent utiles pour « aucun élément ».
• Classificateurs : un nombre s'accompagne d'un mot de compte qui dépend de la chose comptée : :count件 pour des résultats, :count人 pour des personnes, :count個 pour des objets.
• Ponctuation : virgule 、 et point 。 en pleine chasse dans les phrases, points d'interrogation et d'exclamation souvent en pleine chasse aussi ; pas de point final sur un bouton comme 保存 (Enregistrer).

Registre, vocabulaire et affichage à l'écran

Une interface japonaise professionnelle mêle deux registres. Les boutons et menus sont des noms courts (ログイン, 削除), tandis que les messages adressés à l'utilisateur sont à la forme polie en です・ます : "パスワードが変更されました。". Les courriels de notification de Laravel (réinitialisation du mot de passe, vérification de l'adresse) appellent un keigo plus soutenu ; la formule de fin « Cordialement » devient typiquement よろしくお願いいたします。.

• Cohérence des termes : choisissez entre emprunt en katakana et mot japonais, par exemple ダッシュボード ou 管理画面 pour « tableau de bord », et gardez le même partout.
• Concaténation : un Blade du type {{ __('Supprimer') }} {{ $item }} impose l'ordre français. En japonais, l'objet passe avant le verbe : préférez une seule chaîne avec paramètre, __('Supprimer :item', ['item' => $item]).
• Affichage : sans espaces, le navigateur coupe les lignes n'importe où entre deux caractères. Vérifiez les règles CSS de coupure et prévoyez une police couvrant les kanji, faute de quoi certains caractères s'afficheront avec une police de secours.

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

Manuce prend en charge les fichiers lang/<langue>.json de Laravel. Le fichier rendu est le même : indentation, ordre des clés, guillemets, commentaires, fins de ligne, encodage et BOM sont conservés ; seules les valeurs passent en japonais.

• Chaque valeur traduite est comparée à la source : les paramètres :name, :count, :attribute et les balises doivent s'y retrouver. En cas d'écart persistant, la valeur source est gardée et le rapport le signale.
• Ne sont pas traduits : les clés, les valeurs vides, les URL, les adresses email, les nombres, les couleurs, les formats de date, les 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.

En revanche, Manuce ne lit pas les tableaux PHP (lang/fr/validation.php, auth.php…) : il faut les convertir en JSON. Il ne modifie pas non plus vos vues Blade ni votre configuration. Le prix porte sur les mots des valeurs, clés et balises exclues, avec un coefficient ×1.6 pour le japonais.

Préparer le projet avant le dépôt

• Des valeurs remplies : une valeur vide n'est pas traduite. Si vos clés sont les phrases elles-mêmes et que le fichier contient "Mot de passe oublié ?": "", recopiez d'abord la phrase dans la valeur.
• Les tableaux PHP : convertissez validation.php en JSON, par exemple en aplatissant les clés ("required": "Le champ :attribute est obligatoire."), puis reconvertissez le résultat si vous gardez des tableaux PHP en production. En japonais, :attribute passe en tête : ":attributeは必須です。" ; traduisez aussi les noms de champs du tableau attributes, sinon on lira emailは必須です。.
• L'encodage : un fichier en UTF-8 sans BOM évite les mauvaises surprises au décodage JSON ; Manuce conserve le BOM tel quel s'il existe.
• Le contexte : une clé comme "Order" peut signifier commande (注文) ou tri (並び順). Une clé plus explicite lève l'ambiguïté.

Vérifier dans l'application après livraison

Placez le fichier sous lang/ja.json, passez la locale à ja (App::setLocale('ja') ou la configuration de l'application) et parcourez les écrans.

1. Lisez le rapport : les chaînes gardées en source pour écart de paramètres sont à reprendre à la main.
2. Testez les compteurs avec 0, 1 et 2 éléments pour contrôler le premier segment des chaînes plurielles.
3. Les formats de date ne sont pas traduits : réglez la locale de Carbon sur ja et adaptez vos formats, par exemple vers Y年n月j日.
4. Vérifiez les boutons étroits et les notifications envoyées par courriel, où le registre poli compte le plus.

En pratique

1. Convertissez vos tableaux PHP en JSON et remplissez les valeurs vides.
2. Déposez le fichier JSON et choisissez le japonais comme langue cible.
3. Lisez l'extrait gratuit, puis validez le devis calculé sur les mots des valeurs.
4. Placez le fichier reçu dans lang/ja.json, lisez le rapport et testez l'application en locale ja.