# gettext.js

**Repository Path**: mirrors_adamchainz/gettext.js

## Basic Information

- **Project Name**: gettext.js
- **Description**: gettext in javascript for the browser, and a mo file compiler.
- **Primary Language**: Unknown
- **License**: BSD-3-Clause
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2020-09-24
- **Last Updated**: 2026-06-13

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

.. image:: https://travis-ci.org/ojii/gettext.js.svg?branch=master
    :target: https://travis-ci.org/ojii/gettext.js

.. image:: https://readthedocs.org/projects/gettextjs/badge/?version=latest
    :target: http://gettextjs.readthedocs.org/en/latest/?badge=latest
    :alt: Documentation Status

gettext.js
##########


GNU gettext in Javascript. Compile your mo files to JSON/JS and then use them
directly from Javascript in your browser.

Demo: https://cdn.rawgit.com/ojii/gettext.js/master/demo/index.html

Docs: http://gettextjs.readthedocs.org/

Usage
=====

Compiling
---------

.. code-block::

    Usage:
        gettextjs [-i] [-v] [--js] <locale-path> [<out-dir>]

    Options:
        -h --help       Show this screen.
        --version       Show version.
        -i --indent     Indent JSON file.
        -v --verbose    Print stuff while doing work.
        --js            Compile to JS instead of JSON.


Javascript
----------

Async from JSON
~~~~~~~~~~~~~~~

.. code-block::

    Gettext.load('/base/url/to/locale', 'en', 'messages').then(function(gettext){
        var msgstr = gettext.gettext('msgid');
    });

Sync from JS
~~~~~~~~~~~~

.. code-block::

    var gettext = new Gettext(EN_MESSAGES);
    var msgstr = gettext.gettext('msgid');