var i18n = require('i18n-abide');

app.use(i18n.abide({
  supported_languages: ['en-US', 'de', 'es', 'db-LB', 'it-CH'],
  default_lang: 'en-US',
  debug_lang: 'it-CH',
  translation_directory: 'i18n'
}));

This block sets up the middleware and views with gettext support. We declare support for English, German, Spanish, and two debug locales (more on this later).

In your routes, you can use the gettext function in .js files.

exports.homepage = function(req, resp) {
  resp.render('home', {title: req.gettext("Hey, careful, man, there's a beverage here!")});
};

In your layout files, you can add

<!DOCTYPE html>
<html lang="<%= lang %>" dir="<%= lang_dir %>">
  <head>
    <meta charset="utf-8">
    ...

In your templates files, you can use the gettext function in .ejs files:

<p><%= gettext("This will not stand, ya know, this aggression will not stand, man.") %></p>

i18n-abide also provides a format function for string interpolation.

This module provides both server side translations and client side translations. Server side works out of the box and is the most common use case.

If you also want to do client-side translations, i18n-abide provides lib/gettext.js and you can do the same in .js and .ejs files.

Setting Language via HTTP Header

The i18n-abide module uses the accept-language HTTP header to determine which language to use.

See API docs for overriding this via URL or the API directly.

Translation files

The i18n-abide module currently supports three file formats.

PO/POT files, which get transformed to JSON via provided command line tools.
PLIST (i.e., XML) files, which require no transformation prior to use.
Transifex JSON (JavaScript Object Notation) a key-value JSON type, which require no transformation prior to use.

PO/POT files

This is the default and assumed for documentation in this README.

PO files can be compiled to .json or Gettext binary .mo files.

For use on the client side, PO files are compiled to JavaScript for easy inclusion into your page or build script.

NOTE: The PO/POT files are also transformed into .JSON, but do not follow the same layout as the Transifex JSON files.

See GETTEXT.md for more details.

Other file formats

See API for configuration and details around using Plist or Transifex localization files.

Debugging and Testing

db-LB is a special debug locale. To trigger it, set your Browser or Operating System language to Italian (Switzerland) which is it-CH. This fake locale db-LB will be triggered, it is David Bowie speak for the region of Labyrinth.

Oh, hell ya a "The Dude" / Bowie Mashup. That just happened.

Now, start up your Node server and visit a page you've wrapped strings in Gettext...

Tutorial

Mozilla Hacks blog has a three part introduction.

Docs

See USAGE for full details.
API docs has more advanced config options and APIs
GETTEXT documents how to use PO/POT files

Keywords

FAQs

What is @gradeup/i18n-abide?

Is @gradeup/i18n-abide well maintained?

Package last updated on 29 Sep 2022

Did you know?

Socket for GitHub automatically highlights issues in each pull request and monitors the health of all your open source dependencies. Discover the contents of your packages and block harmful activity before you install or update your dependencies.

Install

@gradeup/i18n-abide

i18n-abide

Status

Supported Localization Technologies

Usage