matta-globalite 0.5.0

data/lang/rails/zh-TW.yml

@@ -0,0 +1,357 @@
+locale_name: 台灣 (Taiwan)
+# ActiveRecord::Errors.default_error_messages
+error_message_inclusion: 不在指定的名單上
+error_message_exclusion: 已在指定的名單上
+error_message_invalid: 是錯誤的資料
+error_message_confirmation: 與指定值不同
+error_message_accepted: 必須要選擇接受指定的條款
+error_message_empty: 不能不填
+error_message_blank: 不能是空白
+error_message_too_long: 太長 (最多 %d 個字元)
+error_message_too_short: 太短 (最少 %d 個字元)
+error_message_wrong_length: 長度不正確 (應該要 %d 個字元)
+error_message_taken: 已經有人使用
+error_message_not_a_number: 不是數字
+
+# used by ActionView::Helpers::ActiveRecordHelper.error_messages_for
+active_record_helper_header_message: 輸入資訊錯誤
+active_record_helper_error_description: 請更正下列問題,
+
+# used by ActionView::Helpers::DateHelper.distance_of_time_in_words
+date_helper_less_than_x_seconds: 少於 %d 秒
+date_helper_half_a_minute: 30 秒
+date_helper_less_than_a_minute: 少於一分鐘
+date_helper_one_minute: 一分鐘
+date_helper_x_minutes: %d 分鐘
+date_helper_one_hour: 約 1 小時
+date_helper_x_hours: 約 %d 小時
+date_helper_one_day: 1 天
+date_helper_x_days: %d 天
+date_helper_one_month: 1 個月
+date_helper_x_months: %d 個月
+date_helper_one_year: 1 年
+date_helper_x_years: %d 年
+
+# DON'T TRANSLATE, just order
+date_helper_order: [:day, :month, :year] #default Rails is US ordered: :order => [:year, :month, :day]
+
+date_helper_date_formats: # DON'T  TRANSLATE, RE ORDER
+  default: "%Y/%m/%d"
+  short: "%b %e"
+  long: "%b %e, %Y"
+
+date_helper_time_formats: # DON'T  TRANSLATE, RE ORDER
+  default: "%a, %Y %b %d %H:%M:%S %z"
+  short: "%b %d, %H:%M"
+  long: "%Y/%b/%d %H:%M"
+
+# added at the end of date if your date system doesn't use a 24 hours system
+date_helper_am: am
+date_helper_pm: pm
+
+# used by ActionView::Helpers::NumberHelper.number_to_currency
+number_helper_unit: "NT$"
+number_helper_separator: "." #unit separator (between integer part and fraction part)
+number_helper_delimiter: "," #delimiter between each group of thousands. Example: 1.234.567
+number_helper_order: [ unit, number ]
+#to support for instance French format, the order is different: Unit comes last (ex. "1.234,00 €")
+
+# use by +Array#to_sentence()+
+array_connector: '和'
+array_skip_last_comma: 'true'
+
+date_helper_month_names:
+ -              # Leave that line
+   -            # Leave that line
+ - 一月
+ - 二月
+ - 三月
+ - 四月
+ - 五月
+ - 六月
+ - 七月
+ - 八月
+ - 九月
+ - 十月
+ - 十一月
+ - 十二月
+
+date_helper_abbr_month_names:
+  -             # Leave that line
+    -           # Leave that line
+  - 1月
+  - 2月
+  - 3月
+  - 4月
+  - 5月
+  - 6月
+  - 7月
+  - 8月
+  - 9月
+  - 10月
+  - 11月
+  - 12月
+
+date_helper_day_names:
+  - 星期天
+  - 星期一
+  - 星期二
+  - 星期三
+  - 星期四
+  - 星期五
+  - 星期六
+
+date_helper_abbr_day_names:
+  - 周日
+  - 周一
+  - 周二
+  - 周三
+  - 周四
+  - 周五
+  - 周六
+
+countries_list:
+  - Afghanistan
+  - Albania
+  - Algeria
+  - American Samoa
+  - Andorra
+  - Angola
+  - Anguilla
+  - Antarctica
+  - Antigua And Barbuda
+  - Argentina
+  - Armenia
+  - Aruba
+  - Australia
+  - Austria
+  - Azerbaijan
+  - Bahamas
+  - Bahrain
+  - Bangladesh
+  - Barbados
+  - Belarus
+  - Belgium
+  - Belize
+  - Benin
+  - Bermuda
+  - Bhutan
+  - Bolivia
+  - Bosnia and Herzegowina
+  - Botswana
+  - Bouvet Island
+  - Brazil
+  - British Indian Ocean Territory
+  - Brunei Darussalam
+  - Bulgaria
+  - Burkina Faso
+  - Burma
+  - Burundi
+  - Cambodia
+  - Cameroon
+  - Canada
+  - Cape Verde
+  - Cayman Islands
+  - Central African Republic
+  - Chad
+  - Chile
+  - China
+  - Christmas Island
+  - Cocos (Keeling) Islands
+  - Colombia
+  - Comoros
+  - Congo
+  - Congo, the Democratic Republic of the
+  - Cook Islands
+  - Costa Rica
+  - Cote d'Ivoire
+  - Croatia
+  - Cuba
+  - Cyprus
+  - Czech Republic
+  - Denmark
+  - Djibouti
+  - Dominica
+  - Dominican Republic
+  - East Timor
+  - Ecuador
+  - Egypt
+  - El Salvador
+  - England
+  - Equatorial Guinea
+  - Eritrea
+  - Espana
+  - Estonia
+  - Ethiopia
+  - Falkland Islands
+  - Faroe Islands
+  - Fiji
+  - Finland
+  - France
+  - French Guiana
+  - French Polynesia
+  - French Southern Territories
+  - Gabon
+  - Gambia
+  - Georgia
+  - Germany
+  - Ghana
+  - Gibraltar
+  - Great Britain
+  - Greece
+  - Greenland
+  - Grenada
+  - Guadeloupe
+  - Guam
+  - Guatemala
+  - Guinea
+  - Guinea-Bissau
+  - Guyana
+  - Haiti
+  - Heard and Mc Donald Islands
+  - Honduras
+  - Hong Kong
+  - Hungary
+  - Iceland
+  - India
+  - Indonesia
+  - Ireland
+  - Israel
+  - Italy
+  - Iran
+  - Iraq
+  - Jamaica
+  - Japan
+  - Jordan
+  - Kazakhstan
+  - Kenya
+  - Kiribati
+  - Korea, Republic of
+  - Korea (South)
+  - Kuwait
+  - Kyrgyzstan
+  - Lao People's Democratic Republic
+  - Latvia
+  - Lebanon
+  - Lesotho
+  - Liberia
+  - Liechtenstein
+  - Lithuania
+  - Luxembourg
+  - Macau
+  - Macedonia
+  - Madagascar
+  - Malawi
+  - Malaysia
+  - Maldives
+  - Mali
+  - Malta
+  - Marshall Islands
+  - Martinique
+  - Mauritania
+  - Mauritius
+  - Mayotte
+  - Mexico
+  - Micronesia, Federated States of
+  - Moldova, Republic of
+  - Monaco
+  - Mongolia
+  - Montserrat
+  - Morocco
+  - Mozambique
+  - Myanmar
+  - Namibia
+  - Nauru
+  - Nepal
+  - Netherlands
+  - Netherlands Antilles
+  - New Caledonia
+  - New Zealand
+  - Nicaragua
+  - Niger
+  - Nigeria
+  - Niue
+  - Norfolk Island
+  - Northern Ireland
+  - Northern Mariana Islands
+  - Norway
+  - Oman
+  - Pakistan
+  - Palau
+  - Panama
+  - Papua New Guinea
+  - Paraguay
+  - Peru
+  - Philippines
+  - Pitcairn
+  - Poland
+  - Portugal
+  - Puerto Rico
+  - Qatar
+  - Reunion
+  - Romania
+  - Russia
+  - Rwanda
+  - Saint Kitts and Nevis
+  - Saint Lucia
+  - Saint Vincent and the Grenadines
+  - Samoa (Independent)
+  - San Marino
+  - Sao Tome and Principe
+  - Saudi Arabia
+  - Scotland
+  - Senegal
+  - Serbia and Montenegro
+  - Seychelles
+  - Sierra Leone
+  - Singapore
+  - Slovakia
+  - Slovenia
+  - Solomon Islands
+  - Somalia
+  - South Africa
+  - South Georgia and the South Sandwich Islands
+  - South Korea
+  - Spain
+  - Sri Lanka
+  - St. Helena
+  - St. Pierre and Miquelon
+  - Suriname
+  - Svalbard and Jan Mayen Islands
+  - Swaziland
+  - Sweden
+  - Switzerland
+  - Taiwan
+  - Tajikistan
+  - Tanzania
+  - Thailand
+  - Togo
+  - Tokelau
+  - Tonga
+  - Trinidad
+  - Trinidad and Tobago
+  - Tunisia
+  - Turkey
+  - Turkmenistan
+  - Turks and Caicos Islands
+  - Tuvalu
+  - Uganda
+  - Ukraine
+  - United Arab Emirates
+  - United Kingdom
+  - United States
+  - United States Minor Outlying Islands
+  - Uruguay
+  - Uzbekistan
+  - Vanuatu
+  - Vatican City State (Holy See)
+  - Venezuela
+  - Viet Nam
+  - Virgin Islands (British)
+  - Virgin Islands (U.S.)
+  - Wales
+  - Wallis and Futuna Islands
+  - Western Sahara
+  - Yemen
+  - Zambia
+  - Zimbabwe

