DeepL provider for Strapi Translate Plugin

Configure the provider through the pluginOptions:

1module.exports = {
2  // ...
3  translate: {
4    enabled: true,
5    config: {
6      // Choose one of the available providers
7      provider: 'deepl',
8      // Pass credentials and other options to the provider
9      providerOptions: {
10        // your API key - required and wil cause errors if not provided
11        apiKey: 'key',
12        // use custom api url - optional
13        apiUrl: 'https://api-free.deepl.com',
14        // use custom locale mapping (for example 'en' locale is deprecated so need to choose between 'EN-GB' and 'EN-US')
15        localeMap: {
16          // use uppercase here!
17          EN: 'EN-US',
18        },
19        // controls if placeholder text inside double curly brackets should be omitted from translation
20        omitPlaceholders: false,
21        apiOptions: {
22          // see <https://github.com/DeepLcom/deepl-node#text-translation-options> for supported options.
23          // note that tagHandling Mode cannot be set this way.
24          // use with caution, as non-default values may break translation of markdown
25          formality: 'default',
26          // ...
27        },
28      },
29      // other options ...
30    },
31  },
32  // ...
33}

or use the default environment variables:

• DEEPL_API_KEY - default undefined
• DEEPL_API_URL - default undefined

To get an API key, register for free at www.deepl.com/pro#developer.

Limitations:

• Only the deepl supported languages can be translated
• The API-Limits of DeepL (size, number of fields) and too many requests should be respected. If one field is larger than the request size limit, the content needs to be split and merged at some character, which may break the content layout!