Skip to main content

PyBabel handlebars gettext strings extractor

Project description

Release notes

  • 0.2.0 - Now only one nodejs process spawned for single babel run, so in total for big amount of files will work much faster.

  • 0.1.4 - minor bugfixes

  • 0.1.3 - Initial release

Installation

pip install pybabel-hbs

Usage

Add [hbs: path/**.hbs] to babel.cfg

Expected workflow

  1. Use helpers inside handlebar (gettext/ngettext as both regular and block heleprs supported)

  2. JS side should pass data to Jed wrapper (see client_side_usage)

  3. Jed wrapper passes the strings and parameters to Jed

  4. Jed instance translates string to language it was initiated with

  5. Jed uses po2json output (use po2json on generated .po files and then pass output to Jed)

  6. As for generating .po files just add [hbs: **.hbs] to babel config (babel.cfg), (considering extension installed via pip or via setup.py install)

  • Extension for babel to support handlebars.

  • Uses native Handlebars.js parsing with small hack for passing line numbers.

  • Since Handlebars.js is JS this babel extension requires node.js

Supported handlebars helpers:

  • _ (Undercore) helper

    {{_ "Some text to be translated %(param)s" param="some param"}}
  • n_ helper

    {{\n_ num_to_check_against "Some text to be translated with %(num)s" "Some plural text to be translated with %(num)s" num=num_to_check_against}}
  • trans block helper:

    {{#trans params_1="something"}}
        Some text to be translated with %(param_1)s
    {{/trans}}
  • ntrans block helper:

    {{#ntrans num_to_check_aganst param_1="something" num=num_to_check_against}}
        Some text to be translated with %(param_1)s and %(num)s
    {{else}}
        Some plural text to be translated with %(param_1)s and %(num)s
    {{/ntrans}}

Summarizing

  • Every helper can have params, they will be passed to sprintf (built-in into Jed)

  • n_ and ntrans helpers MUST have some integer as first parameter, it will determine if plural or singular form should be used

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

PyBabel-hbs-0.2.0.tar.gz (24.0 kB view hashes)

Uploaded Source

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page