README.md
<span> </span> <span> </span> <span> </span> <span> </span> <span> </span> <span> </span>
Installing from the plugin repository within the IDE:
Installing manually:
Restart the IDE after installation.
Sign up for a translation service (optional)
Most translation services require user registration to access their services (such as OpenAI, DeepL, Youdao Translate, etc.). Therefore, you may need to create an account, obtain an Authentication Key, and then bind the Authentication Key within the plugin：<kbd>Preferences(Settings)</kbd> > <kbd> Tools</kbd> > <kbd> Translation</kbd> > <kbd>General</kbd> > <kbd>Translation Engine</kbd> > <kbd>Configure...</kbd>
Begin translating
<kbd>Select a text or hover the mouse over the text</kbd> > <kbd>Right-click</kbd> > <kbd>Translate</kbd>
Or use shortcuts for translation, as detailed in Actions.
Replace with Translation
Translate the target text and replace it. If the target language is English, the output has several formats: in camel case, with a word separator (when the output contains multiple words, the separator can be configured in the plugin configuration page: <kbd>Translation Settings</kbd> > <kbd>Replace with Translation</kbd> > <kbd>Separator</kbd>) and in the original format.
Instructions: <kbd>Select a text or hover the mouse over the text</kbd> > <kbd>Right-click</kbd> > <kbd>Replace with Translation</kbd> (Or use shortcuts for translation, as detailed in Actions).
Translate Documentation
Quick Documentation and Inline Documentation can be translated via the context menu or shortcuts (detailed in Actions).
<kbd>Translation Settings</kbd> > <kbd>Other</kbd> > <kbd>Automatically translate documentation</kbd>: When you check this option, the Quick Documentation will be automatically translated when you view it.
Switch engines
Click the engine widget in the status bar or use the shortcut <kbd>Ctrl</kbd> + <kbd>Shift</kbd> + <kbd>S</kbd> (macOS: <kbd>Control</kbd> + <kbd>Meta</kbd> + <kbd>Y</kbd>) to switch between the translation engine and the TTS engine quickly.
Show Translation Dialog...
Open the translation dialog, which appears by default on the toolbar. Default shortcut:
Translate
Extract words and translate them. If you have already selected a text, extract the words from the portion of the text you'd like to translate. Otherwise, words are extracted automatically from the maximum range (this extraction can be configured in Settings). This action is displayed by default in the editor's right-click context menu. Default shortcut:
Translate(Inclusive)
Extract words and translate them. Automatically extract and translate all words from a specific range, ignoring manually selected text. Default shortcut: (None)
Translate(Exclusive)
Extract words and translate them. Automatically extract the nearest single word, ignoring manually selected text. Default shortcut: (None)
Replace with Translation
Replace the text with translation. The word extraction method works the same as when translating. Default shortcut:
Translate Quick Documentation
Quickly display and translate the documentation of the symbol at the caret. When used in the Quick Documentation popup, you can toggle between the translated text and the original. Default shortcut:
Translate Inline Documentation
Translate the contents of the editor's inline documentation rendered view. Displayed by default in the context menu of the inline documentation view and available within the inline documentation view. Default shortcut: (None)
Batch Translate Inline Documentation
Batch translate all inline documentation in the editor. Displayed by default on the editor inspections widget toolbar and available in Reader mode. Default shortcut: (None)
Translate Text Component
Translate selected text in some text components (e.g. Quick Docs, popup hints, input boxes...). This does not support automatic word extraction. Default shortcut (same as translation shortcut):
Switch Engine
Quickly switch between translation engine and TTS engine. Default shortcut:
Word of the Day
Display the 'Word of the Day' dialog box. Default shortcut: (None)
Other
Translation dialog shortcuts:
Translation balloon shortcuts:
Quick Documentation window shortcuts:
If you have any questions, please ask here.
What should I do if there is a network error or the network connection times out?
A:
What should I do if the translated content appears garbled?
A: Garbled code generally appears when there is a lack of corresponding characters in the font. You can go to the Settings page of the plugin to modify the font in order to fix the garbled code (as shown below).
What if I can't save the application key?
A: You can try changing the way passwords are saved to In KeePass (<kbd>Settings</kbd> > <kbd>Appearance &
Behavior</kbd> > <kbd>System Settings</kbd> > <kbd>Passwords</kbd>). For more details:
What if the shortcuts don't work?
A: The shortcut keys are most likely not working because they are being used in other plugins or external applications. You can reset shortcut keys for the corresponding operations.
You can contribute and support this project by doing any of the following:
Star the project on GitHub
Give feedback
Commit PR
Contribute your ideas/suggestions
Share the plugin with your friends/colleagues
If you love this plugin, please consider donating. It will inspire me to continue development on the project:
<table> <thead align="center"> <tr> <th><a href="https://opencollective.com/translation-plugin" target="_blank">Open Collective</a></th> <th><a href="https://pay.weixin.qq.com/index.php/public/wechatpay_en" target="_blank">WeChat Pay</a></th> <th><a href="https://global.alipay.com" target="_blank">Alipay</a></th> </tr> </thead> <tr align="center"> <td> <a href="https://opencollective.com/translation-plugin/donate" target="_blank"> </a>
</td>
<td>
<a href="https://pay.weixin.qq.com/index.php/public/wechatpay_en" target="_blank">
</a>
</td>
<td>
<a href="https://global.alipay.com" target="_blank">
</a>
</td>
Note
After using Alipay/WeChat to pay for your donation, please provide your name/nickname and website by leaving a message or via email in the following format:
Name/Nickname [<website>][: message](website and message are optional.)Example:
Yii.Guxing <github.com/YiiGuxing>: I like the plugin!If you choose to send an email, please also provide the following information:
textDonation Amount: <amount> Payment Platform: Alipay/WeChat Pay Payment Number (last 5 digits): <number>Email address: [email protected] (click to send email)
The name, website and total donation amount you provide will be added to the donor list.
Thank you for your support!
The CDN acceleration and security protection for this project are sponsored by Tencent EdgeOne.
This project exists thanks to all the people who contribute. [Contribute]. <a href="https://github.com/YiiGuxing/TranslationPlugin/graphs/contributors"></a>
Become a financial contributor and help us sustain our community. [Contribute]
Thank you to all our backers! ❤️ [Become a backer]
<a href="https://opencollective.com/translation-plugin/donate" target="_blank"></a>
Support this project by becoming a sponsor! Your logo will show up here with a link to your website. [Become a sponsor]
<a href="https://opencollective.com/translation-plugin/organization/0/website" target="_blank"></a> <a href="https://opencollective.com/translation-plugin/organization/1/website" target="_blank"></a> <a href="https://opencollective.com/translation-plugin/organization/2/website" target="_blank"></a> <a href="https://opencollective.com/translation-plugin/organization/3/website" target="_blank"></a> <a href="https://opencollective.com/translation-plugin/organization/4/website" target="_blank"></a> <a href="https://opencollective.com/translation-plugin/organization/5/website" target="_blank"></a> <a href="https://opencollective.com/translation-plugin/organization/6/website" target="_blank"></a> <a href="https://opencollective.com/translation-plugin/organization/7/website" target="_blank"></a> <a href="https://opencollective.com/translation-plugin/organization/8/website" target="_blank"></a> <a href="https://opencollective.com/translation-plugin/organization/9/website" target="_blank"></a>
| Name | Website | Amount |
|---|---|---|
| 丿初音 | 475.00 CNY | |
| 剑平 | 120.00 CNY | |
| 山有扶苏 | github.com/fobgochod | 110.00 CNY |
| xudley | xudley.cn | 100.00 CNY |
| 朱振山 | 100.00 CNY | |
| 丁云波 | 100.00 CNY | |
| 逆行 | 100.00 CNY | |
| Kimmy | 100.00 CNY | |
| LiMingjun | 100.00 CNY | |
| DarknessTM | github.com/darknesstm | 100.00 CNY |