NAME

Jifty::I18N - Internationalization framework for Jifty

METHODS

_

This module exports the loc method, which it inherits from Locale::Maketext::Simple. Jifty aliases this method to _() for your convenience.

new

Set up Jifty's internationalization for your application. This pulls in Jifty's PO files, your PO files and then exports the _ function into the wider world.

refresh

Used by Jifty::Handler in DevelMode to reload .po files whenever they are modified on disk.

promote_encoding STRING [CONTENT-TYPE]

Return STRING promoted to our best-guess of an appropriate encoding. STRING should not have the UTF-8 flag set when passed in.

Optionally, you can pass a MIME content-type string as a second argument. If it contains a charset= parameter, we will use that encoding. Failing that, we use Encode::Guess to guess between UTF-8 and iso-latin-1. If that fails, and the string validates as UTF-8, we assume that. Finally, we fall back on returning the string as is.

maybe_decode_utf8 STRING

Attempt to decode STRING as UTF-8. If STRING is not valid UTF-8, or already contains wide characters, return it undecoded.

N.B: In an ideal world, we wouldn't need this function, since we would know whether any given piece of input is UTF-8. However, the world is not ideal.