ドキュメンテーション

翻訳を編集する

Magic Translate はテキストを自動的に翻訳するが、magictranslate.ioで翻訳を自分で変更できる。間違った翻訳を修正したり、製品名を残したり、ブランドの文言と一致させたりするのに使う。

翻訳を編集する

  1. オープントランスレーション。アプリが翻訳したすべてのテキストが言語ごとに一覧表示される。
  2. 言語を選択し、変更したい翻訳の横にある鉛筆をクリックする。
  3. テキストを編集して、[変更を保存] をクリックする。

編集された翻訳には、「あなたが編集した」とマークされる。それ以降、アプリは新しいテキストを受け取り、翻訳を編集しても使用量にはカウントされない。

AI翻訳に戻るには、編集した翻訳の横にあるリセットボタンをクリックして。

変数を含むテキスト(React、Angular、Vue、JavaScript)は、アプリが値を入力する場所に {0} などのプレースホルダーを表示する。翻訳のすべてのプレースホルダーを、それぞれ元のプレースホルダーと同じ頻度で保管する。文章で必要な場所に移動できる。

1つのテキストの使用法を編集する

編集された翻訳は、アプリがそのテキストを表示するすべての場所に適用される。たとえば、「チェックアウト時に保存」ボタンで同じテキストを別の方法で翻訳するには、その場所に id を付ける:

// React, React SSR and Vue
<T id="checkout-save">Save</T>;
t('Save', { id: 'checkout-save' });
<!-- Angular -->
<t id="checkout-save">Save</t>
<button [title]="'Save' | t: { id: 'checkout-save' }"></button>
<!-- JavaScript -->
<t data-t-id="checkout-save">Save</t>

IDは翻訳では独自の行にIDが付き、他のIDと同じように編集できる。それまでは、そのテキストの翻訳が表示され、あなたがそのテキストを作成した場合はそのテキストの編集も含めて。

IDは、テキストではなくそれ自体を表す。コードのテキストを変更すると、行には新しいテキストが表示され、編集した翻訳が保存される。IDを共有する場所はその翻訳を共有しているので、翻訳したい場所ごとに独自のIDを付けて。

IDはアカウントに属し、言語ごとに個別に編集する。

IDは最大128文字だ。空白またはそれより長いIDは無視される。クライアントはエラーを記録し、通常どおりテキストを翻訳する。IDには追加費用はかからない。そのテキストは、何人のIDが使用していても、テキストが翻訳されて使用量としてカウントされるのは1回だけだ。

アプリに変更が表示されたら

ブラウザで翻訳されるアプリは、次回ページが読み込まれたときに新しいテキストを表示する。

React SSR、Next.js、Angular の事前レンダリングでサーバー上で翻訳されたページは、再びレンダリングされるまで古いテキストを保持する。それらを自動的に再レンダリングするには、Webhookを追加して。

ウェブフック

アカウントページを開いて、Webhooksの下にURLを追加して。翻訳を保存またはリセットするたびに、Magic Translate は次の本文の各 URL に POST リクエストを送信する。

{ "event": "translations.changed" }

Vercelにサイトを再びデプロイするには、プロジェクト設定でデプロイ hook を作成し、そのURLをWebhookとして追加する。NetlifyやRenderなどの他のホストも同様のビルド hooks を提供している。

Webhook URLは https:// で始まる必要がある。10個まで追加できる。