ctrl+shift+p filters: :st2 :st3 :win :osx :linux
Browse

I18n Rails

by NicoSantangelo ST2/ST3

Sublime Text 2/3 package for Rails Internationalization

Details

  • 2 2014.09.18.22.15.23
    3 1.0.1
  • github.​com
  • github.​com
  • 2 years ago
  • 2 hours ago
  • 4 years ago

Installs

  • Total 2K
  • Win 273
  • OS X 988
  • Linux 783
Oct 17 Oct 16 Oct 15 Oct 14 Oct 13 Oct 12 Oct 11 Oct 10 Oct 9 Oct 8 Oct 7 Oct 6 Oct 5 Oct 4 Oct 3 Oct 2 Oct 1 Sep 30 Sep 29 Sep 28 Sep 27 Sep 26 Sep 25 Sep 24 Sep 23 Sep 22 Sep 21 Sep 20 Sep 19 Sep 18 Sep 17 Sep 16 Sep 15 Sep 14 Sep 13 Sep 12 Sep 11 Sep 10 Sep 9 Sep 8 Sep 7 Sep 6 Sep 5 Sep 4 Sep 3 Sep 2
Windows 0 0 0 0 0 0 0 0 0 0 0 0 1 0 0 1 0 0 0 0 0 0 0 0 0 1 0 1 0 0 0 1 1 1 0 1 0 0 0 0 0 0 0 0 0 1
OS X 0 1 0 0 0 1 0 0 0 1 0 1 1 0 0 2 0 0 0 1 1 0 2 0 0 0 2 0 3 6 0 0 1 4 1 1 0 0 0 0 2 1 0 0 0 1
Linux 0 1 0 0 0 0 0 0 2 1 0 0 1 1 2 1 0 1 0 1 1 1 0 0 0 1 0 0 3 2 0 1 1 2 2 0 0 1 0 1 0 0 0 0 0 0

Readme

Source
raw.​githubusercontent.​com

Sublime Text: I18n Rails

This package is aimed to help you create Rails Internationalization keys. The Sublime Text 2 version is no longer being updated with new features; you can still download it from Package Control or you can find it here.

Available commands

1. Checking keys

If you want to check which keys in the file are present in the *.yml files, you can open up a Rails view and run “I18n Rails: Toggle key highlighting”, resulting in something like this:

Each translation is looked up in the relative or absolute path (the same logic applied for adding the values). So, in the example:

  • .missing_key wasn't found on any *.yml file. Uses the “invalid” scope for the color.
  • .partial was found in some locales but no all (for example, only defined in en.yml but missing in es.yml). Uses the “string” scope for the color.
  • .full is correctly added. Uses the “comment” scope for the color.

2. Adding keys (readme)

To add a key, go to a Rails view, select the key you want to add a value to and run the command “I18n Rails: Add key”.

The package will display a prompt asking for the value in every language available, If the key value is found, the prompt will show it (so it can be edited easily). If you don't want to edit a locale, just skip it by pressing Esc.

The package supports relative and absolute routes, for example

<%# views/users/index.html.erb %>

<%= t('.hello') %>  <%# It will search in config/locales/views/users/*.yml (see note below) %>

<%# (...) %>

<%= t('some.other.key.bye') %> <%# It will search in config/locales/*.yml %>

Notes * If the package doesn't find the path (for example with .hello) it will default to config/locales/*.yml. * The package requires the root key (es:, en:, etc.) to be present to work.

Known “issue”

Because of the way PyYAML, the python yaml parser, dumps the loaded yaml files I can't ensure the file format after a value it's added using this command. I couldn't find a work around this, so I made an issue wich also contains an (unanswered) stackoverflow question.

I'm thinking of some way to improve this, but in the meantime if you want to help, any ideas are welcome or just fork away!

3. Go to YAML file

If you run “I18n Rails: Go to YAML file” selecting a key, you will be prompted with the files where the key might be defined, so you can access them quickly (as a tip, you can go back to the file you were editing with the sublime command jump_back, [“alt+-”“] by default).

If the translation is found, the quick panel will show it after the locale:

en.yml: With translation
    es.yml

Selecting keys

To select a key you can:

  1. Select the text (with or without quotes), for example, select this.key from <%= t 'this.key' %>.
  2. Place the cursor inside the quotes and run "I18n Rails: Add key”.

Settings

{
    "rejected_files": [],

    "valid_color_scope"  : "comment",
    "partial_color_scope": "string",
    "invalid_color_scope": "invalid",

    "reload_highlighted_keys_on_save": true
}

Rejected files

You can add to the array any file you want to skip in when you're running the adding or check commands. So for example, if you want to skip devise files:

{ "rejected_files": ["devise.es.yml", "devise.en.yml"] }

The settings are accesible from Menu -> Preferences -> Package settings -> I18nRails

Color scopes

If you'd like to customize the color used to hightlight each key, you can add an existing scope name to the settings, or define a new one in your colorscheme file (.tmTheme), for example:

{ "invalid_color_scope": "i18ninvalid" }
<dict>
  <key>name</key>
  <string>I18n invalid</string>
  <key>scope</key>
  <string>i18ninvalid</string>
  <key>settings</key>
  <dict>
    <key>background</key>
    <string>#FF0DFF</string>
    <key>fontStyle</key>
    <string></string>
    <key>foreground</key>
    <string>#E80C7A</string>
  </dict>
</dict>

You may have to restart sublime to see the changes.

Reload on save

If this setting is true, the highlighted keys will be updated on each save, so if anything changed it will be picked up changing the colors appropriately.

Right now to reload, you need to save the file with the highlighted keys, meaning that the keys wont change if the save is only made in (for example) the .yml file alone.

Shortcut Keys

Windows and Linux:

  • Add: ctrl+alt+i
  • Toggle: ctrl+alt+u
  • Go to file: ctrl+alt+y

OSX

  • Add: super+alt+i
  • Toggle: super+alt+u
  • Go to file: super+alt+y

Installation

This package is available in Package Control or you can clone the repo into your /Packages folder.

The package name is I18n Rails.

Roadmap

  • Command to “Go to yml file”.
  • Support custom color scopes.
  • Allow path filtering.

Copyright

Copyright © 2013+ Nicolás Santángelo.

See LICENSE for details.