テンプレート翻訳（辞書機能）
テンプレート内の静的テキストを多言語に翻訳する辞書機能。CSV インポート/エクスポートに対応します。
テンプレート内の静的テキスト（例: 「ホーム」「お問い合わせ」）を多言語に翻訳するための辞書機能です。
仕組み
翻訳元テキスト・名前空間・言語コードをキーに、翻訳済みテキストを辞書として保存します。テンプレートからタグ経由で呼び出すと、現在の言語コンテキストに合った翻訳が出力されます。
フレーズの管理スコープ
翻訳フレーズはデフォルトで システムレベル （全サイト共通）で管理されます。
| 設定 | 説明 |
|---|---|
| システムのフレーズを使用（デフォルト ON） | システム管理画面で一元管理。全サイトで共有 |
| サイト独自のフレーズを使用（OFF） | 各サイトで独立してフレーズを管理 |
切り替えは、各サイトのプラグイン設定 → AITranslator → 設定 から行います。
新規フレーズの追加
1. 管理画面を開く
システム管理画面 → 設定 → テンプレート翻訳（システムレベル管理の場合）を開きます。
サイト独自の場合は、サイト管理画面 → 設定 → テンプレート翻訳 です。
2. 「新規作成」をクリック
新規作成画面で次の項目を入力します。
| 項目 | 説明 |
|---|---|
| 名前空間 | 翻訳グループ（通常は default、文脈別に分けたい場合に使用） |
| 言語 | 翻訳先の言語コード（例: en, ko） |
| 原文 | 翻訳元のテキスト（例: ホーム） |
| 訳文 | 翻訳後のテキスト（例: Home） |
「変更を保存」ボタンで保存します。
テンプレートでの使い方
言語コンテキストの設定
<mt:AITranslatorLang lang="..."> ブロックで言語コンテキストを設定し、内側で翻訳タグを使います。
<mt:AITranslatorLang lang="en">
<!-- 内側のタグはすべて英語に翻訳される -->
<a href="/"><mt:AITranslator phrase="ホーム"></a>
</mt:AITranslatorLang>
ファンクションタグ
<mt:AITranslator phrase="お問い合わせ">
phrase 属性で原文を指定すると、現在の言語コンテキストに合った訳文が出力されます。
ブロックタグ
<mt:AITranslator>お問い合わせ</mt:AITranslator>
ブロック内のテキストが原文として扱われます。
属性一覧
| 属性 | 説明 |
|---|---|
lang | 翻訳先の言語コード（<mt:AITranslatorLang> で必須） |
phrase | 翻訳元のテキスト（ファンクションタグの場合） |
namespace | 名前空間（省略時は default） |
名前空間の使い方
同じ原文でも文脈によって異なる翻訳が必要な場合に使います。
<!-- ナビゲーション用の「ホーム」 -->
<mt:AITranslatorLang lang="en" namespace="navigation">
<mt:AITranslator phrase="ホーム"> <!-- → Home -->
</mt:AITranslatorLang>
<!-- 不動産サイトの「ホーム」 -->
<mt:AITranslatorLang lang="en" namespace="realestate">
<mt:AITranslator phrase="ホーム"> <!-- → Residence -->
</mt:AITranslatorLang>
ほとんどのケースでは default のままで問題ありません。
CSV インポート / エクスポート
一覧画面から CSV ファイルでフレーズの一括登録・編集が可能です。
CSV 形式
namespace,source,en,ko,zh-Hans
default,ホーム,Home,홈,首页
default,お問い合わせ,Contact,문의하기,联系我们
realestate,ホーム,Residence,,
- 1 行目はヘッダ行（
namespace,source, 以降は言語コード列） - 言語列はデータに応じて動的に追加可能
- 空セルは未翻訳として扱われる
インポートモード
| モード | 動作 |
|---|---|
| Upsert | 既存フレーズは更新、新規フレーズは追加 |
| Sync | 既存データを削除して CSV の内容で置き換え |
Sync モードは破壊的な操作です。バックアップを取ってから実行してください。
AI ツールで翻訳データを作成する
CSV 形式を採用しているため、スプレッドシートの AI 機能や AI チャットを活用して翻訳データを効率的に作成できます。
スプレッドシート AI ツール（推奨）
エクスポートした CSV を Excel や Google Sheets で開き、Claude in Excel や Copilot in Excel などの AI 機能を使って翻訳列を一括で埋めます。
- 「ko 列が空欄のセルを翻訳して埋めて」のような指示で一括翻訳が可能
- 既存の翻訳パターンを参考にしながら一貫性のある翻訳を生成
- 大量のフレーズでも効率的に処理できる
AI チャット
ChatGPT・Gemini・Claude などの AI チャットで CSV を生成することもできます。
以下の CSV 形式で、日本語のテキストを英語・韓国語・中国語（簡体字）に翻訳してください。
namespace,source,en,ko,zh-Hans
翻訳対象：
- ホーム
- お問い合わせ
- 会社概要
- プライバシーポリシー
出力された CSV をそのまま AITranslator にインポートできます。