Rosetta
Rosetta is a library for Rails that helps you identify the translations that are being used on your app pages. The library adds an expandable menu to each page that shows all phrases being used in the page along with additional info depending on the Repository used.
It is especially useful if you use the OneSky translation service since it gives you direct links to edit the translations on OneSky. This makes it easy for copy writers of your app to see the texts in context and edit the translations.
When using regular translations, it shows the file where translation is so you can more easily find and edit it.
Dependencies
Rosetta requires a Ruby version >= 2.3
Repositories
The phrases menu is different depending on the way you manage your translations. There are currently 2 repositories: Local (default) and OneSky
Local Repository
This is the default repository and shows translations managed manually via YML files. It shows the file where each translation is stored to be able to easily find it.
It requires no further configuration.
OneSky repository
Use this repository if you manage your translations using the OneSky translation service. It adds a link to each translations pointing to the edit page for that text in OneSky.
It requires 2 configuration options:
- subdomain
- project_id
Installation
Add this to your Gemfile:
gem 'rosetta', '~> 1.1'
and run the bundle install
command.
To generate the initializer file run rails g rosetta:install
Getting Started
1. Enable the library
By default, Rosetta is disabled. You need to explicitly enable it when desired. Usually that will depend on the current user making the request.
To enable it in a per-request basis add a before_action :enable_rosetta
to the desired controller and add an if
condition if necessary. Example:
before_action :enable_rosetta, if: ->() { current_user.admin? }
2. Render the menu where desired
In order to show the menu with the translations you need to indicate where you want to render it. Usually this will be in your application's layout. Add this at the end of the body of your layours/application.html.erb
:
<%= render rosetta_menu %>
Configuration
You can configure the library through the initializer.
Example:
Rosetta.setup do |config|
# OneSky repository config
config.repository = Rosetta::Repositories::Onesky.new
config.repository.project_id = ENV['ONESKY_PROJECT_ID']
config.repository.subdomain = ENV['ONESKY_SUBDOMAIN']
# Local repository config
config.repository = Rosetta::Repositories::Local
end
Development
When first developing, you need to run bundle install
.
Run the specs with rspec spec
.
Launch the dummy app with rails s
.
Credits
Rosetta is maintained and funded by MarsBased
The names and logos for MarsBased are trademarks of MarsBased.
License
The gem is available as open source under the terms of the MIT License.