i18n-tools

Internationalization Tools
==========================

You can use this project as a stand alone global or as part of another project.

``
npm install -g i18n-tools
`
OR
`
npm install i18n-tools
`

Usage
-----

###Extract tokenized strings from handlebars templates to PO files.

i18n-tools-xgettext-hbs

`
i18n-tools-xgettext-hbs
--extension=*.hbs // the handlebars file extension
--views-dir=./test/lib/views // the handlebars template directory
--output-dir=./test/lang/en // the output directory for the PO file
--output-file=messages.po // the PO filename
--run
`

The handlebars template files have to be in the following structure to be extracted correctly

`
{{__ "Sign in"}}

{{count}} {{__n "country" "countries" count}}


`

* __: is for singlular tokens
* __n: is for pluralized tokens

###Convert PO files to JSON files

i18n-tools-po-to-json

`
i18n-tools-po-to-json
--filter=.*\.po // The regex PO file filter
--dir=./lang // The directory to scan for PO files
--run
`

This tool will look through all directories recursively from the passed --dir and look for --filter files. It will then attempt to convert them into valid JSON language files suitable for Jed.


###Extract and convert to JSON files

i18n-tools-xgettext-to-json

`
i18n-tools-xgettext-to-json
--extension=*.hbs // the handlebars file extension
--views-dir=./test/lib/views // the handlebars template directory
--output-dir=./test/lang // the output directory for the PO file
--output-file=messages.po // the PO filename
--locale=en // The default locale that is used when extracting the templates
--run
`

This will extract tokens from the handlebars templates to PO files and then convert them to JSON files in one step.


###Reverse String Generator
This is used primarily for testing your tokenisation efforts before you have your language files translated. This will reverse the primary PO file and produce a JSON language file to be consumed by your application.

i18n-tools-po-to-rv-json

`
i18n-tools-po-to-rv-json
--input-dir=test/lang/en
--output-dir=test/lang/rv
--run
``