Translation

Translation config

First, you need to configure the translator in your terai.config.ts file. Terai provides integrations with some major translation service providers, or you can opt-in for configuring a custom translator. Also, you need to set up the locale targets for which you want to generate translations.

import { defineConfig, createGoogleCloudTranslator } from '@terai/dev'
 
const translator = createGoogleCloudTranslator({
  // your Google Cloud crendentials
})
 
export default defineConfig({
  outLocales: ['es-ES', 'ja-JP'],
  outDir: './locale',
  translator,
  // ...rest of options
})

In the above code snippet:

• Import necessary modules from @terai/dev.
• Use the createGoogleCloudTranslator function to set up the translator.
• Pass the translator to the Terai config.
• Define the target locales for which we want to generate translations.

Running extract

Before you can generate translations, you need to run the extract command to update all gathered messages from your project. This step ensures that Terai has a list of messages (dictionary) to translate.

pnpm terai extract

Running translate

Once your translator is configured and sources messages are extracted, you can easily manage translations by running the translate script. Terai will handle the translation process and generate the necessary translation files according to the specified config.

pnpm terai translate