Home

Awesome

Slimkeyfy

Extract plain Strings from .slim views and Rails controllers to replace them with I18n's t() method. Keys with it's translations will be streamed to a YAML file. Non english keys get translated with deepl translator gem ( you need to get your api first ).

Read more in this blog post: Phrase Blog: Make your Rails App localizable with Slimkeyfy

slimkeyfy app/views/users/show.html.slim en
# users/show.html.slim
h1 Hello World!
# converts to
h1= t('.hello_world')
# config/locales/users.en.yaml
# en:
#   user:
#     show:
#       hello_world: Hello World!

Install

With Ruby Gems

> gem install slimkeyfy

With Bundler

group :development do
  # Github
  # gem 'slimkeyfy', github: 'phrase/slimkeyfy'
  # or with concrete version
  gem 'slimkeyfy', '~> 0.1'
end

Approach

Most of the time tools like this go for a 80/20 approach stating that 80% can be done right and 20% have to be done manually. Our approach is similar but a bit different. Translating and tagging your Rails app can be error prone. In order to reduce this Slimkeyfy streams in every line that matches the regular expression engine and prompts you to take an action. This guarantees a higher quality but also gets us closer to the 90%. It might take a little more time than full automation. The collected data is then processed into a YAML file. If you don't provide a YAML one will be created. All your processed views and resulting translations will be merged with the existing YAML.

Usage

slimkeyfy INPUT_FILENAME_OR_DIRECTORY LOCALE (e.g. en, fr) [YAML_FILE] [Options]

I18n for keys addition

( from alekseyl translator branch: https://github.com/alekseyl/slimkeyfy/tree/translator ) I18n keys better be in english so if you start I18n from other than en locale you cannot use original slikeyfy approach, you need to translate keys first Two options added to CLI:

  '-t', '--translator-api-key [API_KEY]', 'API key for DeepL'
  '-l', '--keys-from-locale LOCALE', 'translate keys from locale'

API key can be given directly in CLI or added with export:

   export DEEPL_AUTH_KEY="DEEPL_AUTH_KEY_KEY"

How to get one: Go to https://www.deepl.com Get an account, check out the free API access (pro version will require Gem changes first - API endpoint for free version is hard coded)

Stream - walks through the given file/files and if a regex hits you will be prompted to apply (y)es, discard (n)o, tag (x) (comments suggestions above the processed line) or (a)bort (only aborts the current file).

without YAML file

slimkeyfy path/to/your/file.html.slim en

with given YAML file (has to be valid YAML! with the top level locale matching your provided locale)

slimkeyfy path/to/your/dir/ en path/to/your/en.yml

A Backup (.bak) of the old file will be created e.g. index.html.slim => index.html.slim.bak. Providing ---no-backup creates the backups temporarily and deletes them right after you apply your changes. (be careful!)

Example Usage

your_app_name/
  |- app/
    |- views/
      |- user/
        new.html.slim
        show.html.slim
      |- project/
        index.html.slim
        ...
    ...
  |- config/
    |- locales/
      en.yml
      ...
  ...

> pwd
../your_app_name/

> slimkeyfy app/views/users/ en
... choose your changes here (y/n/x/a)

> ls app/views/users/
    new.html.slim
    show.html.slim
    new.html.slim.bak
    show.html.slim.bak

> ls config/locales/
    user.en.yml
    en.yml

> cat ../users/new.html.slim.bak
  h1 Hello World!

> cat ../users/new.html.slim
  h1= t('.hello_world')

> cat config/locales/en.yml
  --
  en:
    keys..

> cat config/locales/users.en.yml
  ---
  en:
    users:
      new:
        hello_world: Hello World!
      show:
        ...

Suggested Workflow

As HTML is not 100% parsable there will be errors in the conversion. To minimize your error rate we suggest to approach each view or view_folder individually. The i18n-tasks gem helped a lot by finding errors. Always double check your views and make sure that everything went smoothly. Especially double check all your links. Here is an example workflow:

# 1. create a branch for a view folder
> git checkout -b users_localization

# 2. slimkeyfy the view folder you would like to tag
> slimkeyfy app/views/users/ en

# 3. go through all files and verify/add missing translations
# (check against the .bak files (use git diff))
> git diff app/views/users/views.html.slim

# 4. add your translations + keys to your locale file(s)
# 4.1 optional: Use the I18n-tasks gem to find missing translations

# 5. go through all your views and click through everything to actually "see" what changed

# 6. If everything is fine - clean up (remove .baks)
> rm app/views/users/*.bak
# Optional: remove temporary YAML files
> rm config/locales/users.en.yml

Testing

To test the application simply call rspec spec/.. from the root directory of slimkeyfy

bundle install
bundle exec rspec spec/

Phrase Integration

Now that you processed your views and moved the generated keys to your localization files it is quite easy to push it to Phrase. If you have not set up your account yet take a look here. You can use the Phrase Client to easily push your translations to Phrase.

Todo

Closed Todos

Issues

References

Get help / support

Please contact support@phrase.com and we can take more direct action toward finding a solution.