Jxck / vscode-deepl

DeepL for Visual Studio Code

Geek Repo:Geek Repo

Github PK Tool:Github PK Tool

vscode-deepl

Translate texts in more than 25 languages directly in your favourite code editor powered by DeepL. This extension provides all the necessary integrations to easily translate texts without leaving your code editor.

Features

The extension provides the following functionalities:

  • Translate selected text in more than 25 languages and replaces them directly
  • Automatically recognises the source language

The following commands are available to translate texts:

Command Keybinding Description
DeepL: Translate alt+t Translates the selected text into the last used target language
DeepL: Translate to ... alt+shift+t Asks for the target language and translates the selected text into the target language
DeepL: Translate from ... to ... alt+ctrl+shift+t Asks for source and target language and translates the selected text from the source language into the target language

The commands are accessible via the command pallette.

Commands

In addition, the context menu is extended and now includes the translation commands.

Menu

The currently selected target language is displayed in the status bar. By clicking the item you can change the target language.

Status Bar

Requirements

In order to use this extension, you need a DeepL API key. To get an API key, you need to create an account here. After you have created an account, you will find your API key here. You can store the API key via the following settings.

Extension Settings

This extension contributes the following settings:

  • deepl.apiKey: The key is used to authenticate with the DeepL API. See offical documentation
  • deepl.usePro: Whether to use the DeepL Pro API - check this option if you use the paid plan.

For this extension to work, the above settings must be made.

Optional settings:

  • deepl.formality: Whether the translated text should lean towards formal or informal language in certain languages.
  • deepl.splitSentences: Sets whether the translation engine should first split the input into sentences.
  • deepl.preserveFormatting: Sets whether the translation engine should respect the original formatting, even if it would usually correct some aspects.
  • deepl.tagHandling: Sets which kind of tags should be handled. Options currently available: 'xml'.
  • deepl.splittingTags: Comma-separated list of XML tags which always cause splits.
  • deepl.nonSplittingTags: Comma-separated list of XML tags which never split sentences.
  • deepl.ignoreTags: Comma-separated list of XML tags that indicate text not to be translated.

Disclaimer

This extension is not an official implementation of the DeepL API from DeepL itself! The author has no connection to DeepL.

Privacy Policy

The texts are translated via the online service of DeepL. Please take a look at their privacy policy.
Dont use this extension if you dont agree with their privacy policy!

Release Notes

1.0.4

  • Header authentication is now used instead of parameter authentication
  • Formality parameter is only applied for supported languages

1.0.3

Added more settings to use more deepl api parameters

1.0.2

Added more settings to use more deepl api parameters

1.0.1

Added extension logo

1.0.0

Initial release of vscode-deepl

MIT LICENSE

About

DeepL for Visual Studio Code

License:MIT License


Languages

Language:TypeScript 91.4%Language:Dockerfile 4.9%Language:JavaScript 3.8%