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

# Immersive Translate

> Immersive Translate 브라우저 확장 연동 가이드

## 소개

Immersive Translate는 이중 언어 웹페이지 읽기를 지원하는 우수한 브라우저 번역 확장 프로그램입니다. **GravitexAI**와 연동하면 강력한 AI 모델을 활용하여 더 정확한 번역을 제공할 수 있습니다.

## 빠른 설치

### 지원 브라우저

* Chrome / Edge / Brave
* Firefox
* Safari

### 설치

1. 브라우저 확장 프로그램 스토어를 방문합니다
2. "Immersive Translate"를 검색합니다
3. "Install"을 클릭하고 도구 모음에 추가합니다
4. 또는 [Immersive Translate](https://immersivetranslate.com)를 방문합니다

## GravitexAI 설정

1. **설정 열기**: 확장 프로그램 아이콘을 클릭하고 "Settings"를 선택합니다
2. **서비스 선택**: "Translation Service"를 클릭하고 "OpenAI"를 찾습니다
3. **설정 입력**:
   * **APIKEY**: GravitexAI 키
   * **Custom API URL**: `https://api.gravitex.ai/v1/chat/completions`
   * **Custom Model**: 선택 사항 (예: `gpt-3.5-turbo`)

## 핵심 기능

### 1. 웹페이지 번역

**자동 번역**

* 외국어 페이지에서 언어를 자동 감지합니다
* 도구 모음의 "Translate" 버튼을 클릭합니다

**수동 번역**

* 확장 프로그램 아이콘을 클릭하고 "Translate this page"를 선택합니다

### 2. 번역 모드

**이중 언어 (권장)**

* 원문 형식을 유지하고 번역문을 아래에 표시합니다
* 학습 및 용어 이해에 적합합니다

**번역문만**

* 원문을 완전히 번역문으로 대체합니다

### 3. 선택 영역 번역

* 텍스트를 선택하고 팝업의 "Translate" 버튼을 클릭합니다
* 복사, 발음 기능을 사용할 수 있습니다

## 고급 설정

### 1. 커스텀 프롬프트

<Tabs>
  <Tab title="기술 문서">
    ```
    As a technical translator:
    1. Keep all technical terms in original
    2. Provide Korean explanation in brackets
    3. Preserve code and command format
    ```
  </Tab>

  <Tab title="학술 논문">
    ```
    As an academic translator:
    1. Use academic language standards
    2. Preserve citation formats
    3. Translate terms accurately
    ```
  </Tab>

  <Tab title="문학">
    ```
    As a literary translator:
    1. Maintain literary aesthetics
    2. Handle cultural context
    3. Preserve rhetorical effects
    ```
  </Tab>
</Tabs>

### 2. 번역 규칙

특정 사이트에 자동 번역을 설정합니다:

1. "Translation Rules"로 이동합니다
2. 도메인을 추가합니다 (예: `en.wikipedia.org`)
3. 선택: Always / Never / Smart

### 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. "Video Subtitle Translation"을 활성화합니다
2. 표시 모드를 선택합니다
3. 자막 스타일을 조정합니다

### 3. 전자책 번역

* EPUB 형식 업로드
* 언어 및 모드 선택
* 이중 언어 버전 다운로드

### 4. 입력창 번역

* 입력창에 텍스트를 입력합니다
* `Alt + S`를 눌러 번역합니다
* 원클릭으로 대체합니다

## 단축키

| 기능       | 기본값       |
| -------- | --------- |
| 번역/원문 표시 | `Alt + T` |
| 모드 전환    | `Alt + M` |
| 선택 영역 번역 | `Alt + S` |
| 설정 열기    | `Alt + O` |

## 모델 추천

| 콘텐츠 유형 | 모델                           | 이유              |
| ------ | ---------------------------- | --------------- |
| 뉴스     | `gpt-3.5-turbo`              | 빠르고 정확하며 가성비 좋음 |
| 기술 문서  | `gpt-4`                      | 정확한 용어 처리       |
| 학술 논문  | `claude-3-opus`              | 강력한 장문 이해       |
| 문학     | `claude-sonnet-4-5-20250929` | 문학적 아름다움 보존     |
| 일상 웹   | `gpt-3.5-turbo`              | 빠르고 기본 요구 충족    |

## 성능 최적화

### 1. 캐싱

* "Translation Cache"를 활성화합니다
* 캐시 기간을 설정합니다 (24시간 권장)

### 2. 배치 번역

* 배치 크기를 조정합니다 (5–10문단)
* 동시 실행 수를 설정합니다 (2–3)

### 3. 트리거 조건

* 최소 길이: 10자
* 내비게이션 메뉴, 광고 무시
* 지연: 200ms

## 문제 해결

<AccordionGroup>
  <Accordion title="번역 실패">
    * API 키를 확인하세요
    * 네트워크 연결을 확인하세요
    * 페이지를 새로고침하거나 모드를 전환하세요
    * 콘솔(F12)에서 오류를 확인하세요
  </Accordion>

  <Accordion title="번역 속도 느림">
    * 더 빠른 모델로 전환하세요
    * 배치당 텍스트 양을 줄이세요
    * 캐싱을 활성화하세요
    * 네트워크 지연을 확인하세요
  </Accordion>

  <Accordion title="형식 문제">
    * 이중 언어/번역문만 모드를 전환하세요
    * 번역 레이아웃 스타일을 조정하세요
    * 해당 사이트에 커스텀 규칙을 추가하세요
  </Accordion>
</AccordionGroup>

## 모범 사례

### 읽기 경험

* 선명한 글꼴을 선택하세요
* 원문과 번역문 간 대비를 높이세요
* 줄 간격을 1.5배로 설정하세요

### 학습

* 비교를 위해 이중 언어 모드를 사용하세요
* 용어 학습에 선택 영역 번역을 활용하세요
* 복습을 위해 번역을 내보내세요

### 비용 관리

* 일상 브라우징에는 `gpt-3.5-turbo`를 사용하세요
* 중요한 문서에는 `gpt-4` 또는 Claude를 사용하세요
* 캐싱을 활용하여 중복 요청을 줄이세요