Documentation · Chapitre 11

Organiser les catalogues de traduction.

Les clés expriment le sens; les catalogues fournissent la formulation de chaque langue. Des clés stables permettent de traduire sans modifier les classes.

Chaque leçon part du problème, explique le mécanisme puis propose une vérification concrète.

Employer des clés sémantiques

Préférez books.empty à phrase_17. Une clé sémantique survit aux reformulations et situe le message pour le traducteur.

phpaml — zsh
{
  "i18n": {
    "enabled": true,
    "directory": "src/locales",
    "default": "en",
    "fallback": "en",
    "supported": ["en", "fr"],
    "detection": ["route", "cookie", "header"]
  }
}

Variables et pluriels

Les paramètres insèrent les noms. Les pluriels utilisent one et other afin que le nombre choisisse la forme grammaticale.

Contrôler la qualité

i18n:check compare les catalogues, i18n:missing fr liste les clés absentes et un JSON invalide échoue clairement.