Puret is a minimal pure translation library for translating database values for Rails 3.
Puret is quiet like model_translations github.com/janne/model_translations (and borrowed much of its code), but comes with generators to help you get started.
Puret does not create the translation model dynamically (like model_translations does) but creates the file via generator. Puret wants to leave out as much magic as possible and want to allow customizing every part of your application.
You need configure the puret gem inside your gemfile:
source 'http://gemcutter.org' gem 'puret'
You can also use the latest edge version by specifying the git repository:
gem 'puret', :git => 'git://github.com/jo/puret.git'
Do not forget to run
This is a walkthrough with all steps you need to setup puret translated attributes, including model and migration. You MUST also check out the Generators section below to help you start.
We're assuming here you want a Post model with some puret attributes, as outlined below:
class Post < ActiveRecord::Base puret :title, :description end
The pure translations are stored in a different translation model for every model you need translations for:
class PostTranslation < ActiveRecord::Base puret_for :post end
You now need to create a migration for the translations table:
create_table(:post_translations) do |t| t.references :post t.string :locale t.string :title t.text :description t.timestamps end add_index :post_translations, [:post_id, :locale], :unique => true
Now you are able to translate values for the attributes :title and :description per locale:
I18n.locale = :en post.title = 'Puret really rocks!' I18n.locale = :de post.title = 'Puret rockt wirklich!' I18n.locale = :en post.title #=> Puret really rocks! I18n.locale = :de post.title #=> Puret rockt wirklich!
If a translation is not available in your locale, puret looks
for an instance method called default_locale and the corresponding translation
for a class method called default_locale and the corresponding translation
for a translation in I18n.default_locale
In case a translation is not available in the default locale, puret uses the first locale it could find. That order is specified by creation time, so the first created translation will be returned.
Puret comes with some generators to help you with your daily job:
rails generate puret:model Post title:string description:text
will setup all the code above and more, either you already have a Post model or not. In the latter case the Post model will be created for you.
In case you already have a translated model and want to add some more puret attributes, just run the puret:attribute generator:
rails generate puret:attribute Post body:text
This will create the appropriate migration and configure your Post model to translate the new attribute body.
Keep it simple! Relax.
Read the Rdoc documentation at rdoc.info/projects/jo/puret.
If you discover any bugs or want to drop a line, feel free to create an issue on GitHub:
Copyright © 2010 Johannes Jörg Schmidt, TF, released under the MIT license