localize.dev

Documentación / Ember

Ember i18n con ember-intl, automatizado

Localiza una app de Ember: las plantillas Glimmer (.hbs, .gjs, .gts) se convierten en llamadas {{t}} de ember-intl, con plurales, y una ruta de aplicación que selecciona el idioma.

Cómo funciona

El texto de la plantilla se convierte en {{t "key" name=this.user.name}}, los atributos placeholder={{t "key"}}, y {{if (eq n 1) "item" "items"}} en una oración en un mensaje plural.

Antes y después

La salida real del motor para este archivo. En una ejecución real, el modelo alojado nombra las claves a partir del contexto.

app/templates/cart.hbs · antes
<h1>Your basket</h1>
<p>Hi {{this.user.name}}, you have {{@count}} new messages.</p>
<p>See the <a href="/faq">FAQ</a> before you order.</p>
<input placeholder="Search products" />
app/templates/cart.hbs · después
<h1>{{t "cart.your_basket"}}</h1>
<p>{{t "cart.hi_you_have_new_messages" name=this.user.name count=@count}}</p>
<p><I18nT @key="cart.see_the_before_you_order" @slots="a" as |is|>{{#if is.a}}<a href="/faq">{{t "cart.faq"}}</a>{{/if}}</I18nT></p>
<input placeholder={{t "cart.search_products"}} />
translations/en.json
{
  "cart": {
    "your_basket": "Your basket",
    "hi_you_have_new_messages": "Hi {name}, you have {count} new messages.",
    "faq": "FAQ",
    "see_the_before_you_order": "See the {a} before you order.",
    "search_products": "Search products"
  }
}

Lo que añade la configuración

La primera ejecución configura ember-intl si el proyecto aún no lo tiene:

  • ember-intl, con mensajes en translations/<locale>.json
  • Una ruta de aplicación que selecciona el idioma y establece <html lang dir>

Ejecutarlo

La CLI necesita Node.js 22 o posterior.

npm install --save-dev localize-dev
npx localize-dev login

# Preview, then write the changes
npx localize-dev run --dry-run -l es,fr,de
npx localize-dev run -l es,fr,de

# Or open a pull request instead
npx localize-dev pr -l es,fr,de

O añade la GitHub Action y obtén una pull request en cada push. Pruébalo primero en tu propio código en el playground.