Skip to content

Package for simplifying work with i18n in WebExtensions

Notifications You must be signed in to change notification settings

ivantsov/webext-i18n

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

19 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

webext-i18n

Build Status codecov npm version

This package simplifies work with i18n in WebExtensions.

Install

npm install webext-i18n --save-dev

Usage

For instance, you have the following structure:

src
└── locales
    ├── en.js
    └── de.js   

And en.js may contain something like that:

{
    popup: {
        title: 'Super title',
        description: 'Super description',
        buttons: {
            login: 'Login',
            remove: 'Remove account'
        }
    },
    contentScript: {
       action: 'Super action name',
       text: 'Lorem ipsum',
       items: [
           'First item',
           'Second item'
       ]
    }
}

Yeah, nested translation entities without specifying message field! And yes, it's not an appropriate format for WebExtensions, so you need to run the code below to generate a proper locales files:

const i18n = require('webext-i18n');

i18n({
    inputDir: './src/locales',
    outputDir: './dist/locales'
}).then(res => console.log('Generating locales is finished.');

It will create dist/locales directory with en.json and de.json files inside. And en.json looks like that:

{
    "popup_title": {
        "message": "Super title"
    },
    "popup_description": {
        "message": "Super description"
    },
    "popup_buttons_login": {
        "message": "Login"
    },
    "popup_buttons_remove": {
        "message": "Remove account"
    },
    "contentScript_action": {
        "message": "Super action name"
    },
    "contentScript_text": {
        "message": "Lorem ipsum"
    },
    "contentScript_items_0": {
        "message": "First item"
    },
    "contentScript_items_1": {
        "message": "Second item"
    }
}

API

The package contains only one method (the default export).

Options

  • inputDir - directory with locales.

  • outputDir - directory where generated files should be placed.

Returns a Promise that will be resolved when all locales are generated.