Immersive Translate User Guide

I. Introduction

Immersive Translate is an excellent browser translation extension that supports bilingual comparison reading on webpages. By integrating Nebula Lab, it can call powerful AI models to achieve more accurate and natural translation results, suitable for foreign language reading, learning, work, and other scenarios.

II. Quick Installation

Supported Browsers

Chrome / Edge / Brave

Firefox

Safari

Installation Steps

Visit the extension store of the corresponding browser (e.g., Chrome Web Store, Firefox Add-ons).

Search for "Immersive Translate".

Click "Install" and add it to the browser toolbar.

Or visit the Immersive Translate Official Website to get the installation link directly.

III. Configure Nebula Lab

Call AI models for translation through Nebula Lab. The configuration steps are as follows:

Open Settings: Click the extension icon on the browser toolbar and select "Settings".

Select Translation Service: Click "Translation Services" in the left menu, find the "OpenAI" service, and click "Manage" or "Settings".

Fill in Configuration Information:

APIKEY: Enter your Nebula Lab key (obtained from the Nebula Lab console).

Custom API Address: https://llm.ai-nebula.com/v1/chat/completions (Fixed address).

Custom Model: Optional (e.g., gpt-3.5-turbo, uses recommended model by default).

IV. Core Functions

1. Webpage Translation

Automatic Translation

The extension automatically detects the language when visiting a foreign language webpage.

Click the "Translate" button on the toolbar to automatically complete the full-page translation.

Manual Translation

Click the extension icon on the toolbar and select "Translate this page".

Wait a few seconds for the translation results to appear on the page.

2. Translation Modes

Bilingual Comparison (Recommended)

Retains the original format, displaying the translation below the original text.

Suitable for comparison learning and checking professional terms.

Translation Only

Completely replaces the original text, suitable for quickly reading foreign content.

Can switch back to bilingual mode at any time via shortcut keys.

3. Mouseover Translation

Select the text to be translated and click the "Translate" button that pops up.

View the translation in the pop-up window, supporting functions like copying and pronunciation.

V. Advanced Settings

1. Custom Prompts

Set translation styles for different content types, example:

Technical Documents

As a technical document translation expert, please:
1. Retain the original text for all technical terms
2. Provide Chinese explanations in parentheses
3. Keep the original format of code and commands

Academic Papers

As an academic translation expert, please:
1. Use academic standard expressions
2. Retain citation formats
3. Accurately translate professional terms

Literary Works

As a literary translation expert, please:
1. Maintain the literary beauty of the original text
2. Pay attention to cultural background conversion
3. Preserve the effect of rhetorical devices

2. Translation Rules

Set automatic translation behavior for specific websites:

Enter the "Translation Rules" settings page.

Add the website domain (e.g., en.wikipedia.org).

Select behavior:

Always translate

Never translate

Intelligent judgment (decide automatically based on language)

3. Style Customization

Customize the display style of the translation (via CSS code):

VI. Featured Functions

1. PDF Translation

Supports online PDF document translation, retaining the original format.

Supports bilingual comparison display, translation can be copied.

2. Video Subtitle Translation

Supports mainstream video platforms (YouTube, Netflix, Bilibili, etc.):

Turn on the "Video Subtitle Translation" function.

Select subtitle display method (e.g., bilingual overlay, translation only).

Adjust subtitle font, size, color, and other styles.

3. E-book Translation

Upload EPUB format e-books.

Select translation language and mode (bilingual/translation only).

Download the translated bilingual version.

4. Input Box Translation

Real-time translation in webpage input boxes:

Enter text in the input box (e.g., email, comment).

Press the shortcut key to trigger translation (default Alt + S).

View translation suggestions and replace with one click.

VII. Shortcut Keys

Common shortcut keys (customizable in settings):

Function	Default Shortcut
Translate/Show Original	`Alt + T`
Switch Translation Mode	`Alt + M`
Translate Selected Text	`Alt + S`
Open Settings	`Alt + O`

VIII. Model Selection Suggestions

Select by Content Type

Content Type	Recommended Model	Reason
News Articles	`gpt-3.5-turbo`	Fast, accurate, high cost-performance
Technical Docs	`gpt-4`	Precise terminology, clear logic
Academic Papers	`claude-3-opus`	Strong long-text understanding, high professionalism
Literary Works	`claude-3-sonnet`	Retains literary beauty, style adaptation
Daily Webpages	`gpt-3.5-turbo`	Fast response, meets basic needs

Balance Performance and Quality

Automatically select models based on text length and type (example logic):

IX. Performance Optimization

1. Cache Settings

Enable the "Translation Cache" function to reduce repeated translations.

Set cache duration (recommended 24 hours) and regularly clear expired cache.

2. Batch Translation

Adjust batch translation size (5-10 paragraphs/batch) to avoid processing overly long text at once.

Set reasonable concurrency (2-3), balancing speed and stability.

3. Trigger Conditions

Minimum translation length: Set to 10 characters (avoid translating meaningless short sentences).

