ベストプラクティス

悪い翻訳を得る最も早い方法は、回避可能なアプリ構造の問題を避けるためにランタイムを調整することです。

実際のコンテキスト名を使用する

良いコンテキストキーは、コピーがどこに存在するかを説明します:

ts
await engine.t('Pay now', {
  context: 'checkout.payment-form',
});
 
await engine.t('Billing history', {
  context: 'dashboard.billing-history',
});
 
await engine.t('Simple pricing', {
  context: 'marketing.pricing-hero',
});

Avoid anonymous buckets like page1, copy, or misc.

完全な考えを翻訳する

良い:

ts
const label = await engine.t(
  'Download your latest invoice as PDF'
);

避けるべきこと:

18waysは、一般的なリンクケースを1つのメッセージとして処理できます。 <T><a href="#">ここをクリック</a>してもっと見る</T>は、分割されて再接続されるのではなく、1つの文としてそのままにしておくべきです。

ts
const first = await engine.t('Download');
const second = await engine.t(
  'your latest invoice'
);
const third = await engine.t('as PDF');
 
const stitched = [first, second, third].join(' ');

パッケージの境界を明確に保つ

  • Next.jsを使用している場合は、@18ways/nextを使用してロケールの解決とメタデータを処理してください。
  • Reactのみを使用している場合は、アプリ内でロケール状態を保持し、@18ways/reactを使用してください。
  • Reactの外にいる場合は、@18ways/coreを使用して、UI統合を自分で管理してください。

ルーティングをあなたの製品に合わせてください

公開マーケティングページは通常、SEOのためにパスベースのロケールルーティングを必要とします。内部ダッシュボードや内部ツールのルートは、しばしばそうではありません。だからこそ、現在のサイトでは/dashboard/__design、および/__emailをパスルーティングから除外しています。

ソースコピーを人間らしく保つ

18waysは、ソーステキストが圧縮された翻訳キーのようではなく、実際の製品コピーのように読まれるときに最も効果的です。

良いソースコピーはモデルにより良いコンテキストを提供し、あなたのチームにコード内で読みやすいものを提供します。