REEID Translate Pro ドキュメント
REEID Translate ドキュメンテーションハブ
REEID Translate Pro の仕組み、安全な始め方、そして本番の WordPress 環境で翻訳、ローカリゼーション、用語集、SEO、ビルダー、WooCommerce、Cloud Assist の各機能を使う方法を学びましょう。
小さく始める
まずは 1 ページ、1 商品、または 1 投稿だけを翻訳してください。出力を確認し、レイアウトを確かめてから、より多くの言語や一括ワークフローへ進みましょう。
モードを選ぶ
OpenAI キーを WordPress サイト上に保持したい場合は Local BYOK を、REEID のクラウド支援ワークフローとキャッシュ再利用を使いたい場合は Cloud Assist を使用してください。
構造を保護する
REEID は、WordPress の構造、エディターデータ、SEO 関連、スラッグ、そして対応している場合はビルダー固有のコンテンツモデルを保持しながらテキストを翻訳します。
はじめに
投稿やページを翻訳するにはどうすればよいですか？
エディター内の REEID Translate パネルを開き、対象言語を選択してから翻訳を実行します。すでに翻訳が存在する場合、REEID は不要な重複を作成せず、既存の翻訳版を更新します。
どのエディターとコンテンツタイプがサポートされていますか？
- Gutenberg のページと投稿
- Classic Editor のコンテンツ
- Elementor のページとテキストノード
- WooCommerce の商品と商品文字列
- タイトルとスラッグ
- 本文コンテンツとエディターブロック
- 対応している場合はSEOフィールド
- 翻訳の関連付けと言語メタデータ
翻訳はどこに保存されますか？
REEID は、可能な限り WordPress のネイティブな構造とメタデータの関係を使用します。これにより、壊れやすいシャドーシステムを避け、翻訳済みコンテンツを長期的に管理、確認、修復、保守しやすくします。
安全に再翻訳できますか？
はい。再翻訳の実行は、関係性と構造を維持しながら既存の翻訳を更新するよう設計されています。最良の結果を得るには、元のエディターを一貫して使用し、異なるエディターのビルダーデータを混在させないでください。
ローカル BYOK モード
ローカル BYOK とは「Bring Your Own Key（自分のキーを持ち込む）」のことです。このモードでは、OpenAI API キーは WordPress サイト上に保持され、プラグイン側の翻訳エンジンによって使用されます。
- API キーをローカルで管理したいユーザーに適しています。
- 翻訳リクエストは WordPress 管理画面のワークフローから開始されます。
- OpenAI の利用状況は、ご自身の OpenAI アカウントとモデル設定に依存します。
- クラウド支援処理よりもローカルでの直接管理を好む場合に最適です。
クラウドアシストモード
Cloud Assist は、選択された翻訳ワークフローを REEID のクラウドサービス経由で処理します。キャッシュの再利用、使用量の制御、クラウド側での処理、さらに繰り返し実行時の翻訳再利用の一貫性向上などをサポートできます。
- 繰り返しの翻訳や継続的なサイト保守に役立ちます。
- キャッシュの再利用により、不要なトークンの繰り返し使用を減らせる場合があります。
- ライセンスの状態やプランに応じて利用制限が含まれる場合があります。
- クラウド支援のワークフロー機能を使いたい場合に最適です。
Cloud Assist キャッシュ再利用
Cloud Assist のキャッシュ再利用は、変更のないコンテンツを何度も翻訳し直すのを防ぐのに役立ちます。同じ文字列が繰り返しの翻訳実行で再び現れた場合、Cloud Assist は変更のない各文字列を AI 翻訳エンジンに再送信する代わりに、前回の翻訳を再利用できます。
- 同じページを再度翻訳するときに便利です。
- 既存コンテンツに小さな編集を加えた後に役立ちます。
- 対応している場合、変更のない Gutenberg、Elementor、Classic、または WooCommerce の文字列を再利用できます。
- 繰り返しのトークン使用を減らせます。
- トークンがゼロになることを保証するものではありません。
- 変更されたテキストは、あらためて翻訳する必要があります。
- 書式の変更は再利用に影響する場合があります。
- プロンプトや用語集の変更により、キャッシュのヒット率が下がる場合があります。
実際の目安: 初回翻訳では通常のトークンを使用します。変更のない再翻訳では大幅に少なくなり、小さな編集では主に変更された文字列のみを翻訳します。大幅な書き換えでは、引き続きより多くのトークンを使用します。
用語集
用語集は、ブランド名、製品名、推奨用語、翻訳しないべき用語、クライアント固有の言語ルールに関する翻訳判断を導くのに役立ちます。
- 重要なコンテンツを翻訳する前に、優先用語を追加してください。
- ブランド名、製品名、コード、技術用語を保護します。
- ページや言語全体で一貫性を高めるために用語集ルールを使用します。
- Cloud Assist のキャッシュ再利用を使う場合は、用語集のガイダンスを安定させてください。
プロンプトとカスタム指示
プロンプトガイダンスを使うと、プラグインの中核となる安全性と構造保持のルールを置き換えることなく、追加の翻訳指示を加えられます。
- 名前や製品コードを保持します。
- フォーマル、自然、技術的、またはマーケティング向けのトーンを使います。
- ブランド用語に従います。
- レイアウト構造を変えずにスタイルを調整します。
文字列のローカライズ
文字列のローカライズは、単一のページや製品に属さない場合がある、より小さなインターフェースレベルのテキストを扱います。これにより、フロントエンド全体を完全に多言語対応にできます。
メニューラベル
ナビゲーションラベルを確認し、不足している翻訳を自動補完し、短いメニュー文言には手動で上書き適用します。
UI辞書
ボタン、ラベル、見出し、繰り返し表示されるUIテキストなどのインターフェース用フレーズの再利用可能な翻訳を保存します。
意味のレビュー
繰り返し使われるフレーズを確認し、言語、メニュー、ウィジェット、インターフェース文字列全体で一貫性を向上させます。
保存されたUI翻訳は、既知のインターフェース文字列を再利用できるため、再度翻訳する必要がなく、APIの繰り返し利用を減らせます。
WooCommerce翻訳
REEID Translate Proは、商品設定を保持しながらWooCommerceの商品翻訳をサポートします。目的は、価格、在庫、関連付け、コアの商品設定を損なうことなく、言語固有の商品コンテンツを翻訳することです。
- 商品タイトルとスラッグ
- 短い説明と長い説明
- 対応している場合は商品属性
- 対応している場合はSEOフィールド
- 価格と在庫のロジックを保持します
- 商品設定を保持します
- Cloud Assistでの商品文字列の再利用をサポートします
- 不要な商品の重複を避けるよう設計されています
SEO とインデックス
REEID は、言語間の関係を予測しやすく保ちながら、多言語 SEO をサポートするよう設計されています。対応している場合、翻訳済みページで言語を意識した URL、SEO メタデータ、hreflang 関係、canonical ロジックを使用できるようにします。
- ネイティブ言語のスラッグを含む、翻訳済みスラッグをサポートします。
- YoastやRank Mathなどの主要なSEOプラグインと併用できます。
- 可能な場合は重複するSEO出力を避けるのに役立ちます。
- 翻訳コンテンツのhreflangおよびcanonicalの関係をサポートします。
- 設定されている場合、元の英語/ルートURL構造を保持します。
レイアウト保護と汚染ブロック
REEID は、翻訳前にエディターとビルダーの構造を検出することでレイアウトを保護します。ページに混在したエディターデータが含まれているように見える場合、レイアウトの損傷を避けるために翻訳がブロックされることがあります。
翻訳がブロックされる理由
- 古いElementorメタデータを含むGutenbergコンテンツ
- ブロックマークアップが混在したElementorコンテンツ
- アクティブなエディターと一致しないビルダーデータ
- 安全でない可能性のある構造変換
対処方法
- 元々作成に使用したエディターでページを開いてください。
- 一度保存してから、もう一度翻訳を試してください。
- 意図的に再構築されたページでは、古いビルダーデータのクリーンアップが必要な場合があります。
- レイアウトのソースが不明な場合は、無理に翻訳しないでください。
典型的なメッセージ: このレイアウトを保護するため、翻訳はブロックされました。変更は行われませんでした。
よくあるエラーメッセージ
- AJAX failed: タイムアウト、nonce の問題、サーバーの中断、またはネットワーク障害を示している可能性があります。
- Invalid nonce: 管理画面を更新して、もう一度お試しください。
- Missing parameters: 必要な言語、投稿 ID、またはリクエスト値が送信されませんでした。
- Translation engine not available: 翻訳ランタイムの読み込みに失敗したか、ブロックされました。
- No enabled languages found: 設定で対象言語を構成してください。
- Mixed builder blocked: ページに競合するエディターデータがあります。
- License invalid: ライセンスキーとドメインの有効化を確認してください。
- Limit reached: 使用枠のリセットを待つか、プラン/設定を調整してください。
パフォーマンスと推奨設定
- 翻訳作業は管理画面のワークフロー内で実行され、フロントエンドの訪問者には通常、保存済みの翻訳コンテンツが表示されます。
- 可能であれば PHP 8.1 以降を使用してください。
- 256MB のメモリは最低限の実用的な出発点であり、大規模サイトでは 512MB 以上を推奨します。
- 大きなページ、重いElementorレイアウト、WooCommerce商品、一括翻訳では、より多くのメモリと実行時間が必要になる場合があります。
- Cloud Assistのキャッシュ再利用は、変更のないコンテンツでのトークンの繰り返し使用を減らすのに役立ちます。
- キャッシュの動作をテストする際は、プロンプトと用語集のガイダンスを安定した状態に保ってください。
なぜ REEID Translate Pro なのか？
REEID Translate Pro は、構造保護、SEO 対応、ビルダー別の処理、用語集ガイダンス、Cloud Assist のキャッシュ再利用、そして実際のウェブサイト向けの実用的なワークフローを備えた、AI ファーストの WordPress 翻訳向けに構築されています。