> ## Documentation Index
> Fetch the complete documentation index at: https://docs.mixroute.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Immersive Translate

> Immersive Translateブラウザー拡張機能の連携ガイド

## はじめに

Immersive Translateは、Webページの対訳表示に対応した優れたブラウザー翻訳拡張機能です。MixRoute APIと連携することで、強力なAIモデルを活用し、より正確で自然な翻訳を実現できます。

## クイックインストール

### 対応ブラウザー

* Chrome / Edge / Brave
* Firefox
* Safari

### インストール手順

1. ブラウザーの拡張機能ストアにアクセス
2. 「Immersive Translate」を検索してください
3. 「インストール」をクリックし、ブラウザーのツールバーに追加してください
4. または、[Immersive Translate公式サイト](https://immersivetranslate.com/)にアクセスしてください。

## Mixroute APIの設定

<Steps>
  <Step title="設定を開く">
    ブラウザーのツールバーで拡張機能アイコンをクリックし、「設定」を選択してください
  </Step>

  <Step title="翻訳サービスの選択">
    左のメニューで「翻訳サービス」をクリックし、「OpenAI」を探します
  </Step>

  <Step title="設定を入力">
    * **APIKEY**：ご自身のMixroute APIキー
    * **カスタムAPI URL**：`https://api.mixroute.ai/v1/chat/completions`
    * **カスタムモデル**: 任意（例: `gpt-5.5`）
  </Step>
</Steps>

## 主な機能

### 1. ウェブページの翻訳

**自動翻訳**

* 外国語のページにアクセスすると、言語を自動検出します。
* ツールバーの「翻訳」ボタンをクリックして、ページ全体を翻訳します

**手動翻訳**

* 拡張機能のアイコンをクリックし、「このページを翻訳」を選択します。

### 2. 翻訳モード

<CardGroup cols={2}>
  <Card title="バイリンガル（推奨）" icon="columns">
    元の書式を維持し、原文の下に翻訳を表示します。学習や用語の確認に適しています。
  </Card>

  <Card title="翻訳のみ" icon="file-lines">
    原文を完全に置き換えます。すばやく読むのに適しています。
  </Card>
</CardGroup>

### 3. 選択範囲の翻訳

* テキストを選択し、ポップアップの「翻訳」ボタンをクリックします
* コピー、発音などをサポート

## 詳細設定

### 1. カスタムプロンプト

<Tabs>
  <Tab title="技術ドキュメント">
    ```text theme={null}
    As a technical documentation translation expert:
    1. Preserve all technical terms in original language
    2. Provide Chinese explanation in parentheses
    3. Keep code and commands in original format
    ```
  </Tab>

  <Tab title="学術論文">
    ```text theme={null}
    As an academic translation expert:
    1. Use academic standard expressions
    2. Preserve citation format
    3. Accurately translate professional terminology
    ```
  </Tab>

  <Tab title="文学">
    ```text theme={null}
    As a literary translation expert:
    1. Maintain the literary beauty of the original
    2. Pay attention to cultural context conversion
    3. Preserve rhetorical effects
    ```
  </Tab>
</Tabs>

### 2. 翻訳ルール

特定のサイトに対する自動翻訳を設定します。

1. 「翻訳ルール」の設定に移動してください
2. ウェブサイトのドメインを追加します（例: `en.wikipedia.org`）
3. 動作を選択：常に翻訳 / 翻訳しない / スマート検出

### 3. スタイルのカスタマイズ

```css theme={null}
.immersive-translate-target {
    font-family: "Microsoft YaHei", sans-serif;
    font-size: 14px;
    color: #333;
}

.immersive-translate-target-wrapper {
    background-color: #f5f5f5;
    padding: 5px;
    margin: 5px 0;
    border-radius: 3px;
}
```

## 特別な機能

### 1. PDF翻訳

* オンラインでのPDFドキュメントの翻訳に対応しています
* 元の書式を維持し、対訳で表示します

### 2. 動画字幕の翻訳

YouTube、Netflix、Bilibiliなどに対応。

1. 「動画字幕翻訳」を有効にする
2. 字幕の表示モードを選択します
3. 字幕スタイルを調整

### 3. 電子書籍の翻訳

* EPUB形式の電子書籍をアップロード
* 翻訳言語とモードを選択してください
* バイリンガル版をダウンロード

### 4. 入力欄の翻訳

* 入力欄にテキストを入力します
* `Alt + S`を押して翻訳を実行します
* ワンクリックで翻訳に置き換え

## キーボードショートカット

| 機能 | デフォルトのショートカット |
| - | - |
| 翻訳/原文を表示 | `Alt + T` |
| 翻訳モードの切り替え | `Alt + M` |
| 選択したテキストを翻訳 | `Alt + S` |
| 設定を開く | `Alt + O` |

## パフォーマンスの最適化

### 1. キャッシュ設定

* 「翻訳キャッシュ」を有効にしてください
* キャッシュの保持期間を設定（推奨24時間）

### 2. 一括翻訳

* バッチサイズを調整（1バッチあたり5〜10段落）
* 適切な同時実行数（2～3）を設定します

### 3. 実行条件

* 翻訳対象の最小文字数: 10文字
* ナビゲーションメニューや広告などを除外
* 翻訳の遅延：200ms

## FAQ

<AccordionGroup>
  <Accordion title="翻訳に失敗する">
    * APIキーが正しいことを確認してください
    * ネットワーク接続を確認します
    * ページを再読み込みするか、翻訳モードを切り替える
    * コンソール（F12）を開いてエラーログを確認
  </Accordion>

  <Accordion title="翻訳が遅い">
    * より高速なモデル（例: `gpt-5.5`）に切り替えてください
    * 1回の翻訳で処理するテキスト量を減らしてください
    * キャッシュを有効にしてください
    * ネットワークの遅延を確認してください
  </Accordion>

  <Accordion title="書式の問題">
    * 「バイリンガル」と「翻訳のみ」のモードを切り替え
    * 翻訳のレイアウトスタイルを調整
    * サイトにカスタム翻訳ルールを追加します
  </Accordion>
</AccordionGroup>

## ベストプラクティス

### 読書体験の最適化

* 読みやすいフォント（Microsoft YaHei、Source Han Sans）を選択してください
* 翻訳と原文のコントラストを強めてください
* 行間を1.5倍に設定

### 学習支援

* 対比して学習するには「バイリンガル」モードを使用
* 専門用語には選択範囲の翻訳を使用
* 確認用に翻訳をエクスポート

### コスト管理

* 日常的な閲覧には`gpt-5.4-mini`を使用してください
* 重要なドキュメントには`gpt-5.5`またはClaudeを使用してください
* キャッシュを活用して、同じ内容の繰り返し翻訳を減らす


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.