Skip to content

Latest commit

 

History

History
274 lines (199 loc) · 6.83 KB

Readme.md

File metadata and controls

274 lines (199 loc) · 6.83 KB

Dev Translate

Translate your JSON i18 folders with:

  • CLI command
  • best file translator in the world
  • AI context

Features:

  • generate folder i18 structure
  • configure input language and desired output languages
  • provide input language and input language folder then devtranslate detects other locale folders and translates files in watch mode. You only need to manage files in one language of your choice
  • supports 30+ languages

This plugin is particularly useful for developers working with projects that have multiple language support and require seamless translation updates during development.

Installation

$ npm i @aexol/dev-translate

How it works

$ dev-translate translate

Interactive command will ask you for the paths and will create a .dev-translate.json config file for further use.

{
    "apiKey": "YOUR_API_KEY",
    "localeDir": "locales",
    "inputLanguageFolderName": "en",
    "inputLanguage": "ENUS"
}

Config will also include all the dev-translate available languages.

Then dev-translate CLI will translate all the json files from input Language and create files with same names in language folder.

For example if you have a folder ./locales/ with en , pl. de, fr, in and you choose en as an input language. Dev translate will automatically translate from en to all other langauges keeping the json file structure.

Predict translation cost

As translations consume tokens from API you can easily predict translation cost of your locale folder by running:

dev-translate predict

Cache

Dev-translate backend includes cache inside it so we don't need to implement local cache here

Clear Account cache

If you want to clear your cache not to reuse cached translations anymore:

dev-translate clear

Plugins

Options

Those options are parameters of options param of each plugin.

apiKey

  • Type: string
  • Description: The API key required for accessing the translation service. Obtain this key from your translation provider.

folderName

  • Type: string
  • Description: The name of the folder within your localeDir that contains the i18n JSON files of your input language. The plugin will monitor this folder for changes.

lang

  • Type: Languages
  • Description: Language code of the input language

localeDir

  • Type: string
  • Description: The directory path relative to the project root where the locale files are stored.

NextJS

@aexol/nextjs-plugin-dev-translate is a Vite plugin designed to automatically translate i18n JSON files while Vite is in watch mode.

Installation

To install the plugin, use either npm or yarn:

npm install @aexol/nextjs-plugin-dev-translate --save-dev

Importing the Plugin

In your Next.js configuration file (next.config.js or next.config.mjs), import and configure the plugin with the necessary options.

const { withDevTranslate } = await import('@aexol/nextjs-dev-translate-plugin');

/** @type {import('next').NextConfig} */
const nextConfig = {
    //...your config
};

/** @type {import('@aexol/nextjs-dev-translate-plugin').withDevTranslate} */
export default withDevTranslate(nextConfig, {
    apiKey: 'your-api-key',
    folderName: 'pl',
    lang: 'PL',
    localeDir: './src/app/i18n/locales',
});

Example

If your project has the following structure:

my-project/
│
├── src/
│   └── locales/
│       ├── pl
│       │   ├── home.json
│       │   └── auth.json
│       ├── en
│       │   ├── home.json
│       │   └── auth.json
│       └── de
│           ├── home.json
│           └── auth.json
│
└── nextjs.config.mjs

You would configure the plugin as follows:

const { withDevTranslate } = await import('@aexol/nextjs-dev-translate-plugin');
/** @type {import('next').NextConfig} */
const nextConfig = {
    //...your config
};

/** @type {import('@aexol/nextjs-dev-translate-plugin').withDevTranslate} */
export default withDevTranslate(nextConfig, {
    apiKey: 'your-api-key',
    folderName: 'pl',
    lang: 'PL',
    localeDir: './src/app/i18n/locales',
});

This will enable the plugin to automatically watch and translate the JSON files from the src/locales/pl folder to en and de folders

Vite

@aexol/vite-plugin-dev-translate is a Vite plugin designed to automatically translate i18n JSON files while Vite is in watch mode.

Installation

To install the plugin, you can use npm or yarn:

npm install @aexol/vite-plugin-dev-translate --save-dev

Importing the Plugin

In your vite.config.js or vite.config.ts file, import the plugin and configure it with the required options.

import { defineConfig } from 'vite';
import devTranslatePlugin from '@aexol/vite-plugin-dev-translate';

export default defineConfig({
  plugins: [
    devTranslatePlugin({
      apiKey: 'your-api-key-here',
      folderName: 'locales',
      lang: 'en-US',
      localeDir: 'src/locales'
    })
  ]
});

Example

If your project has the following structure:

my-project/
│
├── src/
│   └── locales/
│       ├── en
│       │   ├── home.json
│       │   └── auth.json
│       ├── fr
│       │   ├── home.json
│       │   └── auth.json
│       └── es
│           ├── home.json
│           └── auth.json
│
└── vite.config.ts

You would configure the plugin as follows:

import { defineConfig } from 'vite';
import devTranslatePlugin from '@aexol/vite-plugin-dev-translate';

export default defineConfig({
  plugins: [
    devTranslatePlugin({
      apiKey: 'your-api-key-here',
      folderName: 'en',
      lang: 'ENUS',
      localeDir: 'src/locales'
    })
  ]
});

This will enable the plugin to automatically watch and translate the JSON files from the src/locales/en folder to fr and es folders

License

This project is licensed under the MIT License.

Support

If you encounter issues or have questions, please feel free to reach out via the project's issue tracker on GitHub.

Beta

CLI is the part of beta stage of new dev-translate and it is not yet on https://devtranslate.app. Contact support at [email protected] for early access.

Test ground and development

Run

$ npm run build
$ cd packages/testground
$ npm run start

Roadmap

  • support XML files in CLI
  • support JSON files in CLI
  • support predictions
  • support cache clear
  • support NextJS
  • support Vite
  • support Astro provided via Vite
  • support SvelteKit provided via Vite
  • support Nuxt provided via Vite
  • support Angular
  • support Remix provided via Vite