make-gettext - Makemessages with GNU Gettext
The perfect solution to compile your application with GNU Gettext.
Sometimes applications like PoEdit or EazyPo are not enought to extract all the messages from the source code. And using xgettext is not trivial and needs more than two commands.
This NodeJS Module tries to help you automate gettext tasks for your huge projects. It supports HTML, JavaScript and will support more if you request it.
It is based on makemessages from Django and it allows you also to convert the result to JSON or CSV.
If you want to send the PO file or CSV to your translators you can add the option --to-translate and it will generate a file with only the messages untranslated and fuzzy.
Also you can use the functions you need, like i18n() or translate(). Just add the keyword option and tell the module what function names has the messages to extract additionally to the defaults gettext functions.
The pot file will be deleted but you can keep it adding the --keep-pot option.
Soon this module will allow you get the messages inside blocks of html templates made with underscore, handlebars...
Have a nice Gettext experience.
Instalation
npm install -g make-gettext
Usage
As a library:
require('make-gettext')
As an executable:
make-gettext -l <locale> [options]
Options:
-h, --help output usage information
-V, --version output the version number
-l, --locale <file> write locale/s to translate
-d, --directory <path> directory to search for gettext text to add the pot file
-x, --exclude [excludes] directories to avoid in the search for gettext text to add the pot file
-p, --outputdir <path> output files will be placed in directory <path>
-k, --keyword [keywords] additional keywords to be looked for
-e, --extension [extensions] extensions files to apply gettext
--no-obsolete removes obsolete translated and untranslated messages from the final po file
--to-translate generates an additional po file to translate with fuzzy and empty messages
--to-json export the final po to json
--to-csv export the final po to csv
--keep-pot keep pot files after the build
Example:
node make-gettext -p lns -l es -d js -x js/libs
Gettext Documentation
GNU gettext utilities Download Gettext for Windows
TODO
- Messages inside blocks of html templates made with underscore, handlebars.
- Tag your HTML with translator functions.
- Support for lots of files to get texts: Currently there is an error "spawn ENAMETOOLONG" if you add a directory with hundreds of files. Because of that you must add the options to exclude directories and the searchable directory when you have your souce code not all the files. (Like libraries, styles and more...)
License
MIT