gt-sanity@3.1.0

概要

翻訳済みコンテンツが届いたときの状態のままであることは、ほとんどありません。編集者は用語を修正し、見出しを洗練させ、市場に合わせてトーンを調整します。しかしこれまでは、次回の翻訳実行ですべてが再生成されていました。

gt-sanity v3.1 では、ローカル編集を保存が追加されました。翻訳実行前に、Sanity がすでに保持している翻訳を General Translation にアップロードするため、ソーステキストが変更されていないコンテンツでは既存の文言が維持されます。この機能はデフォルトでオフで、Studio セッションごとにオプトインできます。

このリリースでは、実行を開始せずに既存の翻訳をアップロードするためのローカル編集を保存アクションと、意図的にすべてを再生成するための最初から再翻訳オプションも追加されています。

新機能

ローカル編集を保存

翻訳 ツールまたは General Translation のドキュメントタブで、ローカル編集を保存 トグルをオンにします。オンにすると、翻訳を実行するたびに、まず Sanity 内の現在の翻訳が General Translation に送信されます。これらはソースバージョンの保存済み翻訳となるため、次回の実行時にはそのコンテンツを再翻訳せずに再利用されます。

どちらのローカライゼーション戦略にも対応しています。ドキュメント単位の翻訳は translation.metadata を通じて読み取られます (公開済みドキュメントより下書きが優先されるため、未公開の編集も反映されます) 。国際化配列のロケール値はソースドキュメントから読み取られます。既存のコンテンツがないロケールは、空の翻訳としてアップロードされず、スキップされます。

プラグインの config でトグルの初期状態を設定します。

import { defineConfig } from 'sanity';
import { gtPlugin } from 'gt-sanity';

export default defineConfig({
  plugins: [
    gtPlugin({
      sourceLocale: 'en',
      locales: ['es', 'fr', 'ja'],
      translateDocuments: [{ type: 'post' }],
      preserveExistingTranslations: true,
    }),
  ],
});

preserveExistingTranslations は、Studio の読み込み時にトグルの初期状態を設定します。Editor は UI から、セッション中にこの設定を切り替えられます。

Sanity が信頼できる唯一の情報源になる

トグルをオンにすると、まず説明が表示されます。これには実際のトレードオフが伴うためです。Sanity の内容は、そのバージョンのドキュメントについて General Translation が保持している内容を置き換えます。これには、完了しているもののまだインポートされていない翻訳も含まれます。オンにする前に、保留中の翻訳をすべてインポートしてください。

キャプチャステップはソースのアップロード前に実行され、ベストエフォートで行われます。失敗しても翻訳実行は継続され、編集内容が上書きされる可能性があることを Studio が警告します。

ローカル編集を保存

ローカル編集を保存アクションでは、翻訳をエンキューせず、必要に応じてソースファイルを作成しながら、Sanity にすでにある翻訳をアップロードできます。別の場所で翻訳済みのプロジェクトにプラグインを導入する際に、既存のコンテンツを基に General Translation を開始するために使用します。

翻訳ツールとドキュメントタブで利用できます。

最初から再翻訳

すべて翻訳に、最初から再翻訳チェックボックスが追加されました。チェックすると、既存の翻訳は破棄され、Studio で翻訳済みドキュメントに加えた編集も含めて再生成されます。既存の翻訳を再利用する場合は、チェックを外したままにしてください。

以前は、プラグインで再翻訳を強制する方法がありませんでした。

リンク

• コンテンツの翻訳
• 翻訳の管理
• プラグインの設定
• PR #1997