DeepL provider for Strapi Translate Plugin

with this strapi translate plugin , you can translate all blocks JSONB paragraph text.

add { type: 'blocks', format: 'markdown' }, in the translate plugin transaltedFieldTypes as follow

translatedFieldTypes: [ 'string', { type: 'text', format: 'plain' }, { type: 'blocks', format: 'markdown' }, { type: 'richtext', format: 'markdown' }, 'component', 'dynamiczone', ],

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: 'deepljsonb',
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        apiOptions: {
20          // see <https://github.com/DeepLcom/deepl-node#text-translation-options> for supported options.
21          // note that tagHandling Mode cannot be set this way.
22          // use with caution, as non-default values may break translation of markdown
23          formality: 'default',
24          // ...
25        },
26      },
27      // other options ...
28    },
29  },
30  // ...
31}

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!