ver 3.0 新機能
ドキュメント(v2.0以降) ドキュメント(v1.8.1以前)

翻訳管理

翻訳管理ではプロジェクト内のローカライズ可能な文字列の一覧を表示し、翻訳の編集や進捗確認を行えます。
インスペクター下部の ボタンを押すと翻訳管理を表示します。

機能

翻訳一覧

プロジェクト内のすべてのローカライズ可能な文字列が一覧表示されます。
各項目にはデフォルト値（基準となる文字列）と翻訳入力フィールドが表示されます。
翻訳フィールドに直接入力すると、自動的に保存されます。

対象ロケールの選択

画面上部のロケールピッカーで翻訳対象のロケールを選択します。
翻訳進捗（翻訳済み/全体の割合）がプログレスバーで表示されます。
ロケールメニューからロケールを追加してから使用してください。

範囲の選択

画面上部のセグメントコントロールで表示範囲を切り替えられます。

  • 選択
    現在選択中のアイテムの翻訳可能な文字列のみ表示
  • ページ
    現在のページの翻訳可能な文字列のみ表示
  • プロジェクト
    プロジェクト全体の翻訳可能な文字列を表示

検索と絞り込み

検索フィールドで文字列を検索できます。
「未翻訳のみ」トグルをオンにすると、未翻訳の項目だけを表示できます。

翻訳可能なフィールド

以下のフィールドが翻訳対象となります。

  • 部品のタイトル
  • 部品の代替タイトル
  • 単位（値、メーター）
  • メッセージ
  • 詳細メッセージ
  • メッセージセットのタイトル
  • メッセージセットのサマリー

ナビゲーション

項目のヘッダー（部品名とフィールド名）をタップすると、その部品に直接ジャンプしてオブジェクト設定で編集できます。

翻訳管理

YAMLエクスポート/インポート

翻訳管理では翻訳データをYAML形式でエクスポート・インポートできます。 テキストエディタ、スプレッドシート、AI翻訳ツールを使った翻訳の一括編集に便利です。

エクスポート

共有ボタンをタップすると、翻訳データをYAMLファイルとしてエクスポートします。 設定済みのすべてのロケールがエクスポートに含まれます。 エクスポート範囲は現在の表示範囲（選択、ページ、プロジェクト）に従います。

インポート

インポートボタンをタップしてYAMLファイルを読み込み、プロジェクト内の翻訳を更新します。 UUIDが一致する既存アイテムの翻訳テキストを上書き更新します。 UUIDが一致しないエントリはスキップされるため、新しいアイテムの追加はできません。 インポート後に更新された翻訳エントリ数が表示されます。

YAML形式

エクスポートされるYAMLは以下の構造です。 

# Localization - プロジェクト名

locales:
  - en
  - ja

pages:
  - page: "ページ1"
    items:
      - uuid: "C1325E46-..."
        type: Button
        title: スタート
        fields:
          title:
            en: Start
            ja: スタート
          alternate_title:
            en: Stop
            ja: ストップ

messages:
  - uuid: "FBB22E64-..."
    set: "アラーム"
    fields:
      title_:
        en: Alarms
        ja: アラーム
      summary_:
        en: Alarm list
        ja: アラーム一覧
    items:
      - device_name: M100
        value: 1
        default: モーター過負荷
        field: message_
        translations:
          en: Motor overload
          ja: モーター過負荷

構造

セクション 説明
locales エクスポートに含まれるロケール識別子のリスト（例: en, ja, zh_CN）
pages ページごとにグループ化された翻訳
pages[].items[].uuid ページアイテムのUUID（インポート時のマッチングに使用）
pages[].items[].fields 翻訳フィールド（title, alternate_title, unit）とロケール別の翻訳テキスト
messages メッセージセットの翻訳
messages[].fields メッセージセットフィールド（title_, summary_）とロケール別の翻訳テキスト
messages[].items 個別メッセージアイテムの翻訳

翻訳可能なフィールド

フィールドキー 対象 説明
title ページ部品 部品のタイトル
alternate_title ページ部品 代替タイトル（ボタン等）
unit ページ部品 単位ラベル（値、メーター）
title_ メッセージセット メッセージセットのタイトル
summary_ メッセージセット メッセージセットのサマリー
message_ メッセージアイテム メッセージテキスト
detail_message メッセージアイテム 詳細メッセージテキスト

活用のヒント

  • 翻訳データをエクスポートし、翻訳者やAIサービスに送信してから、完成した翻訳をインポート
  • AIを使って全文字列を複数言語に一括翻訳
  • プロジェクト全体の翻訳完了状況の確認用としてエクスポート