git-svn-id: http://redmine.rubyforge.org/svn/trunk@13 e93f8b46-1217-0410-a6f0-8f06a7374b81
This commit is contained in:
Jean-Philippe Lang
parent
310a0f924a
commit
5b47d7bfcc
|
|
@ -1,85 +0,0 @@
|
|||
= Localization Plugin for Rails
|
||||
|
||||
This plugin provides a simple, gettext-like method to
|
||||
provide localizations.
|
||||
|
||||
== Features
|
||||
|
||||
* Any number of languages or locales
|
||||
* Simple method to defines singluar/plural translations
|
||||
* Can use lambdas to provide Ruby-code based dynamic translations
|
||||
* Customizable for different instances of the application
|
||||
|
||||
== Usage
|
||||
|
||||
If the localization plugin is installed, it is used automatically.
|
||||
|
||||
You need to create a /lang dir in your RAILS_ROOT.
|
||||
|
||||
The recommended way to use it is to create files that are named
|
||||
like the languages you define in them (but you can put everything in
|
||||
one big file too.)
|
||||
|
||||
For instance-customizable strings, add overrides in files you
|
||||
put in /lang/custom.
|
||||
|
||||
=== Simple example:
|
||||
|
||||
Create a file /lang/translations.rb:
|
||||
|
||||
Localization.define('de') do |l|
|
||||
l.store 'yes', 'Ja'
|
||||
l.store 'no', 'Nein'
|
||||
end
|
||||
|
||||
Localization.define('fr') do |l|
|
||||
l.store 'yes', 'oui'
|
||||
l.store 'no', 'non'
|
||||
end
|
||||
|
||||
In your controller or application.rb:
|
||||
|
||||
Localization.lang = 'de' # or 'fr'
|
||||
|
||||
In your view:
|
||||
|
||||
<%=_ 'yes' %>
|
||||
<%=_ 'no' %>
|
||||
|
||||
Because the _ method is simply an extension to Object, you
|
||||
can use it anywhere (models/controllers/views/libs).
|
||||
|
||||
=== Extended example:
|
||||
|
||||
Create a file /lang/default.rb with following contents:
|
||||
|
||||
Localization.define do |l|
|
||||
l.store '(time)', lambda { |t| t.strftime('%I:%M%p') }
|
||||
end
|
||||
|
||||
Create a file /lang/de_DE.rb with following contents:
|
||||
|
||||
Localization.define('de_DE') do |l|
|
||||
l.store '%d entries', ['Ein Eintrag', '%d Einträge']
|
||||
l.store '(time)', lambda { |t| t.strftime('%H:%M') }
|
||||
end
|
||||
|
||||
In your controller or application.rb:
|
||||
|
||||
Localization.lang = 'de_DE'
|
||||
|
||||
In your view:
|
||||
|
||||
<%=_ '%d entries', 1 %> # singular variant is chosen
|
||||
<%=_ '%d entries', 4 %> # plural variant is chosen
|
||||
<%=_ '(time)', Time.now %> # call the block with a parameter
|
||||
|
||||
== Translation file guesstimation
|
||||
|
||||
You can generate a guesstimation of all strings needed to be
|
||||
translated in your views by first adding the _('blah') syntax
|
||||
everywhere and then calling:
|
||||
|
||||
puts Localization.generate_l10n_file
|
||||
|
||||
in the Rails console.
|
||||
|
|
@ -1,3 +0,0 @@
|
|||
require "#{directory}/lib/localization.rb"
|
||||
|
||||
Localization.load
|
||||
|
|
@ -1,57 +0,0 @@
|
|||
# Original Localization plugin for Rails can be found at:
|
||||
# http://mir.aculo.us/articles/2005/10/03/ruby-on-rails-i18n-revisited
|
||||
#
|
||||
# Slightly edited by Jean-Philippe Lang
|
||||
# - added @@langs and modified self.define method to maintain an array of available
|
||||
# langages with labels, eg. { 'en' => 'English, 'fr' => 'French }
|
||||
# - modified self.generate_l10n_file method to retrieve already translated strings
|
||||
#
|
||||
|
||||
module Localization
|
||||
mattr_accessor :lang, :langs
|
||||
|
||||
@@l10s = { :default => {} }
|
||||
@@lang = :default
|
||||
@@langs = {}
|
||||
|
||||
def self._(string_to_localize, *args)
|
||||
translated = @@l10s[@@lang][string_to_localize] || string_to_localize
|
||||
return translated.call(*args).to_s if translated.is_a? Proc
|
||||
if translated.is_a? Array
|
||||
translated = if translated.size == 3
|
||||
translated[args[0]==0 ? 0 : (args[0]>1 ? 2 : 1)]
|
||||
else
|
||||
translated[args[0]>1 ? 1 : 0]
|
||||
end
|
||||
end
|
||||
sprintf translated, *args
|
||||
end
|
||||
|
||||
def self.define(lang = :default, name = :default)
|
||||
@@l10s[lang] ||= {}
|
||||
@@langs[lang] = [ name ]
|
||||
yield @@l10s[lang]
|
||||
end
|
||||
|
||||
def self.load
|
||||
Dir.glob("#{RAILS_ROOT}/lang/*.rb"){ |t| require t }
|
||||
Dir.glob("#{RAILS_ROOT}/lang/custom/*.rb"){ |t| require t }
|
||||
end
|
||||
|
||||
# Generates a best-estimate l10n file from all views by
|
||||
# collecting calls to _() -- note: use the generated file only
|
||||
# as a start (this method is only guesstimating)
|
||||
def self.generate_l10n_file(lang)
|
||||
"Localization.define('en_US') do |l|\n" <<
|
||||
Dir.glob("#{RAILS_ROOT}/app/views/**/*.rhtml").collect do |f|
|
||||
["# #{f}"] << File.read(f).scan(/<%.*[^\w]_\s*[\(]+[\"\'](.*?)[\"\'][\)]+/)
|
||||
end.uniq.flatten.collect do |g|
|
||||
g.starts_with?('#') ? "\n #{g}" : " l.store '#{g}', '#{@@l10s[lang][g]}'"
|
||||
end.uniq.join("\n") << "\nend"
|
||||
end
|
||||
|
||||
end
|
||||
|
||||
class Object
|
||||
def _(*args); Localization._(*args); end
|
||||
end
|
||||
Loading…
Reference in New Issue