i18next-sync-fs-backend

This is a fork of the official i18next fs backend to be used node.js. It will load resources synchronously from filesystem. Right now it supports following filetypes:

• .json
• .json5
• .yml

⚠️ This is a fork of the official fs backend and works syncronously.

✨ Thanks to @arve0 for transferring the Github repo to me. His old code is available in legacy branch.

Getting started

Source can be loaded via npm.

$ npm install i18next-sync-fs-backend

Wiring up:

1import i18next from 'i18next';
2import Backend from 'i18next-sync-fs-backend';
3
4i18next
5  .use(Backend)
6  .init({
7    // This is necessary for this sync version
8    // of the backend to work:
9    initImmediate: false,
10    // ...i18next options
11  });
12
13// i18next is immediately ready:
14console.log(i18next.t('someKey'));

As with all modules you can either pass the constructor function (class) to the i18next.use or a concrete instance.

Backend Options

1{
2  // path where resources get loaded from
3  loadPath: '/locales/{{lng}}/{{ns}}.json',
4
5  // path to post missing resources
6  addPath: '/locales/{{lng}}/{{ns}}.missing.json',
7
8  // jsonIndent to use when storing json files
9  jsonIndent: 2
10}

hint {{lng}}, {{ns}} use the same prefix, suffix you define in interpolation for translations!!!

Options can be passed in:

preferred - by setting options.backend in i18next.init:

1import i18next from 'i18next';
2import Backend from 'i18next-sync-fs-backend';
3
4i18next
5  .use(Backend)
6  .init({
7    initImmediate: false,
8    backend: {
9      // Backend options here...
10    }
11  });

on construction:

1import Backend from 'i18next-sync-fs-backend';
2const backend = new Backend(null, options);

by calling init:

1import Backend from 'i18next-sync-fs-backend';
2const backend = new Backend();
3backend.init(options);