[![npm][npm]][npm-url]
[![deps][deps]][deps-url]
[![test][test]][test-url]
[![coverage][cover]][cover-url]
[![chat][chat]][chat-url]

src="https://cdn.rawgit.com/webpack/media/e7485eb2/logo/icon.svg">

i18n Plugin

i18n (localization) plugin for Webpack.

Install

npm
``bash
npm i -D @zainulbr/i18n-webpack-plugin
`
yarn
`bash
yarn add -D @zainulbr/i18n-webpack-plugin
`

Usage

This plugin creates bundles with translations baked in. So you can serve the translated bundle to your clients.
Example:
`
console.log(__("Hello World"));
console.log(__("Missing Text"));
`
`
var path = require("path");
var I18nPlugin = require("@zainulbr/i18n-webpack-plugin");
var languages = {
"en": null,
"de": require("./de.json")
};
module.exports = Object.keys(languages).map(function(language) {
return {
name: language,
// mode: "development || "production",
entry: "./example",
output: {
path: path.join(__dirname, "dist"),
filename: language + ".output.js"
},
plugins: [
new I18nPlugin(
languages[language]
)
]
};
});
`

`
{
"Hello World": "Hallo Welt"
}
`
current example.
original example from un maintenance repo


Options

`
plugins: [
...
new I18nPlugin(languageConfig, optionsObj)
],
`
- optionsObj.functionName: the default value is __, you can change it to other function name.
- optionsObj.failOnMissing: the default value is false, which will show a warning message, if the mapping text cannot be found. If set to true, the message will be an error message.
- optionsObj.hideMessage: the default value is false, which will show the warning/error message. If set to true, the message will be hidden.
- optionsObj.nested: the default value is false. If set to true, the keys in languageConfig can be nested. This option is interpreted only if languageConfig` isn't a function.

Maintainers

src="https://avatars3.githubusercontent.com/u/166921?v=3&s=150"> Juho Vepsäläinen

src="https://avatars2.githubusercontent.com/u/8420490?v=3&s=150"> Joshua Wiens

src="https://avatars3.githubusercontent.com/u/533616?v=3&s=150"> Kees Kluskens

src="https://avatars3.githubusercontent.com/u/3408176?v=3&s=150"> Sean Larkin

[npm]: https://img.shields.io/npm/v/@zainulbr/i18n-webpack-plugin.svg
[npm-url]: https://www.npmjs.com/package/@zainulbr/i18n-webpack-plugin

[deps]: https://david-dm.org/zainulbr/i18n-webpack-plugin.svg
[deps-url]: https://david-dm.org/zainulbr/i18n-webpack-plugin

[chat]: https://img.shields.io/badge/gitter-webpack%2Fwebpack-brightgreen.svg
[chat-url]: https://gitter.im/webpack/webpack

[test]: http://img.shields.io/travis/zainulbr/i18n-webpack-plugin.svg
[test-url]: https://travis-ci.org/github/zainulbr/i18n-webpack-plugin

[cover]: https://codecov.io/gh/zainulbr/i18n-webpack-plugin/branch/master/graph/badge.svg
[cover-url]: https://codecov.io/gh/zainulbr/i18n-webpack-plugin