soerenuhrbach / vscode-deepl

DeepL for Visual Studio Code

Geek Repo:Geek Repo

Github PK Tool:Github PK Tool

Translate with DeepL for Visual Studio Code (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 to ... from ... alt+ctrl+shift+t Asks for source and target language and translates the selected text from the source language into the target language
DeepL: Translate and paste from clipboard ctrl+shift+v Translates the clipboard content and paste it
DeepL: Duplicate and translate ctrl+shift+d Duplicates and translates the selected text

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 will be asked to enter your api key, by using your first translation.

Extension Settings

This extension contributes the following settings:

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.
  • deepl.defaultTargetLanguage: Specifies the default target language the text should be translated to. The default target language will be overwriten by choosing a different language using the language chooser. (See all available target languages in the offical documentation)
  • deepl.defaultSourceLanguage: Specifies the default source language the text should be translated to. The default source language will be overwriten by choosing a different language using the language chooser. (See all available source languages in the offical documentation)
  • deepl.translationMode: Whether the selected text should be replaced with the translation result or inserted into a new line below/above

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

  • Added command "DeepL: Duplicate and translate" which duplicates and translates the selected text.

1.1.0

  • Removed the command "Translate to ... from ... below original text"
  • Added new configuration deepl.configuration to specify whether the selected text should be replaced with the translation result or inserted into a new line below/above
  • Added the command "Deepl: Translate and paste from clipboard" which allows to translate the clipboard content and paste it.
  • Show warning message if translation result equals the original text with actions to resolve this conflict.

1.0.14

  • Minor bug fixes

1.0.13

  • Add missing vscode command to configure the extension (f.e. the api key)

1.0.12

  • Use official 'deepl-node' package to interact with the DeepL api.
  • API keys will no longer be stored in the vscode configuration. They will be stored in the Secret Store to make sure, that the api key cant be accessed by 3rd party extensions.

1.0.11

1.0.10

1.0.9

  • Improved marketplace appearance

1.0.8

  • You no longer need to explicitly set "deepl.usePro" in the configuration to use the DeepL Pro API because its now determined based on the given api key
  • Added validation to avoid the usage of unsupported source / target languages

1.0.7

  • Added new configuration options "defaultTargetLanguage" and "defaultSourceLanguage" to set global default languages.

1.0.6

  • Added support for the "glossary_id" option

1.0.5

  • Added a debug log
  • Added new command 'DeepL: Translate below the original' to insert the translation a line below the original text.
  • Added tag handling for "html"
  • Bugs fixed

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 95.1%Language:Dockerfile 2.6%Language:JavaScript 2.1%Language:Shell 0.2%