Locale: Creating a Locale project with Storyblok

Introduction

The Storyblok connector from Locale allows you to quickly and easily translate content from your Storyblok instance for fast, reliable, and consistent translations across the locales your audience requires. The process of automating your content for translation can easily conform to nearly any pre-existing workflow your site content requires. These can include translation management systems (TMS), translation agency contacts (LPSs) or even machine translation engines(MT). Our goal with this connector is to aid in enabling lightening fast translations for your projects with the dedicated resources you trust most.


What you will need to get started

  1. The Login link for Locale.

  2. The login link for your Storyblok instance.

    1. Note: This is provided to you by your Storyblok account manager, support team, or contact person. If you are unsure of this information, please contact your system administrator or your Storyblok representative.

  3. User login information for both your Locale instance, and your Storyblok instance.

    1. A trial account of Locale can also be taken for free by going to locale.to and selecting the “Get Started” button.


Supported content types & limitations

Locale currently supports the translation of content field types for Text, Text Area, and partial support for Rich Text. Although Rich Text is partially supported, the formatting and images will not be included or may appear altered at the time of translation delivery. A current limitation is related to more complex structured field types such as rich text formatting and other nested content options.


Creating a project with Storyblok

In order to create a Locale project which connects to your Storyblok instance, you will first need to add the Storyblok connector to your Locale instance, and complete a few steps to configure the connector. For more information on this process, please see our article Locale: Configuring the Storyblok Connector. If you have already completed this process, please proceed with the steps below.

  1. Start by accessing Locale with your username and password.

  2. Once logged into Locale (instructions on that can be found here: Locale: Accessing your Locale instance), you are greeted with the Locale Dashboard, which looks something like this image below.

General Login 001.png
  1. The API information and Space ID information will be entered as shown in the previous article for configuration, and the next step will be to select the source and target languages for the project.

Storyblok Setup 003.png
  1. Once these languages have been selected, Locale will automatically start the analysis process and calculate the number of words and segments which will be sent for translation. This can be done according to your needs either via MT translation, LSP translation, or sent to a TMS for translation.