data/lib/globalite.rb

@@ -0,0 +1,26 @@
+# Add support for localization keys
+require 'rails/core_ext'
+require 'globalite/l10n'
+require 'globalite/locale'
+Symbol.send :include, SymbolExtension
+
+module Globalite
+  extend L10n
+  def self.localize_rails
+    ActiveRecord::Errors.relocalize
+  end
+end
+
+# Localize Rails
+require 'rails/localization.rb'
+require 'rails/localized_action_view'
+require 'rails/localized_active_record'
+
+# added Boolean function to 'boolean' a string
+module Kernel
+  def Boolean(string)
+    return true if string == true || string =~ /^true$/i
+    return false if string == false || string.nil? || string =~ /^false$/i
+    raise ArgumentError.new("invalid value for Boolean: \"#{string}\"")
+  end
+end

data/lib/globalite/l10n.rb

@@ -0,0 +1,300 @@
+module Globalite 
+
+  module L10n
+    
+    @@default_language = :en
+    attr_reader :default_language
+
+    @@default_country = :*
+    mattr_reader :default_country
+
+    @@reserved_keys = [ :limit ]
+    mattr_reader :reserved_keys
+
+    @@languages = []
+    def languages
+      @@languages
+    end
+
+    def default_language
+      @@default_language
+    end
+
+    @@countries = []
+    def countries
+      @@countries
+    end
+
+    @@locales = {}
+    def locales
+      @@locales.keys
+    end
+
+    @@rails_locales = {}
+    def rails_locales
+      @@rails_locales
+    end
+
+    @@ui_locales = {}
+    def ui_locales
+      @@ui_locales
+    end
+
+    @@current_language = nil
+    def current_language
+      @@current_language || default_language
+    end
+    alias :language :current_language
+
+    @@current_country = nil
+    def country
+      @@current_country || default_country
+    end
+    alias :current_country :country 
+
+    def current_locale
+      "#{current_language}-#{current_country}".to_sym
+    end
+    alias :locale :current_locale
+
+    # Set the current language ( ISO 639-1 language code in lowercase letters)
+    # Usage:
+    # Globalite.language = 'fr' or Globalite.language = :Fr
+    # Will save the current language code if available, otherwise nada, switching back to the previous language
+    #
+    def language=(language)
+
+      language = language.to_s.downcase.to_sym if language.class == Symbol
+      language = language.downcase.to_sym if language.class == String && !language.empty?
+
+      if @@languages.include?(language)
+        @@current_language = language
+        if !@@locales.include?("#{language}-#{@@current_country}".to_sym)
+          @@current_country = :*
+        end
+      end
+
+      #Locale.update_session_locale
+      localize_rails
+      @@current_language
+    end
+    alias :current_language= :language= 
+
+    # Set the current country code (ISO 3166 country code in uppercase letters)
+    # Usage:
+    # Globalite.country = 'US' or Globalite.country = :fr
+    # Will store the current country code if supported 
+    # Will try to automatically find the language for your country
+    # If the country isn't unknown to the system, the country will be set as :*
+    #
+    def country=(country)
+      load_localization! if defined? RAILS_ENV && RAILS_ENV == 'development'
+      country = country.to_s.upcase.to_sym if country.class == Symbol
+      country = country.upcase.to_sym if country.class == String && !country.empty?
+
+      if @@locales.include?("#{current_language}-#{country}".to_sym)
+        @@current_country = country
+      elsif locales.each {|locale| locale =~ /[a-z][a-z]-#{country.to_s}/ }
+        locales.each do |key| 
+          if key.to_s.include?(country.to_s)  
+            @new_language = key.to_s.split('-')[0].downcase.to_sym
+          end
+        end
+        if @new_language && @@locales.include?("#{@new_language}-#{country}".to_sym)
+          @@current_language = @new_language 
+          @@current_country = country 
+        end
+      else  
+        @@current_country = :*
+      end
+      #Locale.update_session_locale
+      @@current_country
+    end
+    alias :current_country= :country=
+
+    def locale=(locale)
+      Locale.set_code(locale)
+    end
+    alias :current_locale= :locale=
+
+    @@localization_sources = []
+    def add_localization_source(path)
+      @@localization_sources << path
+      load_localization!
+    end
+
+    def localization_sources
+      @@localization_sources
+    end
+
+    # List localizations for the current locale
+    def localizations 
+      @@locales[Locale.code] || {} 
+    end
+
+    # Return the translation for the key, a string can be passed to replaced a missing translation
+    def localize(key, error_msg='__localization_missing__', args={}, locale=nil)
+      return if reserved_keys.include? key
+
+      # Set a temporary Locale to support the localized_in method
+      #
+      unless locale.nil?
+        @original_locale = Locale.code
+        Locale.set_code(locale)
+      end
+      localized = localizations[key] || error_msg
+      # Get translations from another country but in the same language if Globalite can't find a translation for my locale
+      #
+      if localized == error_msg
+        locales.each do |t_locale|  
+          if t_locale.to_s.include?("#{current_language.to_s}-") && t_locale != Locale.code
+            localized =  @@locales[t_locale][key] || error_msg
+          end  
+        end
+      end  
+      localized = interpolate_string(localized.dup, args.dup) if localized.class == String && localized != error_msg
+      
+      # let's handle pluralization if needed
+      # the translation must include pluralize{count, singular string} to be translated
+      # the translator can also pass the plural form if needed:
+      #    pluralize{3, goose, geese}
+      localized = localized.gsub( /pluralize\{(.*)\}/){ |erb| pluralize(Regexp.last_match(1)) } if localized.is_a?(String) && (localized=~ /pluralize\{(.*)\}/)
+      
+      # Set the locale back to normal
+      #
+      unless locale.nil?
+        Locale.code = @original_locale
+      end
+            
+      return localized
+    end
+    alias :loc :localize
+
+    def localize_with_args(key, args={})
+      localize(key, '_localization missing_', args)
+    end
+    alias :l_with_args :localize_with_args
+
+    def add_reserved_key(*key)
+      (@@reserved_keys += key.flatten).uniq!
+    end
+    alias :add_reserved_keys :add_reserved_key
+
+    # modified version of the Rails pluralize method from ActionView::Helpers::TextHelper module
+    # TODO: load custom inflector based on the language one uses.
+    def pluralize(l_string) #count, singular, plural = nil)
+      # map the arguments like in the original pluralize method
+      count, singular, plural = l_string.split(',').map{ |arg| arg.strip}
+      
+       "#{count} " + if count == 1 || count == '1'
+        singular
+      elsif plural
+        plural
+      elsif Object.const_defined?("Inflector")
+        Inflector.pluralize(singular)
+      else
+        singular + "s"
+      end
+    end
+    
+    def reset_l10n_data
+      @@languages = []
+      @@countries = []
+      @@locales = {}
+      @@rails_locales = {}
+      @@ui_locales = {}
+    end
+
+    # Loads ALL the UI localization in memory, I might want to refactor this later on. 
+    # (can be hard on the memory if you load 25 languages with 900 entries each)
+    def load_localization!
+      reset_l10n_data
+
+      # Load the rails localization
+      if rails_localization_files
+        rails_localization_files.each do |file|
+          lang = File.basename(file, '.*')[0,2].downcase.to_sym
+          # if a country is defined
+          if File.basename(file, '.*')[3,5]
+            country = File.basename(file, '.*')[3,5].upcase.to_sym
+            @@countries <<  country if ( country != :* && !@@countries.include?(country) )
+            if locales.include?("#{lang}-#{country}".to_sym)
+              @@locales["#{lang}-#{country}".to_sym].merge(YAML.load_file(file).symbolize_keys)
+            else
+              @@locales["#{lang}-#{country}".to_sym] = YAML.load_file(file).symbolize_keys
+              @@rails_locales[locale_name("#{lang}-#{country}")] = "#{lang}-#{country}".to_sym
+            end
+            @@languages << lang unless @@languages.include? lang
+          else
+            @@languages << lang unless @@languages.include? lang 
+            @f_locale = "#{lang}-*".to_sym
+            @@locales[@f_locale] = @@locales[@f_locale].merge(YAML.load_file(file).symbolize_keys) if locales.include?(@f_locale)
+            @@locales[@f_locale] = YAML.load_file(file).symbolize_keys unless locales.include?(@f_locale)
+          end
+        end
+      end
+      alias :load_translations! :load_localization!
+      alias :load_localizations! :load_localization!
+      
+      # Load the UI localization
+      if ui_localization_files
+        ui_localization_files.each do |file| 
+          lang = File.basename(file, '.*')[0,2].downcase.to_sym
+          if File.basename(file, '.*')[3,5]
+            country = File.basename(file, '.*')[3,5].upcase.to_sym
+          else
+            country = '*'.to_sym
+          end
+          @@languages << lang unless @@languages.include? lang
+          @@countries <<  country if ( country != :* && !@@countries.include?(country) )
+          @file_locale = "#{lang}-#{country}".to_sym
+          if locales.include?(@file_locale)
+            @@locales[@file_locale] = @@locales[@file_locale].merge(YAML.load_file(file).symbolize_keys)
+            @@ui_locales[locale_name("#{lang}-#{country}")] = "#{lang}-#{country}".to_sym
+          else  
+            @@locales[@file_locale] = YAML.load_file(file).symbolize_keys
+            @@ui_locales[locale_name("#{lang}-#{country}")] = "#{lang}-#{country}".to_sym
+          end
+        end
+      end
+      localize_rails
+      # Return the path of the localization files
+      return "#{ui_localization_files} | #{rails_localization_files}".to_s
+    end
+
+    def locale_name(locale_code)
+      locale_code = locale_code.to_sym
+      if locales.include?(locale_code)
+        @@locales[locale_code][:locale_name] || nil
+      end
+    end
+
+    protected
+    # Return the list of UI files used by Globalite
+    def ui_localization_files
+      loc_files = Dir[File.join(RAILS_ROOT, 'lang/ui/', '*.{yml,yaml}')]
+      unless @@localization_sources.empty?
+        @@localization_sources.each do |path|
+          loc_files += Dir[File.join(path, '*.{yml,yaml}')]
+        end
+      end
+      loc_files
+    end
+
+    # Return a list of the Rails localization files
+    def rails_localization_files
+      loc_files = Dir[File.join( RAILS_ROOT, '/vendor/plugins/globalite/lang/rails/', '*.{yml,yaml}')]
+    end
+
+    # Interpolate a string using the passed arguments
+    def interpolate_string(string, args={})
+      if args.length > 0
+        args.each do |arg|
+          string = string.gsub("{#{arg[0].to_s}}", arg[1].to_s)
+        end
+      end
+      string
+    end
+
+  end
+end