localize.dev

Dokumentation / Ember

Ember i18n mit ember-intl, automatisiert

Lokalisieren Sie eine Ember-App: Glimmer-Vorlagen (.hbs, .gjs, .gts) werden zu ember-intl {{t}}-Aufrufen, mit Pluralformen, und eine Anwendungsroute, die die Sprache auswählt.

Funktionsweise

Vorlagentext wird zu {{t "key" name=this.user.name}}, Attribute placeholder={{t "key"}}, und {{if (eq n 1) "item" "items"}} in einem Satz zu einer Pluralmeldung.

Vorher und nachher

Die tatsächliche Ausgabe der Engine für diese Datei. Bei einer echten Ausführung benennt das gehostete Modell die Schlüssel anhand des Kontexts.

app/templates/cart.hbs · vorher
<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 · nachher
<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"
  }
}

Was das Setup hinzufügt

Der erste Durchlauf richtet ember-intl ein, falls das Projekt es noch nicht hat:

  • ember-intl, mit Nachrichten in translations/<locale>.json
  • Eine Anwendungsroute, die die Sprache auswählt und <html lang dir> setzt

Ausführen

Die CLI benötigt Node.js 22 oder neuer.

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

Oder fügen Sie die GitHub Action und erhalten Sie bei jedem Push einen Pull Request. Probieren Sie es zuerst mit Ihrem eigenen Code im Spielbereich.