Haml::I18n::Extractor

Extract strings likely to be translated from haml templates for I18n translation. Replace the text, create yaml files, do all things you thought macros would solve, but didn't end up really saving THAT much time. Automate that pain away.

Use it over and over again

It doesn't translate already translated keys, or things it identfies that are not text. What this means is that you can run this library/executable against the same haml file(s) after you've already translated stuff, and it will only look at things you really need and not any prior stuff. Pretty great. Try it, and see.

Usage

You can use the binary which is an interactive prompting mode included in this library, or just use the code directly. See below for more examples.

Examples

Per file basis. You can use the lib directly in your code, as such:


begin
  @ex1 = Haml::I18n::Extractor.new(haml_path)
  @ex1.run
rescue Haml::I18n::Extractor::InvalidSyntax
  puts "There was an error with #{haml_path}"
end

Per-project basis, with the binary. See demo below for usage of the binary.

cd your-rails-app-to-translate && haml-i18n-extractor .

Demo using interactive mode

Check out the quite brief movie/swf file demo of this lib's executable in demo/ . You should be able to see it online here, considering your browser supports swf:

Demo

Things that have been added since recording demo:

A "tag" functionality, which enables you to tag a line you want to review for later, if you are unsure you want to replace it. It will create a list of /file/path:42 tags for you to go and revisit later.
You can use "Next" if you're in the middle of processing a file and go to the next file.

Have any other ideas? Let me know or better yet, submit a pull request.

Example output

This should be a before and after picture of using this lib, whether using the interactive mode or plain ruby.

Before running (old haml):


  shai@comp ~/p/project master $ cat app/views/admin/notifications/index.html.haml
  h1 Consumer Notifications

  .nav= will_paginate(@consumer_notifications)
  table.themed{cellspacing: 0}
    thead
      tr
        th.first Type
        th Identifier
        th Data
        th Success
        th Reported To
    - @consumer_notifications.each do |cn|
      tr
        td.type= cn.notification.type
        td.identifier= cn.notification.identifier
        td.data= cn.notification.data
        td.success= cn.success
        td.reported_to= cn.reported_to
  .nav= will_paginate(@consumer_notifications)

After running (new haml, new yaml):

Note how some of the strings are replaced, and the ones that shouldn't, aren't. Yup. Beautiful, for 2 and half seconds of work, right?

Haml:


  shai@comp ~/p/project master $ cat app/views/admin/notifications/index.html.i18n-extractor.haml 
  h1= t('.consumer_notifications')

  .nav= will_paginate(@consumer_notifications)
  table.themed{cellspacing: 0}
    thead
      tr
        th.first= t('.type')
        th= t('.identifier')
        th= t('.data')
        th= t('.success')
        th= t('.reported_to')
    - @consumer_notifications.each do |cn|
      tr
        td.type= cn.notification.type
        td.identifier= cn.notification.identifier
        td.data= cn.notification.data
        td.success= cn.success
        td.reported_to= cn.reported_to
  .nav= will_paginate(@consumer_notifications)

Yaml:


  shai@comp ~/p/project master $ cat config/locales/en.yml
  ---
  en:
    notifications:
      consumer_notifications: Consumer Notifications
      type: Type
      identifier: Identifier
      data: Data
      success: Success
      reported_to: Reported To

Installation

gem install haml-i18n-extractor

If you want the latest code aka edge, you can also simply clone this repo and install the gem from the root of the repo:

gem uninstall -x haml-i18n-extractor; rm *gem; gem build *gemspec; gem install --local *gem

Feedback

Can use github issues to address any concern you have, or simply email me, with the contact info here: http://shairosenfeld.com/. You may find me on freenode #haml-i18n-extractor although I don't check it that often. Also on twitter you can find me with the same username as my GH one.

Contributing

Fork it
Create your feature branch (git checkout -b my-new-feature)
Commit your changes (git commit -am 'Added some feature')
Push to the branch (git push origin my-new-feature)
Create new Pull Request