Play! module for i18n
Python
Switch branches/tags
Nothing to show
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Permalink
Failed to load latest commit information.
.classpath
.gitignore
.project
README.md
commands.py

README.md

Play i18ntools module

This module will add some tools to ease use of i18n in your Play! projects.

Installation

Install the module : it's not yet in the Play! repository, so you have to copy it somewhere :

git clone git://github.com/naholyr/i18ntools.git

Then you have to enable it in your application.conf :

module.i18ntools=/path/to/i18ntools

Check that the module is well recognized with the command line :

play help

You should see i18n-extract in the list of available commands :)

Usage

i18n-extract

"i18n-extract" will parse your application's files to find internationalized strings, and add missing strings to your messages files.

What it will do :

  1. Find all the *.java files in your app directory, looking for Messages.get("...").
  2. Find all the files in your app/views directory, looking for &{'...' and messages.get('...') (double quotes work too, of course).
  3. In all your messages files (conf/messages + every conf/messages.LANG file, depending on your application.langs option), add all the previously found strings missing, with an empty translation.

What it won't do :

  • It won't smartly analyze your code, detect and resolve variables, or things like that.
  • It won't auto-translate your strings :)

To use it, launch "i18n-extract" command from your application's directory :

play i18n-extract

Sample output :

~        _            _
~  _ __ | | __ _ _  _| |
~ | '_ \| |/ _' | || |_|
~ |  __/|_|\____|\__ (_)
~ |_|            |__/
~
~ play! 1.1-beta2, http://www.playframework.org
~
~ Extracting i18n strings from Java files [Messages.get("...")] ...
~ Found 10 i18n string(s) in 30 Java file(s)...
~ Extracting i18n strings from templates [&{'...'...}] ...
~ Found 1 i18n string(s) in 12 view file(s)...
~ Found 11 i18n string(s) in your application, now let's fill up your messages files !
~ conf\messages : 11 string(s) added
~ conf\messages.fr : 0 string(s) added
~ conf\messages.en : 0 string(s) added