Ditto
Alex Terehov avatar
Written byAlex Terehov
Updated over a week ago

Dittois a tool for teams to manage their product text from design to production with a single source of truth.

Index

Supported content

Ditto integration supports Components only. Components in Ditto are text items that get synced across projects and allow teams to standardize and reuse text.

Projects are not supported.

Installation

Creating connection on Ditto

First, you'll need to create a connection on Ditto. To achieve that, openConnections tab in Account Settings, findLokalise, and clickOpen:

In the popup clickAdd connectionand then copy theAPI key:

Adding app on Lokalise

Open your project on Lokalise (please make sure to use theSoftware localizationproject type), clickAppsin the top menu, and findDittoin the list. Click on it:

Then clickInstall. Paste theAPI keyobtained from Ditto on the previous step and clickAuthorizeto finish installation:

Importing content from Ditto to Lokalise

Once you've installed the app on Lokalise, the list of available components from Ditto will be presented to you. The content synchronization should start immediately. To start it manually, clickRefresh.

On theReady for importview, choose one or more items and clickImport from Ditto:

You'll be presented with the following dialog:

Choose the languages to include in the import operation.

Tick theOverwrite existing keysoption if you want to update existing translation keys with any updates that happened on the Ditto content since the last import. Updated keys will return to theUnverifiedstatus.

If you want to useAutomations, you should import only the default language with theOverwrite existing keysoption enabled. An alternative is to import all the desired languages, but keeping theOverwrite existing keysoption disabled.

Importing will happen in the background, and once the operation is completed, you'll see the following notification. ClickView contentto navigate to theImportedview:

Reimporting updated content from Ditto to Lokalise

To import updated content from Ditto components, you can use theRefreshbutton to see the last update date, select the items to reimport, and click onReimport from Ditto:

Performing translations

Proceed to theproject editoron Lokalise and perform translations as usual. Here is a sample where the appropriatetagshave been linked to the inserted keys:

The following tags have been added automatically:

  • ditto— refers to the app itself.

  • Test group— the item's title that was imported from Ditto.

The key names are generated using group and component names separated with a dot (.) delimiter.

Exporting content from Lokalise to Ditto

一旦翻译了,你可以return to the Ditto app on Lokalise, and switch to theImportedview.

Choose one or more items and clickExport to Ditto:

You'll be presented with the following dialog:

Choose one or more languages and hitExport to Ditto.

The operation will be performed in the background, and you'll be notified once it is completed.

Did this answer your question?