docs/content/docs/user-manual/translate.mdx

106 lines
4.7 KiB
Text

---
title: Translations
description: Translate webpages or text selections directly in Zen
---
Based on Firefox, Zen also inherit its translation features, allowing you navigate websites in various language easily. The translation process are done locally on your device, instead of relying in cloud services. You can translate a whole page, translate a specific text selection, or translated a link text!
### Translating the full page
When you visit a webpage in a supported language, the translation panel will popped up automatically. You can also do it manually by opening **Main Menu** button and selecting **Translate page** option.
{/* TODO: Insert screenshot of Translation panel popped up near the URL bar in Single Toolbar mode */}
<Callout type="info" title="Translate Button">
You can also use a dedicated Translate button in the right side of the URL bar, which shows up when visiting webpages outside of your preferred language. In Single Toolbar mode, the button will be hidden by default and can be accessed after clicking the URL bar.
</Callout>
Zen detects the page languages manually and will suggest to translate it to your preferred languages. You can use the "**Translate from**" dropdown menu to change page language to detect, and use the "**Translate to**" dropdown menu to change your translation output language. Select "**Translate**" to translate the entire page.
<Callout>
Zen will download the language first if you're using this feature for the first time. After the language is downloaded, translation process will take around 20-60 seconds, depend on the length of contents.
</Callout>
The **Translate button** in URL bar will be updated along with the translation process, and after the translation process gets completed, your preferred language will be shown beside the icon.
To revert the page to the original language, click the Translate button in the URL bar and select "**Show original**".
{/* TODO: Insert screenshot of Translation panel popped up after a translate process is done, and highlight the "Show original" button */}
### Translating text selection
You can also translate a specific word or sentence, which will be handy when reading pages or learning in a foreign language. Select the text you want to translate, right click, and select "**Translate Selection to...**" option.
{/* TODO: Screenshot of a selected text, right clicked with Translate Selection to... option highlighted */}
The selected texts will be translated and displayed in a pop-up. Select "**Copy**" to save the whole translation to your clipboard, "**Translate full page**" to translate the entire webpage, or "**Done**" to close the pop-up.
{/* TODO: Screenshot of translating a specific sentence */}
You can also select a text manually to copy only a specific part of your translation, or change the input and output translation language using the "From" and "To" dropdown menu.
You can also right click a hyperlink without selecting any text, and select "**Translate Link Text to...**" to translate the link text.
{/* TODO: Screenshot of rightclicking a hyperlink with Translate Link Text to... option highlighted */}
### Setting Languages
#### Using Webpage Language Settings
Choose languages for displaying web pages by default, in order of preference. You can click **Select a language to add** to add more language to your preference and click **Add** to put it onto the options. And then, you can choose a language and click **Move Up** to prioritize it, click **Move Down** to deprioritize it, or **Remove** to remove it from your preferred language. Click **OK** to confirm your preference.
### Translations Options
- Set your language and site translation preferences and manage language downloaded for offline translation.
- "Always translate these languages"
- "Never translate these languages"
- "Never translate these sites"
- "Download languages"
- Download translation model for all languages: around 1,3 GB
- Translation model for most languages: around 17-34 MB/languages
- Translation model for languages with special characters (Arabic, Japanese, Korean, Russian, Traditional Chinese): 59-116 MB/languages
### Supported Languages
Here are the languages that currently supported translation feature in Zen:
- Arabic
- Bulgarian
- Chinese (Simplified)
- Catalan
- Croatian
- Czech
- Danish
- Dutch
- Estonian
- Finnish
- French
- German
- Greek
- Hungarian
- Indonesian
- Italian
- Japanese
- Korean
- Latvian
- Lithuanian
- Polish
- Portuguese
- Romanian
- Russian
- Serbian
- Slovak
- Slovenian
- Spanish
- Swedish
- Turkish
- Ukrainian
- Vietnamese
### Using Translation Feature
- From **"Translate this page?"** popup or **Translate button** in URL bar
- From right click menu > **"Translate Selection to Language..."**
- From main menu button > **"Translate page...**