Merge pull request #192 from KiKaraage/main
Keyboard Shortcuts & Translate
191
content/docs/user-manual/shortcuts.mdx
Normal file
|
@ -0,0 +1,191 @@
|
|||
---
|
||||
title: Keyboard Shortcuts
|
||||
description: Enhance your Zen experience with customizable keybinds
|
||||
---
|
||||
|
||||
import KeyboardShortcut from '@/components/KeyboardShortcut';
|
||||
|
||||
Zen Browser supported lots of keyboard shortcuts to help you do common tasks quicker. Access `Settings" /> > `Keyboard Shortcuts" /> and edit the available shortcuts to suit your workflow even more!
|
||||
|
||||
### Change or rebind keyboard shortcuts in Zen
|
||||
|
||||
<div align="center">
|
||||
<video width="100%" loop autoPlay>
|
||||
<source src="/assets/user-manual/shortcuts/edit-shortcut.mp4" />
|
||||
Your browser does not support the video tag.
|
||||
</video>
|
||||
</div>
|
||||
|
||||
- In Keyboard Shortcuts setting page, to change or rebind shortcut of a feature, click the text field beside it, press your shortcuts, and press Esc to save your new shortcut.
|
||||
- The text field will show a dark green outline quickly when the new shortcut is succesfully assigned and saved.
|
||||
- The text field will show a red outline if the new shortcut you assign is already taken as default shortcut for other feature in Zen. Below the field, a *Conflict with another shortcut* warning will be shown. If you encounter this, you can try assign another shortcut, or press Backspace to clear the shortcut field. You can also clear the shortcut field of a feature you don't need, before assigning it as a new shortcut for other features.
|
||||
- Some Zen features might not have conflict when its original shortcut got reassigned for other features, but when the shortcut is called, it will resort to do the original feature. You can check the Keyboard Settings if the shortcut you're assigning is already set for other feature, and try assign other shortcut to make it work.
|
||||
- Not all features are available in the Keyboard Shortcuts settings, especially alternative shortcuts derived from Firefox ([Check default Firefox shortcut lists](https://support.mozilla.org/en-US/kb/keyboard-shortcuts-perform-firefox-tasks-quickly)). This might result in failure when applying or accessing the feature using a custom shortcut you assigned. If a Firefox shortcut is not available in the Keyboard Shortcuts settings, you won't be able to use it as a custom shortcut yet. Kindly report it to [Zen Github Issues page](https://github.com/zen-browser/desktop/issues) first!
|
||||
|
||||
|
||||
## List of editable keyboard shortcuts in Zen
|
||||
|
||||
### Compact Mode
|
||||
|
||||
| **Action** | **Shortcut** |
|
||||
| ----------------------- | ---------------------------------------------- |
|
||||
| Toggle Floating Toolbar | <KeyboardShortcut shortcut="Alt + Ctrl + T" /> |
|
||||
| Toggle Floating Sidebar | <KeyboardShortcut shortcut="Alt + Ctrl + S" /> |
|
||||
| Toggle Compact Mode | <KeyboardShortcut shortcut="Alt + Ctrl + C" /> |
|
||||
|
||||
### Workspaces
|
||||
|
||||
| **Action** | **Shortcut** |
|
||||
| -------------------------- | ---------------------------------------------- |
|
||||
| Backward Workspace | <KeyboardShortcut shortcut="Alt + Ctrl + Q" /> |
|
||||
| Forward Workspace | <KeyboardShortcut shortcut="Alt + Ctrl + E" /> |
|
||||
| Switch to Workspace (1-10) | Not set by default |
|
||||
|
||||
You can assign custom keyboard shortcuts to switch into up to 10 workspaces.
|
||||
|
||||
### Split View
|
||||
|
||||
The "Toggle Split View" shortcuts currently only applicable when selecting multiple tabs in tab sidebar, and doesn't worked when used inside a split view.
|
||||
|
||||
| **Action** | **Shortcut** |
|
||||
| ------------------------------ | ---------------------------------------------- |
|
||||
| Close Split View (Unsplit All) | <KeyboardShortcut shortcut="Alt + Ctrl + U" /> |
|
||||
| Toggle Split View Horizontal | <KeyboardShortcut shortcut="Alt + Ctrl + H" /> |
|
||||
| Toggle Split View Vertical | <KeyboardShortcut shortcut="Alt + Ctrl + V" /> |
|
||||
| Toggle Split View Grid | <KeyboardShortcut shortcut="Alt + Ctrl + G" /> |
|
||||
|
||||
### Window & Tab Management
|
||||
|
||||
| **Action** | **Shortcut** |
|
||||
| ----------------------- | ------------------------------------------------ |
|
||||
| New Window | <KeyboardShortcut shortcut="Alt + Ctrl + U" /> |
|
||||
| New Tab | <KeyboardShortcut shortcut="Ctrl + T" /> |
|
||||
| Close Tab | <KeyboardShortcut shortcut="Ctrl + W" /> |
|
||||
| Close Window | <KeyboardShortcut shortcut="Shift + Ctrl + W" /> |
|
||||
| Quit Application | <KeyboardShortcut shortcut="Ctrl + Q" /> |
|
||||
| Restore Last Closed Tab | <KeyboardShortcut shortcut="Shift + Ctrl + T" /> |
|
||||
| Undo Close Window | <KeyboardShortcut shortcut="Shift + Ctrl + N" /> |
|
||||
| Select tab #1 - #8 ^ | <KeyboardShortcut shortcut="Alt + 1/2/.../8" /> |
|
||||
| Select last tab | <KeyboardShortcut shortcut="Alt + 9" /> |
|
||||
|
||||
- By default, you can **switch to next tab** using the <KeyboardShortcut shortcut="Ctrl + Tab" /> shortcut and **switch to previous tab** using the <KeyboardShortcut shortcut="Ctrl + Shift + Tab" /> shortcut.
|
||||
- When you're in Compact Mode and switching tabs using <KeyboardShortcut shortcut="Ctrl + Tab" /> or <KeyboardShortcut shortcut="Ctrl + Shift + Tab" />, you can peek into the tab you're switching in by enabling the **"Briefly make the toolbar popup when switching or opening new tabs in compact mode"** option in `Settings` > `Look and Feel` > `Theme Settings`.
|
||||
- Pressing <KeyboardShortcut shortcut="Ctrl + Tab" /> when you're in the last tab will switch you to the first available tab (Essentials first, then pinned tabs, and lastly, regular tabs).
|
||||
- ^ Tab numbers listed for these keyboard shortcuts includes Essentials and pinned tabs. Example: If you have three Essentials, four pinned tabs, and five regular tabs:
|
||||
- <KeyboardShortcut shortcut="Alt + 1" /> until <KeyboardShortcut shortcut="Alt + 3" /> will switch you to your Essentials,
|
||||
- <KeyboardShortcut shortcut="Alt + 4" /> until <KeyboardShortcut shortcut="Alt + 7" /> will switch you to your pinned tabs,
|
||||
- <KeyboardShortcut shortcut="Alt + 8" /> will switch you to your first regular tab,
|
||||
- <KeyboardShortcut shortcut="Alt + 9" /> will switch you to your last tab (12th).
|
||||
- Zen can also let you cycle through recently used tabs, instead of cycling through all of your tabs. Enable it by go to `Settings` > `General` > `Tabs` and check the `Ctrl + Tab cycles through tabs in recently used order`. A popup containing up to 7 recently used tabs will show up when you press <KeyboardShortcut shortcut="Ctrl + Tab" />.
|
||||
|
||||
### Navigation
|
||||
|
||||
| **Action** | **Shortcut** |
|
||||
| ------------------------------------ | ------------------------------------------------ |
|
||||
| Go Back | <KeyboardShortcut shortcut="Alt + ←" /> |
|
||||
| Go Forward | <KeyboardShortcut shortcut="Alt + →" /> |
|
||||
| Navigate Back (Alternative) | <KeyboardShortcut shortcut="Ctrl + [" /> |
|
||||
| Navigate Forward (Alternative) | <KeyboardShortcut shortcut="Ctrl + ]" /> |
|
||||
| Go Home | <KeyboardShortcut shortcut="Alt + Home" /> |
|
||||
| Reload Page | <KeyboardShortcut shortcut="Ctrl + R" /> |
|
||||
| Reload Page (Skip Current Cache) | <KeyboardShortcut shortcut="Shift + Ctrl + R" /> |
|
||||
| Go to History (Open History Sidebar) | <KeyboardShortcut shortcut="Ctrl + H" /> |
|
||||
| Open Private Browsing Window | <KeyboardShortcut shortcut="Shift + Ctrl + P" /> |
|
||||
|
||||
### Search & Find
|
||||
|
||||
| **Action** | **Shortcut** |
|
||||
| --------------------------------------- | ------------------------------------------------ |
|
||||
| Focus Search ^ | <KeyboardShortcut shortcut="Ctrl + K" /> |
|
||||
| Focus Search ^ (Alternative) | <KeyboardShortcut shortcut="Ctrl + J" /> |
|
||||
| Find on Page | <KeyboardShortcut shortcut="Ctrl + F" /> |
|
||||
| Find Again (Jump to Next Result) | <KeyboardShortcut shortcut="Ctrl + G" /> |
|
||||
| Find Previous (Jump to Previous Result) | <KeyboardShortcut shortcut="Shift + Ctrl + G" /> |
|
||||
|
||||
^ Focus Search shortcut will open your URL bar, shift focus and enable Search mode using your default search engine.
|
||||
|
||||
### Page Operations
|
||||
|
||||
| **Action** | **Shortcut** |
|
||||
| --------------------------------------- | ------------------------------------------------ |
|
||||
| Open Location (Current link in URL Bar) | <KeyboardShortcut shortcut="Ctrl + L" /> |
|
||||
| Open Location (Alternative) | <KeyboardShortcut shortcut="Alt + D" /> |
|
||||
| Save Page | <KeyboardShortcut shortcut="Ctrl + S" /> |
|
||||
| Print Page | <KeyboardShortcut shortcut="Ctrl + P" /> |
|
||||
| Toggle Reader Mode | <KeyboardShortcut shortcut="Alt + Ctrl + R" /> |
|
||||
| Toggle Picture-in-Picture | <KeyboardShortcut shortcut="Shift + Ctrl + ]" /> |
|
||||
| View Page Source | <KeyboardShortcut shortcut="Ctrl + U" /> |
|
||||
| View Page Info | <KeyboardShortcut shortcut="Ctrl + [" /> |
|
||||
|
||||
### History & Bookmarks
|
||||
|
||||
| **Action** | **Shortcut** |
|
||||
| -------------------------------- | ------------------------------------------------ |
|
||||
| Show All History | <KeyboardShortcut shortcut="Shift + Ctrl + H" /> |
|
||||
| Bookmark This Page | <KeyboardShortcut shortcut="Ctrl + D" /> |
|
||||
| Bookmark This Page (Alternative) | <KeyboardShortcut shortcut="Shift + Ctrl + D" /> |
|
||||
| Show Bookmarks Library | <KeyboardShortcut shortcut="Shift + Ctrl + O" /> |
|
||||
|
||||
### Media & Display
|
||||
|
||||
| **Action** | **Shortcut** |
|
||||
| --------------------- | ------------------------------------------------ |
|
||||
| Toggle Mute | <KeyboardShortcut shortcut="Ctrl + M" /> |
|
||||
| Zoom Out | <KeyboardShortcut shortcut="Ctrl + -" /> |
|
||||
| Zoom In | <KeyboardShortcut shortcut="Ctrl + +" /> |
|
||||
| Reset Zoom Level | <KeyboardShortcut shortcut="Ctrl + 0" /> |
|
||||
| Switch Text Direction | <KeyboardShortcut shortcut="Shift + Ctrl + X" /> |
|
||||
| Take Screenshot | <KeyboardShortcut shortcut="Shift + Ctrl + S" /> |
|
||||
|
||||
### Developer Tools
|
||||
|
||||
| **Action** | **Shortcut** |
|
||||
| ----------------------------- | ------------------------------------------------------ |
|
||||
| Toggle DevTools | <KeyboardShortcut shortcut="Shift + Ctrl + I" /> |
|
||||
| Toggle Browser Toolbox | <KeyboardShortcut shortcut="Alt + Shift + Ctrl + I" /> |
|
||||
| Toggle Browser Console | <KeyboardShortcut shortcut="Shift + Ctrl + J" /> |
|
||||
| Toggle Responsive Design Mode | <KeyboardShortcut shortcut="Shift + Ctrl + M" /> |
|
||||
| Toggle Inspector | <KeyboardShortcut shortcut="Shift + Ctrl + L" /> |
|
||||
| Toggle Web Console | <KeyboardShortcut shortcut="Shift + Ctrl + K" /> |
|
||||
| Toggle JavaScript Debugger | <KeyboardShortcut shortcut="Shift + Ctrl + Z" /> |
|
||||
| Toggle Network Monitor | <KeyboardShortcut shortcut="Shift + Ctrl + E" /> |
|
||||
| Toggle Style Editor | <KeyboardShortcut shortcut="Shift + F7" /> |
|
||||
| Toggle Performance | <KeyboardShortcut shortcut="Shift + F5" /> |
|
||||
| Toggle Storage | <KeyboardShortcut shortcut="Shift + F9" /> |
|
||||
| Toggle DOM | <KeyboardShortcut shortcut="Shift + Ctrl + W" /> |
|
||||
| Toggle Accessibility | <KeyboardShortcut shortcut="Shift + F12" /> |
|
||||
|
||||
### Zen Features
|
||||
|
||||
| **Action** | **Shortcut** |
|
||||
| ------------------------------ | ------------------------------------------------------ |
|
||||
| Copy Current URL as Markdown | <KeyboardShortcut shortcut="Alt + Shift + Ctrl + C" /> |
|
||||
| Copy Current URL | <KeyboardShortcut shortcut="Shift + Ctrl + C" /> |
|
||||
| Toggle Sidebar Width | <KeyboardShortcut shortcut="Alt + B" /> |
|
||||
| Reset Pinned Tab to Pinned URL | Not set by default |
|
||||
|
||||
### Other Features
|
||||
|
||||
| **Action** | **Shortcut** |
|
||||
| -------------------------- | ----------------------------------------------------- |
|
||||
| Open Downloads | <KeyboardShortcut shortcut="Shift + Ctrl + Y" /> |
|
||||
| Open Add-ons | <KeyboardShortcut shortcut="Shift + Ctrl + A" /> |
|
||||
| Open File | <KeyboardShortcut shortcut="Ctrl + O" /> |
|
||||
| Delete Key | <KeyboardShortcut shortcut="Delete" /> |
|
||||
| Enter Full Screen | <KeyboardShortcut shortcut="F11" /> |
|
||||
| Exit Full Screen | <KeyboardShortcut shortcut="F11" /> |
|
||||
| About Processes | <KeyboardShortcut shortcut="Shift + Escape" /> |
|
||||
| Show Bookmarks Sidebar | <KeyboardShortcut shortcut="Ctrl + B" /> |
|
||||
| Show Bookmarks Toolbar | <KeyboardShortcut shortcut="Shift + Ctrl + B" /> |
|
||||
| Stop Loading | <KeyboardShortcut shortcut="Escape" /> |
|
||||
| Toggle AI Chatbot Sidebar^ | <KeyboardShortcut shortcut="Alt + Ctrl + X" /> |
|
||||
| Toggle Firefox Sidebar | <KeyboardShortcut shortcut="Alt + Ctrl + Z" /> |
|
||||
| Show All Tabs | <KeyboardShortcut shortcut="Shift + Ctrl + Tab" /> |
|
||||
| Clear Browsing Data | <KeyboardShortcut shortcut="Shift + Ctrl + Delete" /> |
|
||||
| WR Capture Command | <KeyboardShortcut shortcut="Ctrl + #" /> |
|
||||
| Toggle WR Capture Sequence | <KeyboardShortcut shortcut="Ctrl + ^" /> |
|
||||
|
||||
---
|
||||
|
||||
Read more about default keyboard shortcuts in Firefox:
|
||||
[Keyboard shortcuts - Perform common Firefox tasks quickly | Firefox Help](https://support.mozilla.org/en-US/kb/keyboard-shortcuts-perform-firefox-tasks-quickly)
|
133
content/docs/user-manual/translate.mdx
Normal file
|
@ -0,0 +1,133 @@
|
|||
---
|
||||
title: Translations
|
||||
description: Translate webpages or text selections directly in Zen
|
||||
---
|
||||
|
||||
import { Callout } from 'fumadocs-ui/components/callout';
|
||||
|
||||
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.
|
||||
|
||||

|
||||
|
||||
<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**".
|
||||
|
||||

|
||||
|
||||
### 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.
|
||||
|
||||

|
||||
|
||||
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.
|
||||
|
||||

|
||||
|
||||
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.
|
||||
|
||||

|
||||
|
||||
#### What if I encounter a page with mixed languages or contents in multiple languages?
|
||||
|
||||
The translation feature primarily focuses on the main language of the webpage, so it might not handle pages with mixed languages or content in multiple languages optimally. You can translate specific part of the webpage that uses one language and do this multiple times for different parts to understand the webpage better.
|
||||
|
||||
## Customize Translation Settings
|
||||
|
||||
You can tailor your translation experience from two places: the translation panel pop-up and the "**Language & Appearance**" section in Settings.
|
||||
|
||||
### Apply settings from translation panel
|
||||
|
||||
1. Click the **Translate** button in your URL bar or click `Main Menu` button > "**Translate Page**" option to open the "**Translate this page?**" panel pop-up.
|
||||
2. Click the gear button on the top side of the panel to reveal translation options.
|
||||
|
||||

|
||||
|
||||
3. "**Always offer to translate**" checkbox will determine whether the translation panel will automatically popped up, and suggest you to translate when visiting sites outside your preferred languages.
|
||||
4. With "**Always translate...**" and "**Never translate...**" checkboxes, you can choose to automatically translate the whole webpages, or to never translate the webpages at all for a specific language.
|
||||
5. You can check "**Never translate this site**" so the translation will not be suggested nor processed after a specific website is loaded.
|
||||
6. To revert a change, simply reselect an option to uncheck it. The checkmark will dissapear, indicating that it's disabled.
|
||||
6. Selecting "**Manage languages**" will open `Settings` > `General` > `Language & Appearance` to reveal more settings regarding languages and translation features.
|
||||
|
||||
### Using Webpage Language Settings
|
||||
|
||||
Zen lets you set separate languages for displaying user interface (menu, messages, notifications) and webpages, accessible from `Settings` > `General` > `Language & Appearance` > `Language`.
|
||||
|
||||
Select "**Choose**" beside the "Choose your preferred language for displaying pages" text to open the Webpage Language Settings.
|
||||
|
||||

|
||||
|
||||
You can click **Select a language to add** to add more language to your preference and click **Add** to put it onto the options. 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
|
||||
|
||||
Below the Language section in Settings, the **Translations** section lets you:
|
||||
- Download languages for offline translations. Translation for all languages will weigh around 1.3 GB, meanwhile individual languages varies from 17-34 MB (for languages using regular Latin characters) to 59-116 MB (for languages that uses its own character set like Arabic, Japanese, Korean, Russian, or Traditional Chinese).
|
||||
- Add or remove languages on the "Always translate these languages" list to enable the translation process automatically.
|
||||
- Add or remove languages to the "Never translate these languages" list to prevent the translation process happen automatically.
|
||||
- Manage the "Never translate these sites" list. (Websites can be added to the list from the translation panel, as described above)
|
||||
|
||||

|
||||
|
||||
### Supported Languages
|
||||
|
||||
Here are the languages that currently supported for translating webpages 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
|
||||
|
||||
New languages are constantly added over time. You can learn further about the translation development process and language availability in [Mozilla/Translations](https://mozilla.github.io/translations/) website.
|
||||
|
||||
#### Report incorrect translations
|
||||
|
||||
You can help enhance translations in Zen and Firefox-based browsers by reporting inaccuracies to Mozilla through [this form](https://docs.google.com/forms/d/e/1FAIpQLSdoRWnsHX6vVnGIRyLi4Kl-p0GrmeVIioqWsTz3aVTRfLScng/viewform). Report translation errors by entering the source language, the target langauge, the original sentence and translated sentence. Optionally, you can also provide a rating of the translation and a correct translation.
|
||||
|
||||
---
|
||||
|
||||
Read more about translation feature in Firefox: [Firefox Translation | Firefox Help](https://support.mozilla.org/en-US/kb/website-translation)
|
BIN
public/assets/user-manual/shortcuts/edit-shortcut.mp4
Normal file
After Width: | Height: | Size: 671 KiB |
BIN
public/assets/user-manual/translations/translate-link-text.png
Normal file
After Width: | Height: | Size: 846 KiB |
BIN
public/assets/user-manual/translations/translate-options.png
Normal file
After Width: | Height: | Size: 825 KiB |
BIN
public/assets/user-manual/translations/translate-original.png
Normal file
After Width: | Height: | Size: 812 KiB |
BIN
public/assets/user-manual/translations/translate-panel.png
Normal file
After Width: | Height: | Size: 749 KiB |
BIN
public/assets/user-manual/translations/translate-selected.png
Normal file
After Width: | Height: | Size: 845 KiB |
BIN
public/assets/user-manual/translations/translate-selection.png
Normal file
After Width: | Height: | Size: 776 KiB |
After Width: | Height: | Size: 706 KiB |