babel-plugin-skyscanner-i18n

A Babel transform plugin to replace strings with their translations.

Usage no npm install needed!

<script type="module">
  import babelPluginSkyscannerI18n from 'https://cdn.skypack.dev/babel-plugin-skyscanner-i18n';
</script>

README

A Babel transform plugin to replace strings with their translations.

Example

.babelrc

{
    "plugins": [
        ["skyscanner-i18n", {
            "dictionary": {
                "Hello": "Bonjour",
                "Hello, {name}!": "Bonjour, {name}!"
            }
        }]
    ]
}

In

const name = 'Brad';
const hello = t('Hello');
const helloWithName = t('Hello, {name}!', {
    name
})

Out

const name = 'Brad';
const hello = 'Bonjour';
const helloWithName = 'Bonjour, ' + name + '!';

Installation

npm i -D babel-plugin-skyscanner-i18n

Usage

Via .babelrc

{
    "plugins": [
        ["skyscanner-i18n", {
            "functionName": "t",
            "dictionary": {}
        }]
    ]
}

Via Node API

require('babel-core').transform('code', {
    plugins: [
        ['skyscanner-i18n', {
            functionName: 't',
            dictionary: {}
        }]
    ]
});

Options

There are two options available, both are optional:

dictionary

A mapping of the strings passed to the translation function to their translated versions. If no dictionary is passed, calls to the translation function will be replaced with the original string.

functionName

The name of the function that wraps the strings. Defaults to t.

leftDelimiter, rightDelimiter

The delimiter to be used for templating. Defaults to { }.

delimiter

Shorthand for when both leftDelimiter and rightDelimiter are the same. Example: @@