Sha256: 9398d19bb4aa85c3b8f08338fdac1180a0b30de979ba89b1bd5e51ca2d0b16a0

Contents?: true

Size: 1.52 KB

Versions: 8

Compression:

Stored size: 1.52 KB

Contents

# Using machine translations

For multilingual organizations, Decidim includes a way to integrate with amachine translation service. The aim of this integration is to provide machine translations for any user-generated content.

## Flow description

Every time a user creates or updates a translatable resource (that is, an instance of a resource that implements the `Decidim::TranslatableResource` concern), this workflow is triggered:

- A background job starts for the resource. This background job lists the fields that have been changed, and checks if any of the fields is considered translatable.
- For each translatable field that is changed, it lists the locales that need to be translated.
- For each combination field/locale a new job is fired.
- This job calls the machine translation service, which will handle how to translate that given text.

This workflow will only start if the machine translation service is configured in the installation, and the organization has the service enabled.

## Enabling the integration, installation-wise

This is an option in the Decidim initializer:

```ruby
config.enable_machine_translations = true
config.machine_translation_service = "MyApp::MyOwnTranslationService"
```

The class will need to be implemented, or reuse one from the community. Check the docs on how to implement a machine translation service.

## Enabling the integration, organization-wise

Each organization will be able to enable/disable machine translations if they want to. They can do that from the organization configuration.

Version data entries

8 entries across 8 versions & 1 rubygems

Version Path
decidim-0.23.6 docs/customization/machine_translations.md
decidim-0.23.5 docs/customization/machine_translations.md
decidim-0.23.4 docs/customization/machine_translations.md
decidim-0.23.3 docs/customization/machine_translations.md
decidim-0.23.2 docs/customization/machine_translations.md
decidim-0.23.1 docs/customization/machine_translations.md
decidim-0.23.1.rc1 docs/customization/machine_translations.md
decidim-0.23.0 docs/customization/machine_translations.md