Ignore elements: Filter out navigation menus, ads, and other content that does not need translation.

Delay translation: Set a 200ms delay to avoid frequent triggering.

X. Common Issues

Translation Failed

Possible Causes: Invalid API key, network connection interruption, special page structure.

Solutions:

Verify if the API key is correct (re-obtain from Nebula Lab console).

Check network connection, turn off proxy or VPN and retry.

Refresh the page, or switch "Translation Mode" and retry.

Open browser console (F12) to view error logs for troubleshooting.

Slow Translation Speed

Optimization Methods:

Switch to a faster model (e.g., replace gpt-4 with gpt-3.5-turbo).

Reduce the amount of text translated at once (split long documents).

Enable cache function to avoid repeated translation.

Check network latency (recommend stable network environment).

Format Disorder

Handling Methods:

Try switching between "Bilingual Comparison" and "Translation Only" modes.

Adjust translation layout (e.g., margins, line spacing) in "Style Customization".

Add custom translation rules for the website (ignore specific elements).

Report the issue to developers (via "Feedback" function in the extension).

XI. Best Practices

1. Reading Experience Optimization

Choose clear fonts (e.g., Microsoft YaHei, Source Han Sans) and adjust font size to a comfortable level.

Increase contrast between translation and original text (e.g., original in black, translation in dark gray).

Set line spacing to 1.5x and enable eye protection mode (light gray background).

2. Learning Assistance

Always use "Bilingual Comparison" mode to learn new words against the original text.

Use mouseover translation to query professional terms and add them to the vocabulary book.

Export translation content (e.g., PDF, Markdown) for review notes.

3. Work Efficiency

Set "Always Translate" rules for frequently visited foreign websites (e.g., industry news sites).

Customize prompts for professional fields (e.g., programming, medicine) to ensure terminology accuracy.

Master shortcut keys (e.g., Alt + T for quick translation) to reduce operation steps.

4. Cost Control

Use gpt-3.5-turbo for daily browsing, and save gpt-4 or Claude models for important documents.

Set translation length limits (e.g., only translate content over 50 words) to avoid waste.

Use cache to reduce repeated translations and monitor usage via the Nebula Lab console.

XII. Advanced Tips

1. Custom Translation Scripts

Enhance translation functions via JavaScript (example):

2. Integration with Other Tools

Readwise: Save highlights from translations and sync to knowledge base.

Notion: Export bilingual content as Notion notes and add annotations.

Anki: Create flashcards from new words found via mouseover translation to assist language learning.

3. Developer Mode

Enable "Debug Mode" to view translation logs and API call details.

Submit translation improvement suggestions or error cases via the "Feedback" function in the extension.

Participate in open-source projects (if the extension is open source) to contribute translation corpus or code optimization.

XIII. Troubleshooting Guide

Extension Cannot Load

Check if browser version is compatible (recommend latest Chrome/Edge).

Disable other conflicting translation extensions (e.g., Google Translate).

Clear browser cache (Ctrl + Shift + Delete) and restart the browser.

Uninstall and reinstall the extension, ensuring it is obtained from official channels.

Translation Results Not Showing

Confirm if webpage content supports translation (some dynamically loaded content may need manual triggering).

Check if Nebula Lab configuration is correct (interface address, key validity).

Turn off ad blockers (may mistakenly block translation requests).

Try switching to another translation service (e.g., temporarily use built-in translation engine).

High Memory Usage

Regularly clear translation cache (operate in "Advanced Settings").

Reduce the number of simultaneously open translation pages (recommend no more than 5).

Lower batch translation concurrency (set to 1-2).

Close temporarily unused tabs to release browser memory.

Immersive Translation Integration Guide

Immersive Translate User Guide#

I. Introduction#

II. Quick Installation#

Supported Browsers#

Installation Steps#

III. Configure Nebula Lab#

IV. Core Functions#

1. Webpage Translation#

Automatic Translation#

Manual Translation#

2. Translation Modes#

Bilingual Comparison (Recommended)#

Translation Only#

3. Mouseover Translation#

V. Advanced Settings#

1. Custom Prompts#

2. Translation Rules#

3. Style Customization#

VI. Featured Functions#

1. PDF Translation#

2. Video Subtitle Translation#

3. E-book Translation#

4. Input Box Translation#

VII. Shortcut Keys#

VIII. Model Selection Suggestions#

Select by Content Type#

Balance Performance and Quality#

IX. Performance Optimization#

1. Cache Settings#

2. Batch Translation#

3. Trigger Conditions#

X. Common Issues#

Translation Failed#

Slow Translation Speed#

Format Disorder#

XI. Best Practices#

1. Reading Experience Optimization#

2. Learning Assistance#

3. Work Efficiency#

4. Cost Control#

XII. Advanced Tips#

1. Custom Translation Scripts#

2. Integration with Other Tools#

3. Developer Mode#

XIII. Troubleshooting Guide#

Extension Cannot Load#

Translation Results Not Showing#

High Memory Usage#