Translator Plugin (multi-engine) for SublimeText 3 & 4
======================================================

**Version:** 3.3.3, **[Google] & [Bing] translate**, supported **194+** languages.


Thank you for using my package!
-------------------------------

💡 If you used **Inline Google Translate** Sublime Text package (no longer working), this plugin is intended as a replacement. Just setup the key bindings and configure the engine & language. If you just need to see translation without changing original text, you can set **show_popup** in settings.


🛠️ Configure
============

1. Set Source and Target Language, change insert/replace mode and translation engine:
   
   Preferences ➡️ Package Settings ➡️ Translator ➡️ Settings 
     {
       "engine": "google",           // "google", "bing", 'bingcn' for cn.bing.com, 'googlehk' for google.com.hk 
       "source_language": "",        // Leave empty for Auto detection
       "target_language": "en",      // ! Must be specified 
       "results_mode": "insert",     // "insert", "replace" or "to_buffer" 
       "show_popup": false,          // false or true 
       "replace_linebreaks": false,  // false or true 
       "linebreak_replacement": " ", // could be a space, comma, semicolon, etc
       "analysis_language": "en"     // Language for Text Analysis: "en", "uk"
     }

2. You can enable key bindings to use translation commands easier:
   
   Preferences ➡️ Package Settings ➡️ Translator ➡️ Key Bindings (remove //)
    [
      // {"keys": ["ctrl+alt+g"], "command": "translator"},
      // {"keys": ["ctrl+shift+alt+g"], "command": "translator_to"},  
      // {"keys": ["ctrl+alt+b"], "command": "translator_from_buffer"},  
      // {"keys": ["ctrl+alt+a"], "command": "translator_text_analysis"}  
    ]


🚀 Usage
========

Select text (or put cursor on a word to translate), then:

* select `Tools ➡️ Translator ➡️ Translate seclected text` 
*  or bind keys to use `Ctrl+Alt+G` 

💡 If you want to **check Readability**, select some text and run **Analyze text** command. 
You can do it in 3 ways:
- via binding and using hotkey **Ctrl+Alt+A** (⌘Cmd+Alt+A in OSX)
- via `Tools ➡️ Translator ➡️ Analyze text`
- via Command Pallet, Ctrl+Shift+P (⌘Cmd+Shift+P in OSX) > Analyze text
* to clear Analysis highlights use `Tools ➡️ Translator ➡️ Clear Analysis highlights`


💡 Tips
=======

If translation works not as you expected, check your language code:

* select Tools ➡️ Translator ➡️ `Print supported languages to console`
* press `Ctrl + ~` to see output errors/warnings in console

Support
=======

* Your issues, feedback and suggestions regarding Translator plugin are welcome, feel free to report [here](https://github.com/dmytrovoytko/SublimeText-Translate/issues).
* Feel free to fork and submit pull requests.

Author
======

* Made with ❤️ in Ukraine 🇺🇦 Dmytro Voytko

If you find Translator package helpful, please ⭐️star⭐️ my repo https://github.com/dmytrovoytko/SublimeText-Translate/ to help other people discover it 🙏