From 96f83cc8f0f032554f771a59da22303cd473b878 Mon Sep 17 00:00:00 2001 From: Jean-Philippe Lang Date: Tue, 5 Dec 2006 20:45:04 +0000 Subject: trunk moved from /trunk/redmine to /trunk git-svn-id: http://redmine.rubyforge.org/svn/trunk@67 e93f8b46-1217-0410-a6f0-8f06a7374b81 --- vendor/plugins/gloc-1.1.0/CHANGELOG | 19 + vendor/plugins/gloc-1.1.0/MIT-LICENSE | 19 + vendor/plugins/gloc-1.1.0/README | 208 ++++++ vendor/plugins/gloc-1.1.0/Rakefile | 15 + .../ActionController/Filters/ClassMethods.html | 230 ++++++ .../gloc-1.1.0/doc/classes/ActionMailer/Base.html | 140 ++++ .../gloc-1.1.0/doc/classes/ActionView/Base.html | 174 +++++ .../doc/classes/ActionView/Helpers/DateHelper.html | 348 +++++++++ .../classes/ActionView/Helpers/InstanceTag.html | 167 +++++ .../doc/classes/ActiveRecord/Errors.html | 215 ++++++ .../ActiveRecord/Validations/ClassMethods.html | 217 ++++++ vendor/plugins/gloc-1.1.0/doc/classes/GLoc.html | 774 +++++++++++++++++++++ .../gloc-1.1.0/doc/classes/GLoc/ClassMethods.html | 160 +++++ .../gloc-1.1.0/doc/classes/GLoc/Helpers.html | 323 +++++++++ .../doc/classes/GLoc/InstanceMethods.html | 364 ++++++++++ vendor/plugins/gloc-1.1.0/doc/created.rid | 1 + vendor/plugins/gloc-1.1.0/doc/files/CHANGELOG.html | 153 ++++ vendor/plugins/gloc-1.1.0/doc/files/README.html | 480 +++++++++++++ .../gloc-1.1.0/doc/files/lib/gloc-helpers_rb.html | 107 +++ .../gloc-1.1.0/doc/files/lib/gloc-internal_rb.html | 115 +++ .../doc/files/lib/gloc-rails-text_rb.html | 114 +++ .../gloc-1.1.0/doc/files/lib/gloc-rails_rb.html | 114 +++ .../gloc-1.1.0/doc/files/lib/gloc-ruby_rb.html | 107 +++ .../gloc-1.1.0/doc/files/lib/gloc-version_rb.html | 101 +++ .../plugins/gloc-1.1.0/doc/files/lib/gloc_rb.html | 116 +++ vendor/plugins/gloc-1.1.0/doc/fr_class_index.html | 37 + vendor/plugins/gloc-1.1.0/doc/fr_file_index.html | 35 + vendor/plugins/gloc-1.1.0/doc/fr_method_index.html | 72 ++ vendor/plugins/gloc-1.1.0/doc/index.html | 24 + vendor/plugins/gloc-1.1.0/doc/rdoc-style.css | 208 ++++++ vendor/plugins/gloc-1.1.0/init.rb | 11 + vendor/plugins/gloc-1.1.0/lib/gloc-config.rb | 16 + vendor/plugins/gloc-1.1.0/lib/gloc-dev.rb | 97 +++ vendor/plugins/gloc-1.1.0/lib/gloc-helpers.rb | 20 + vendor/plugins/gloc-1.1.0/lib/gloc-internal.rb | 134 ++++ vendor/plugins/gloc-1.1.0/lib/gloc-rails-text.rb | 137 ++++ vendor/plugins/gloc-1.1.0/lib/gloc-rails.rb | 230 ++++++ vendor/plugins/gloc-1.1.0/lib/gloc-ruby.rb | 7 + vendor/plugins/gloc-1.1.0/lib/gloc-version.rb | 12 + vendor/plugins/gloc-1.1.0/lib/gloc.rb | 294 ++++++++ vendor/plugins/gloc-1.1.0/tasks/gloc.rake | 30 + vendor/plugins/gloc-1.1.0/test/gloc_rails_test.rb | 118 ++++ vendor/plugins/gloc-1.1.0/test/gloc_test.rb | 433 ++++++++++++ vendor/plugins/gloc-1.1.0/test/lang/en.yaml | 2 + vendor/plugins/gloc-1.1.0/test/lang/en_AU.yaml | 2 + vendor/plugins/gloc-1.1.0/test/lang/ja.yml | 2 + vendor/plugins/gloc-1.1.0/test/lang2/en.yml | 2 + vendor/plugins/gloc-1.1.0/test/lang2/ja.yaml | 2 + .../gloc-1.1.0/test/lib/rails-string_ext.rb | 23 + .../plugins/gloc-1.1.0/test/lib/rails-time_ext.rb | 76 ++ 50 files changed, 6805 insertions(+) create mode 100644 vendor/plugins/gloc-1.1.0/CHANGELOG create mode 100644 vendor/plugins/gloc-1.1.0/MIT-LICENSE create mode 100644 vendor/plugins/gloc-1.1.0/README create mode 100644 vendor/plugins/gloc-1.1.0/Rakefile create mode 100644 vendor/plugins/gloc-1.1.0/doc/classes/ActionController/Filters/ClassMethods.html create mode 100644 vendor/plugins/gloc-1.1.0/doc/classes/ActionMailer/Base.html create mode 100644 vendor/plugins/gloc-1.1.0/doc/classes/ActionView/Base.html create mode 100644 vendor/plugins/gloc-1.1.0/doc/classes/ActionView/Helpers/DateHelper.html create mode 100644 vendor/plugins/gloc-1.1.0/doc/classes/ActionView/Helpers/InstanceTag.html create mode 100644 vendor/plugins/gloc-1.1.0/doc/classes/ActiveRecord/Errors.html create mode 100644 vendor/plugins/gloc-1.1.0/doc/classes/ActiveRecord/Validations/ClassMethods.html create mode 100644 vendor/plugins/gloc-1.1.0/doc/classes/GLoc.html create mode 100644 vendor/plugins/gloc-1.1.0/doc/classes/GLoc/ClassMethods.html create mode 100644 vendor/plugins/gloc-1.1.0/doc/classes/GLoc/Helpers.html create mode 100644 vendor/plugins/gloc-1.1.0/doc/classes/GLoc/InstanceMethods.html create mode 100644 vendor/plugins/gloc-1.1.0/doc/created.rid create mode 100644 vendor/plugins/gloc-1.1.0/doc/files/CHANGELOG.html create mode 100644 vendor/plugins/gloc-1.1.0/doc/files/README.html create mode 100644 vendor/plugins/gloc-1.1.0/doc/files/lib/gloc-helpers_rb.html create mode 100644 vendor/plugins/gloc-1.1.0/doc/files/lib/gloc-internal_rb.html create mode 100644 vendor/plugins/gloc-1.1.0/doc/files/lib/gloc-rails-text_rb.html create mode 100644 vendor/plugins/gloc-1.1.0/doc/files/lib/gloc-rails_rb.html create mode 100644 vendor/plugins/gloc-1.1.0/doc/files/lib/gloc-ruby_rb.html create mode 100644 vendor/plugins/gloc-1.1.0/doc/files/lib/gloc-version_rb.html create mode 100644 vendor/plugins/gloc-1.1.0/doc/files/lib/gloc_rb.html create mode 100644 vendor/plugins/gloc-1.1.0/doc/fr_class_index.html create mode 100644 vendor/plugins/gloc-1.1.0/doc/fr_file_index.html create mode 100644 vendor/plugins/gloc-1.1.0/doc/fr_method_index.html create mode 100644 vendor/plugins/gloc-1.1.0/doc/index.html create mode 100644 vendor/plugins/gloc-1.1.0/doc/rdoc-style.css create mode 100644 vendor/plugins/gloc-1.1.0/init.rb create mode 100644 vendor/plugins/gloc-1.1.0/lib/gloc-config.rb create mode 100644 vendor/plugins/gloc-1.1.0/lib/gloc-dev.rb create mode 100644 vendor/plugins/gloc-1.1.0/lib/gloc-helpers.rb create mode 100644 vendor/plugins/gloc-1.1.0/lib/gloc-internal.rb create mode 100644 vendor/plugins/gloc-1.1.0/lib/gloc-rails-text.rb create mode 100644 vendor/plugins/gloc-1.1.0/lib/gloc-rails.rb create mode 100644 vendor/plugins/gloc-1.1.0/lib/gloc-ruby.rb create mode 100644 vendor/plugins/gloc-1.1.0/lib/gloc-version.rb create mode 100644 vendor/plugins/gloc-1.1.0/lib/gloc.rb create mode 100644 vendor/plugins/gloc-1.1.0/tasks/gloc.rake create mode 100644 vendor/plugins/gloc-1.1.0/test/gloc_rails_test.rb create mode 100644 vendor/plugins/gloc-1.1.0/test/gloc_test.rb create mode 100644 vendor/plugins/gloc-1.1.0/test/lang/en.yaml create mode 100644 vendor/plugins/gloc-1.1.0/test/lang/en_AU.yaml create mode 100644 vendor/plugins/gloc-1.1.0/test/lang/ja.yml create mode 100644 vendor/plugins/gloc-1.1.0/test/lang2/en.yml create mode 100644 vendor/plugins/gloc-1.1.0/test/lang2/ja.yaml create mode 100644 vendor/plugins/gloc-1.1.0/test/lib/rails-string_ext.rb create mode 100644 vendor/plugins/gloc-1.1.0/test/lib/rails-time_ext.rb (limited to 'vendor/plugins/gloc-1.1.0') diff --git a/vendor/plugins/gloc-1.1.0/CHANGELOG b/vendor/plugins/gloc-1.1.0/CHANGELOG new file mode 100644 index 000000000..6392d7cbe --- /dev/null +++ b/vendor/plugins/gloc-1.1.0/CHANGELOG @@ -0,0 +1,19 @@ +== Version 1.1 (28 May 2006) + +* The charset for each and/or all languages can now be easily configured. +* Added a ActionController filter that auto-detects the client language. +* The rake task "sort" now merges lines that match 100%, and warns if duplicate keys are found. +* Rule support. Create flexible rules to handle issues such as pluralization. +* Massive speed and stability improvements to development mode. +* Added Russian strings. (Thanks to Evgeny Lineytsev) +* Complete RDoc documentation. +* Improved helpers. +* GLoc now configurable via get_config and set_config +* Added an option to tell GLoc to output various verbose information. +* More useful functions such as set_language_if_valid, similar_language +* GLoc's entire internal state can now be backed up and restored. + + +== Version 1.0 (17 April 2006) + +* Initial public release. diff --git a/vendor/plugins/gloc-1.1.0/MIT-LICENSE b/vendor/plugins/gloc-1.1.0/MIT-LICENSE new file mode 100644 index 000000000..081774a65 --- /dev/null +++ b/vendor/plugins/gloc-1.1.0/MIT-LICENSE @@ -0,0 +1,19 @@ +Copyright (c) 2005-2006 David Barri + +Permission is hereby granted, free of charge, to any person obtaining a copy +of this software and associated documentation files (the "Software"), to deal +in the Software without restriction, including without limitation the rights +to use, copy, modify, merge, publish, distribute, sublicense, and/or sell +copies of the Software, and to permit persons to whom the Software is +furnished to do so, subject to the following conditions: + +The above copyright notice and this permission notice shall be included in +all copies or substantial portions of the Software. + +THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR +IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, +FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE +AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER +LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, +OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN +THE SOFTWARE. \ No newline at end of file diff --git a/vendor/plugins/gloc-1.1.0/README b/vendor/plugins/gloc-1.1.0/README new file mode 100644 index 000000000..66f8e5e9f --- /dev/null +++ b/vendor/plugins/gloc-1.1.0/README @@ -0,0 +1,208 @@ += About + +=== Preface +I originally started designing this on weekends and after work in 2005. We started to become very interested in Rails at work and I wanted to get some experience with ruby with before we started using it full-time. I didn't have very many ideas for anything interesting to create so, because we write a lot of multilingual webapps at my company, I decided to write a localization library. That way if my little hobby project developed into something decent, I could at least put it to good use. +And here we are in 2006, my little hobby project has come a long way and become quite a useful piece of software. Not only do I use it in production sites I write at work, but I also prefer it to other existing alternatives. Therefore I have decided to make it publicly available, and I hope that other developers will find it useful too. + +=== About +GLoc is a localization library. It doesn't aim to do everything l10n-related that you can imagine, but what it does, it does very well. It was originally designed as a Rails plugin, but can also be used for plain ruby projects. Here are a list of its main features: +* Lightweight and efficient. +* Uses file-based string bundles. Strings can also be set directly. +* Intelligent, cascading language configuration. +* Create flexible rules to handle issues such as pluralization. +* Includes a ActionController filter that auto-detects the client language. +* Works perfectly with Rails Engines and allows strings to be overridden just as easily as controllers, models, etc. +* Automatically localizes Rails functions such as distance_in_minutes, select_month etc +* Supports different charsets. You can even specify the encoding to use for each language seperately. +* Special Rails mods/helpers. + +=== What does GLoc mean? +If you're wondering about the name "GLoc", I'm sure you're not alone. +This project was originally just called "Localization" which was a bit too common, so when I decided to release it I decided to call it "Golly's Localization Library" instead (Golly is my nickname), and that was long and boring so I then abbreviated that to "GLoc". What a fun story!! + +=== Localization helpers +This also includes a few helpers for common situations such as displaying localized date, time, "yes" or "no", etc. + +=== Rails Localization +At the moment, unless you manually remove the require 'gloc-rails-text' line from init.rb, this plugin overrides certain Rails functions to provide multilingual versions. This automatically localizes functions such as select_date(), distance_of_time_in_words() and more... +The strings can be found in lang/*.yml. +NOTE: This is not complete. Timezones and countries are not currently localized. + + + + += Usage + +=== Quickstart + +Windows users will need to first install iconv. http://wiki.rubyonrails.com/rails/pages/iconv + +* Create a dir "#{RAILS_ROOT}/lang" +* Create a file "#{RAILS_ROOT}/lang/en.yml" and write your strings. The format is "key: string". Save it as UTF-8. If you save it in a different encoding, add a key called file_charset (eg. "file_charset: iso-2022-jp") +* Put the following in config/environment.rb and change the values as you see fit. The following example is for an app that uses English and Japanese, with Japanese being the default. + GLoc.set_config :default_language => :ja + GLoc.clear_strings_except :en, :ja + GLoc.set_kcode + GLoc.load_localized_strings +* Add 'include GLoc' to all classes that will use localization. This is added to most Rails classes automatically. +* Optionally, you can set the language for models and controllers by simply inserting set_language :en in classes and/or methods. +* To use localized strings, replace text such as "Welcome" with l(:welcome_string_key), and "Hello #{name}." with l(:hello_string_key, name). (Of course the strings will need to exist in your string bundle.) + +There is more functionality provided by this plugin, that is not demonstrated above. Please read the API summary for details. + +=== API summary + +The following methods are added as both class methods and instance methods to modules/classes that include GLoc. They are also available as class methods of GLoc. + current_language # Returns the current language + l(symbol, *arguments) # Returns a localized string + ll(lang, symbol, *arguments) # Returns a localized string in a specific language + ltry(possible_key) # Returns a localized string if passed a Symbol, else returns the same argument passed + lwr(symbol, *arguments) # Uses the default rule to return a localized string. + lwr_(rule, symbol, *arguments) # Uses a specified rule to return a localized string. + l_has_string?(symbol) # Checks if a localized string exists + set_language(language) # Sets the language for the current class or class instance + set_language_if_valid(lang) # Sets the current language if the language passed is a valid language + +The GLoc module also defines the following class methods: + add_localized_strings(lang, symbol_hash, override=true) # Adds a hash of localized strings + backup_state(clear=false) # Creates a backup of GLoc's internal state and optionally clears everything too + clear_strings(*languages) # Removes localized strings from memory + clear_strings_except(*languages) # Removes localized strings from memory except for those of certain specified languages + get_charset(lang) # Returns the charset used to store localized strings in memory + get_config(key) # Returns a GLoc configuration value (see below) + load_localized_strings(dir=nil, override=true) # Loads localized strings from all YML files in a given directory + restore_state(state) # Restores a backup of GLoc's internal state + set_charset(new_charset, *langs) # Sets the charset used to internally store localized strings + set_config(hash) # Sets GLoc configuration values (see below) + set_kcode(charset=nil) # Sets the $KCODE global variable + similar_language(language) # Tries to find a valid language that is similar to the argument passed + valid_languages # Returns an array of (currently) valid languages (ie. languages for which localized data exists) + valid_language?(language) # Checks whether any localized strings are in memory for a given language + +GLoc uses the following configuration items. They can be accessed via get_config and set_config. + :default_cookie_name + :default_language + :default_param_name + :raise_string_not_found_errors + :verbose + +The GLoc module is automatically included in the following classes: + ActionController::Base + ActionMailer::Base + ActionView::Base + ActionView::Helpers::InstanceTag + ActiveRecord::Base + ActiveRecord::Errors + ApplicationHelper + Test::Unit::TestCase + +The GLoc module also defines the following controller filters: + autodetect_language_filter + +GLoc also makes the following change to Rails: +* Views for ActionMailer are now #{view_name}_#{language}.rb rather than just #{view_name}.rb +* All ActiveRecord validation class methods now accept a localized string key (symbol) as a :message value. +* ActiveRecord::Errors.add now accepts symbols as valid message values. At runtime these symbols are converted to localized strings using the current_language of the base record. +* ActiveRecord::Errors.add now accepts arrays as arguments so that printf-style strings can be generated at runtime. This also applies to the validates_* class methods. + Eg. validates_xxxxxx_of :name, :message => ['Your name must be at least %d characters.', MIN_LEN] + Eg. validates_xxxxxx_of :name, :message => [:user_error_validation_name_too_short, MIN_LEN] +* Instances of ActiveView inherit their current_language from the controller (or mailer) creating them. + +This plugin also adds the following rake tasks: + * gloc:sort - Sorts the keys in the lang ymls (also accepts a DIR argument) + +=== Cascading language configuration + +The language can be set at three levels: + 1. The default # GLoc.get_config :default_language + 2. Class level # class A; set_language :de; end + 3. Instance level # b= B.new; b.set_language :zh + +Instance level has the highest priority and the default has the lowest. + +Because GLoc is included at class level too, it becomes easy to associate languages with contexts. +For example: + class Student + set_language :en + def say_hello + puts "We say #{l :hello} but our teachers say #{Teacher.l :hello}" + end + end + +=== Rules + +There are often situations when depending on the value of one or more variables, the surrounding text +changes. The most common case of this is pluralization. Rather than hardcode these rules, they are +completely definable by the user so that the user can eaasily accomodate for more complicated grammatical +rules such as those found in Russian and Polish (or so I hear). To define a rule, simply include a string +in the string bundle whose key begins with "_gloc_rule_" and then write ruby code as the value. The ruby +code will be converted to a Proc when the string bundle is first read, and should return a prefix that will +be appended to the string key at runtime to point to a new string. Make sense? Probably not... Please look +at the following example and I am sure it will all make sense. + +Simple example (string bundle / en.yml) + _gloc_rule_default: ' |n| n==1 ? "_single" : "_plural" ' + man_count_plural: There are %d men. + man_count_single: There is 1 man. + +Simple example (code) + lwr(:man_count, 1) # => There is 1 man. + lwr(:man_count, 8) # => There are 8 men. + +To use rules other than the default simply call lwr_ instead of lwr, and specify the rule. + +Example #2 (string bundle / en.yml) + _gloc_rule_default: ' |n| n==1 ? "_single" : "_plural" ' + _gloc_rule_custom: ' |n| return "_none" if n==0; return "_heaps" if n>100; n==1 ? "_single" : "_plural" ' + man_count_none: There are no men. + man_count_heaps: There are heaps of men!! + man_count_plural: There are %d men. + man_count_single: There is 1 man. + +Example #2 (code) + lwr_(:custom, :man_count, 0) # => There are no men. + lwr_(:custom, :man_count, 1) # => There is 1 man. + lwr_(:custom, :man_count, 8) # => There are 8 men. + lwr_(:custom, :man_count, 150) # => There are heaps of men!! + + +=== Helpers + +GLoc includes the following helpers: + l_age(age) # Returns a localized version of an age. eg "3 years old" + l_date(date) # Returns a date in a localized format + l_datetime(date) # Returns a date+time in a localized format + l_datetime_short(date) # Returns a date+time in a localized short format. + l_lang_name(l,dl=nil) # Returns the name of a language (you must supply your own strings) + l_strftime(date,fmt) # Formats a date/time in a localized format. + l_time(date) # Returns a time in a localized format + l_YesNo(value) # Returns localized string of "Yes" or "No" depending on the arg + l_yesno(value) # Returns localized string of "yes" or "no" depending on the arg + +=== Rails localization + +Not all of Rails is covered but the following functions are: + distance_of_time_in_words + select_day + select_month + select_year + add_options + + + + += FAQ + +==== How do I use it in engines? +Simply put this in your init_engine.rb + GLoc.load_localized_strings File.join(File.dirname(__FILE__),'lang') +That way your engines strings will be loaded when the engine is started. Just simply make sure that you load your application strings after you start your engines to safely override any engine strings. + +==== Why am I getting an Iconv::IllegalSequence error when calling GLoc.set_charset? +By default GLoc loads all of its default strings at startup. For example, calling set_charset 'iso-2022-jp' will cause this error because Russian strings are loaded by default, and the Russian strings use characters that cannot be expressed in the ISO-2022-JP charset. +Before calling set_charset you should call clear_strings_except to remove strings from any languages that you will not be using. +Alternatively, you can simply specify the language(s) as follows, set_charset 'iso-2022-jp', :ja. + +==== How do I make GLoc ignore StringNotFoundErrors? +Disable it as follows: + GLoc.set_config :raise_string_not_found_errors => false diff --git a/vendor/plugins/gloc-1.1.0/Rakefile b/vendor/plugins/gloc-1.1.0/Rakefile new file mode 100644 index 000000000..a5b8fe762 --- /dev/null +++ b/vendor/plugins/gloc-1.1.0/Rakefile @@ -0,0 +1,15 @@ +Dir.glob("#{File.dirname(__FILE__)}/tasks/*.rake").each {|f| load f} + +task :default => 'gloc:sort' + +# RDoc task +require 'rake/rdoctask' +Rake::RDocTask.new() { |rdoc| + rdoc.rdoc_dir = 'doc' + rdoc.title = "GLoc Localization Library Documentation" + rdoc.options << '--line-numbers' << '--inline-source' + rdoc.rdoc_files.include('README', 'CHANGELOG') + rdoc.rdoc_files.include('lib/**/*.rb') + rdoc.rdoc_files.exclude('lib/gloc-dev.rb') + rdoc.rdoc_files.exclude('lib/gloc-config.rb') +} diff --git a/vendor/plugins/gloc-1.1.0/doc/classes/ActionController/Filters/ClassMethods.html b/vendor/plugins/gloc-1.1.0/doc/classes/ActionController/Filters/ClassMethods.html new file mode 100644 index 000000000..fba33b5b5 --- /dev/null +++ b/vendor/plugins/gloc-1.1.0/doc/classes/ActionController/Filters/ClassMethods.html @@ -0,0 +1,230 @@ + + + + + + Module: ActionController::Filters::ClassMethods + + + + + + + + + + +
+ + + + + + + + + + +
ModuleActionController::Filters::ClassMethods
In: + + lib/gloc-rails.rb + +
+
+
+ + +
+ + + +
+ + + +
+ +
+

Methods

+ +
+ autodetect_language_filter   +
+
+ +
+ + + + +
+ + + + + + + + + +
+

Public Instance methods

+ +
+ + +
+ + autodetect_language_filter(*args) + +
+ +
+

+This filter attempts to auto-detect the clients desired language. It first +checks the params, then a cookie and then the HTTP_ACCEPT_LANGUAGE request +header. If a language is found to match or be similar to a currently valid +language, then it sets the current_language of the controller. +

+
+  class ExampleController < ApplicationController
+    set_language :en
+    autodetect_language_filter :except => 'monkey', :on_no_lang => :lang_not_autodetected_callback
+    autodetect_language_filter :only => 'monkey', :check_cookie => 'monkey_lang', :check_accept_header => false
+    ...
+    def lang_not_autodetected_callback
+      redirect_to somewhere
+    end
+  end
+
+

+The args for this filter are exactly the same the arguments of +before_filter with the following exceptions: +

+
    +
  • :check_params — If false, then params will not be checked +for a language. If a String, then this will value will be used as the name +of the param. + +
    • +
  • :check_cookie — If false, then the cookie will not be +checked for a language. If a String, then this will value will be used as +the name of the cookie. + +
    • +
  • :check_accept_header — If false, then HTTP_ACCEPT_LANGUAGE +will not be checked for a language. + +
    • +
  • :on_set_lang — You can specify the name of a callback +function to be called when the language is successfully detected and set. +The param must be a Symbol or a String which is the name of the function. +The callback function must accept one argument (the language) and must be +instance level. + +
    • +
  • :on_no_lang — You can specify the name of a callback +function to be called when the language couldn’t be detected +automatically. The param must be a Symbol or a String which is the name of +the function. The callback function must be instance level. + +
    • +
+

+You override the default names of the param or cookie by calling GLoc.set_config :default_param_name +=> ‘new_param_name‘ and GLoc.set_config :default_cookie_name +=> ‘new_cookie_name‘. +

+

[Source]

+
+
+    # File lib/gloc-rails.rb, line 43
+43:       def autodetect_language_filter(*args)
+44:         options= args.last.is_a?(Hash) ? args.last : {}
+45:         x= 'Proc.new { |c| l= nil;'
+46:         # :check_params
+47:         unless (v= options.delete(:check_params)) == false
+48:           name= v ? ":#{v}" : 'GLoc.get_config(:default_param_name)'
+49:           x << "l ||= GLoc.similar_language(c.params[#{name}]);"
+50:         end
+51:         # :check_cookie
+52:         unless (v= options.delete(:check_cookie)) == false
+53:           name= v ? ":#{v}" : 'GLoc.get_config(:default_cookie_name)'
+54:           x << "l ||= GLoc.similar_language(c.send(:cookies)[#{name}]);"
+55:         end
+56:         # :check_accept_header
+57:         unless options.delete(:check_accept_header) == false
+58:           x << %<
+59:               unless l
+60:                 a= c.request.env['HTTP_ACCEPT_LANGUAGE'].split(/,|;/) rescue nil
+61:                 a.each {|x| l ||= GLoc.similar_language(x)} if a
+62:               end; >
+63:         end
+64:         # Set language
+65:         x << 'ret= true;'
+66:         x << 'if l; c.set_language(l); c.headers[\'Content-Language\']= l.to_s; '
+67:         if options.has_key?(:on_set_lang)
+68:           x << "ret= c.#{options.delete(:on_set_lang)}(l);"
+69:         end
+70:         if options.has_key?(:on_no_lang)
+71:           x << "else; ret= c.#{options.delete(:on_no_lang)};"
+72:         end
+73:         x << 'end; ret }'
+74:         
+75:         # Create filter
+76:         block= eval x
+77:         before_filter(*args, &block)
+78:       end
+
+
+
+
+ + +
+ + +
+ + +
+

[Validate]

+
+ + + \ No newline at end of file diff --git a/vendor/plugins/gloc-1.1.0/doc/classes/ActionMailer/Base.html b/vendor/plugins/gloc-1.1.0/doc/classes/ActionMailer/Base.html new file mode 100644 index 000000000..056b23d85 --- /dev/null +++ b/vendor/plugins/gloc-1.1.0/doc/classes/ActionMailer/Base.html @@ -0,0 +1,140 @@ + + + + + + Class: ActionMailer::Base + + + + + + + + + + +
+ + + + + + + + + + + + + + +
ClassActionMailer::Base
In: + + lib/gloc-rails.rb + +
+
Parent: + Object +
+
+ + +
+ + + +
+ +
+

+In addition to including GLoc, +render_message is also overridden so that mail templates contain +the current language at the end of the file. Eg. deliver_hello +will render hello_en.rhtml. +

+ +
+ + +
+ + +
+ + + +
+

Included Modules

+ +
+ GLoc +
+
+ +
+ + + +
+

External Aliases

+ +
+ + + + + + +
render_message->render_message_without_gloc
+
+
+ + + + + + + + +
+ + +
+

[Validate]

+
+ + + \ No newline at end of file diff --git a/vendor/plugins/gloc-1.1.0/doc/classes/ActionView/Base.html b/vendor/plugins/gloc-1.1.0/doc/classes/ActionView/Base.html new file mode 100644 index 000000000..00767055d --- /dev/null +++ b/vendor/plugins/gloc-1.1.0/doc/classes/ActionView/Base.html @@ -0,0 +1,174 @@ + + + + + + Class: ActionView::Base + + + + + + + + + + +
+ + + + + + + + + + + + + + +
ClassActionView::Base
In: + + lib/gloc-rails.rb + +
+
Parent: + Object +
+
+ + +
+ + + +
+ +
+

+initialize is overridden so that new instances of this class +inherit the current language of the controller. +

+ +
+ + +
+ +
+

Methods

+ +
+ new   +
+
+ +
+ + + +
+

Included Modules

+ +
+ GLoc +
+
+ +
+ + + +
+

External Aliases

+ +
+ + + + + + +
initialize->initialize_without_gloc
+
+
+ + + + + + +
+

Public Class methods

+ +
+ + +
+ + new(base_path = nil, assigns_for_first_render = {}, controller = nil) + +
+ +
+

[Source]

+
+
+     # File lib/gloc-rails.rb, line 109
+109:     def initialize(base_path = nil, assigns_for_first_render = {}, controller = nil)
+110:       initialize_without_gloc(base_path, assigns_for_first_render, controller)
+111:       set_language controller.current_language unless controller.nil?
+112:     end
+
+
+
+
+ + +
+ + +
+ + +
+

[Validate]

+
+ + + \ No newline at end of file diff --git a/vendor/plugins/gloc-1.1.0/doc/classes/ActionView/Helpers/DateHelper.html b/vendor/plugins/gloc-1.1.0/doc/classes/ActionView/Helpers/DateHelper.html new file mode 100644 index 000000000..84ca8fae3 --- /dev/null +++ b/vendor/plugins/gloc-1.1.0/doc/classes/ActionView/Helpers/DateHelper.html @@ -0,0 +1,348 @@ + + + + + + Module: ActionView::Helpers::DateHelper + + + + + + + + + + +
+ + + + + + + + + + +
ModuleActionView::Helpers::DateHelper
In: + + lib/gloc-rails-text.rb + +
+
+
+ + +
+ + + +
+ + + +
+ +
+

Methods

+ +
+ distance_of_time_in_words   + select_day   + select_month   + select_year   +
+
+ +
+ + + + +
+ + +
+

Constants

+ +
+ + + + + + + + + + + + + + + + +
LOCALIZED_HELPERS=true
LOCALIZED_MONTHNAMES={}
LOCALIZED_ABBR_MONTHNAMES={}
+
+
+ + + + + + + +
+

Public Instance methods

+ +
+ + +
+ + distance_of_time_in_words(from_time, to_time = 0, include_seconds = false) + +
+ +
+

+This method uses current_language to return a localized string. +

+

[Source]

+
+
+    # File lib/gloc-rails-text.rb, line 16
+16:       def distance_of_time_in_words(from_time, to_time = 0, include_seconds = false)
+17:         from_time = from_time.to_time if from_time.respond_to?(:to_time)
+18:         to_time = to_time.to_time if to_time.respond_to?(:to_time)
+19:         distance_in_minutes = (((to_time - from_time).abs)/60).round
+20:         distance_in_seconds = ((to_time - from_time).abs).round
+21: 
+22:         case distance_in_minutes
+23:           when 0..1
+24:             return (distance_in_minutes==0) ? l(:actionview_datehelper_time_in_words_minute_less_than) : l(:actionview_datehelper_time_in_words_minute_single) unless include_seconds
+25:             case distance_in_seconds
+26:               when 0..5   then lwr(:actionview_datehelper_time_in_words_second_less_than, 5)
+27:               when 6..10  then lwr(:actionview_datehelper_time_in_words_second_less_than, 10)
+28:               when 11..20 then lwr(:actionview_datehelper_time_in_words_second_less_than, 20)
+29:               when 21..40 then l(:actionview_datehelper_time_in_words_minute_half)
+30:               when 41..59 then l(:actionview_datehelper_time_in_words_minute_less_than)
+31:               else             l(:actionview_datehelper_time_in_words_minute)
+32:             end
+33:                                 
+34:           when 2..45      then lwr(:actionview_datehelper_time_in_words_minute, distance_in_minutes)
+35:           when 46..90     then l(:actionview_datehelper_time_in_words_hour_about_single)
+36:           when 90..1440   then lwr(:actionview_datehelper_time_in_words_hour_about, (distance_in_minutes.to_f / 60.0).round)
+37:           when 1441..2880 then lwr(:actionview_datehelper_time_in_words_day, 1)
+38:           else                 lwr(:actionview_datehelper_time_in_words_day, (distance_in_minutes / 1440).round)
+39:         end
+40:       end
+
+
+
+
+ +
+ + +
+ + select_day(date, options = {}) + +
+ +
+

+This method has been modified so that a localized string can be appended to +the day numbers. +

+

[Source]

+
+
+    # File lib/gloc-rails-text.rb, line 43
+43:       def select_day(date, options = {})
+44:         day_options = []
+45:         prefix = l :actionview_datehelper_select_day_prefix
+46: 
+47:         1.upto(31) do |day|
+48:           day_options << ((date && (date.kind_of?(Fixnum) ? date : date.day) == day) ?
+49:             %(<option value="#{day}" selected="selected">#{day}#{prefix}</option>\n) :
+50:             %(<option value="#{day}">#{day}#{prefix}</option>\n)
+51:           )
+52:         end
+53: 
+54:         select_html(options[:field_name] || 'day', day_options, options[:prefix], options[:include_blank], options[:discard_type], options[:disabled])
+55:       end
+
+
+
+
+ +
+ + +
+ + select_month(date, options = {}) + +
+ +
+

+This method has been modified so that +

+
    +
  • the month names are localized. + +
    • +
  • it uses options: :min_date, :max_date, +:start_month, :end_month + +
    • +
  • a localized string can be appended to the month numbers when the +:use_month_numbers option is specified. + +
    • +
+

[Source]

+
+
+    # File lib/gloc-rails-text.rb, line 61
+61:       def select_month(date, options = {})
+62:         unless LOCALIZED_MONTHNAMES.has_key?(current_language)
+63:           LOCALIZED_MONTHNAMES[current_language] = [''] + l(:actionview_datehelper_select_month_names).split(',')
+64:           LOCALIZED_ABBR_MONTHNAMES[current_language] = [''] + l(:actionview_datehelper_select_month_names_abbr).split(',')
+65:         end
+66:         
+67:         month_options = []
+68:         month_names = options[:use_short_month] ? LOCALIZED_ABBR_MONTHNAMES[current_language] : LOCALIZED_MONTHNAMES[current_language]
+69:         
+70:         if options.has_key?(:min_date) && options.has_key?(:max_date)
+71:           if options[:min_date].year == options[:max_date].year
+72:             start_month, end_month = options[:min_date].month, options[:max_date].month
+73:           end
+74:         end
+75:         start_month = (options[:start_month] || 1) unless start_month
+76:         end_month = (options[:end_month] || 12) unless end_month
+77:         prefix = l :actionview_datehelper_select_month_prefix
+78: 
+79:         start_month.upto(end_month) do |month_number|
+80:           month_name = if options[:use_month_numbers]
+81:             "#{month_number}#{prefix}"
+82:           elsif options[:add_month_numbers]
+83:             month_number.to_s + ' - ' + month_names[month_number]
+84:           else
+85:             month_names[month_number]
+86:           end
+87: 
+88:           month_options << ((date && (date.kind_of?(Fixnum) ? date : date.month) == month_number) ?
+89:             %(<option value="#{month_number}" selected="selected">#{month_name}</option>\n) :
+90:             %(<option value="#{month_number}">#{month_name}</option>\n)
+91:           )
+92:         end
+93: 
+94:         select_html(options[:field_name] || 'month', month_options, options[:prefix], options[:include_blank], options[:discard_type], options[:disabled])
+95:       end
+
+
+
+
+ +
+ + +
+ + select_year(date, options = {}) + +
+ +
+

+This method has been modified so that +

+
    +
  • it uses options: :min_date, :max_date + +
    • +
  • a localized string can be appended to the years numbers. + +
    • +
+

[Source]

+
+
+     # File lib/gloc-rails-text.rb, line 100
+100:       def select_year(date, options = {})
+101:         year_options = []
+102:         y = date ? (date.kind_of?(Fixnum) ? (y = (date == 0) ? Date.today.year : date) : date.year) : Date.today.year
+103: 
+104:         start_year = options.has_key?(:min_date) ? options[:min_date].year : (options[:start_year] || y-5)
+105:         end_year = options.has_key?(:max_date) ? options[:max_date].year : (options[:end_year] || y+5)
+106:         step_val = start_year < end_year ? 1 : -1
+107:         prefix = l :actionview_datehelper_select_year_prefix
+108: 
+109:         start_year.step(end_year, step_val) do |year|
+110:           year_options << ((date && (date.kind_of?(Fixnum) ? date : date.year) == year) ?
+111:             %(<option value="#{year}" selected="selected">#{year}#{prefix}</option>\n) :
+112:             %(<option value="#{year}">#{year}#{prefix}</option>\n)
+113:           )
+114:         end
+115: 
+116:         select_html(options[:field_name] || 'year', year_options, options[:prefix], options[:include_blank], options[:discard_type], options[:disabled])
+117:       end
+
+
+
+
+ + +
+ + +
+ + +
+

[Validate]

+
+ + + \ No newline at end of file diff --git a/vendor/plugins/gloc-1.1.0/doc/classes/ActionView/Helpers/InstanceTag.html b/vendor/plugins/gloc-1.1.0/doc/classes/ActionView/Helpers/InstanceTag.html new file mode 100644 index 000000000..a236e0e5d --- /dev/null +++ b/vendor/plugins/gloc-1.1.0/doc/classes/ActionView/Helpers/InstanceTag.html @@ -0,0 +1,167 @@ + + + + + + Class: ActionView::Helpers::InstanceTag + + + + + + + + + + +
+ + + + + + + + + + + + + + +
ClassActionView::Helpers::InstanceTag
In: + + lib/gloc-rails-text.rb + +
+ + lib/gloc-rails.rb + +
+
Parent: + Object +
+
+ + +
+ + + +
+ +
+

+The private method add_options is overridden so that "Please +select" is localized. +

+ +
+ + +
+ +
+

Methods

+ +
+ current_language   +
+
+ +
+ + + +
+

Included Modules

+ +
+ GLoc +
+
+ +
+ + + + + + + + + +
+

Public Instance methods

+ +
+ + +
+ + current_language() + +
+ +
+

+Inherits the current language from the template object. +

+

[Source]

+
+
+     # File lib/gloc-rails.rb, line 119
+119:       def current_language
+120:         @template_object.current_language
+121:       end
+
+
+
+
+ + +
+ + +
+ + +
+

[Validate]

+
+ + + \ No newline at end of file diff --git a/vendor/plugins/gloc-1.1.0/doc/classes/ActiveRecord/Errors.html b/vendor/plugins/gloc-1.1.0/doc/classes/ActiveRecord/Errors.html new file mode 100644 index 000000000..9a16f608b --- /dev/null +++ b/vendor/plugins/gloc-1.1.0/doc/classes/ActiveRecord/Errors.html @@ -0,0 +1,215 @@ + + + + + + Class: ActiveRecord::Errors + + + + + + + + + + +
+ + + + + + + + + + + + + + +
ClassActiveRecord::Errors
In: + + lib/gloc-rails.rb + +
+
Parent: + Object +
+
+ + +
+ + + +
+ + + +
+ +
+

Methods

+ +
+ add   + current_language   +
+
+ +
+ + + +
+

Included Modules

+ +
+ GLoc +
+
+ +
+ + + +
+

External Aliases

+ +
+ + + + + + +
add->add_without_gloc
+
+
+ + + + + + +
+

Public Instance methods

+ +
+ + +
+ + add(attribute, msg= @@default_error_messages[:invalid]) + +
+ +
+

+The GLoc version of this method provides two +extra features +

+
    +
  • If msg is a string, it will be considered a GLoc string key. + +
    • +
  • If msg is an array, the first element will be considered the +string and the remaining elements will be considered arguments for the +string. Eg. [‘Hi %s.’,’John’] + +
    • +
+

[Source]

+
+
+     # File lib/gloc-rails.rb, line 141
+141:     def add(attribute, msg= @@default_error_messages[:invalid])
+142:       if msg.is_a?(Array)
+143:         args= msg.clone
+144:         msg= args.shift
+145:         args= nil if args.empty?
+146:       end
+147:       msg= ltry(msg)
+148:       msg= msg % args unless args.nil?
+149:       add_without_gloc(attribute, msg)
+150:     end
+
+
+
+
+ +
+ + +
+ + current_language() + +
+ +
+

+Inherits the current language from the base record. +

+

[Source]

+
+
+     # File lib/gloc-rails.rb, line 152
+152:     def current_language
+153:       @base.current_language
+154:     end
+
+
+
+
+ + +
+ + +
+ + +
+

[Validate]

+
+ + + \ No newline at end of file diff --git a/vendor/plugins/gloc-1.1.0/doc/classes/ActiveRecord/Validations/ClassMethods.html b/vendor/plugins/gloc-1.1.0/doc/classes/ActiveRecord/Validations/ClassMethods.html new file mode 100644 index 000000000..145a74c2b --- /dev/null +++ b/vendor/plugins/gloc-1.1.0/doc/classes/ActiveRecord/Validations/ClassMethods.html @@ -0,0 +1,217 @@ + + + + + + Module: ActiveRecord::Validations::ClassMethods + + + + + + + + + + +
+ + + + + + + + + + +
ModuleActiveRecord::Validations::ClassMethods
In: + + lib/gloc-rails.rb + +
+
+
+ + +
+ + + +
+ + + +
+ +
+

Methods

+ +
+ validates_length_of   + validates_size_of   +
+
+ +
+ + + + +
+ + + + + + + + + +
+

Public Instance methods

+ +
+ + +
+ + validates_length_of(*attrs) + +
+ +
+

+The default Rails version of this function creates an error message and +then passes it to ActiveRecord.Errors. The GLoc version of this method, sends an array to +ActiveRecord.Errors that will be turned into a +string by ActiveRecord.Errors which in turn +allows for the message of this validation function to be a GLoc string key. +

+

[Source]

+
+
+     # File lib/gloc-rails.rb, line 164
+164:       def validates_length_of(*attrs)
+165:         # Merge given options with defaults.
+166:         options = {
+167:           :too_long     => ActiveRecord::Errors.default_error_messages[:too_long],
+168:           :too_short    => ActiveRecord::Errors.default_error_messages[:too_short],
+169:           :wrong_length => ActiveRecord::Errors.default_error_messages[:wrong_length]
+170:         }.merge(DEFAULT_VALIDATION_OPTIONS)
+171:         options.update(attrs.pop.symbolize_keys) if attrs.last.is_a?(Hash)
+172: 
+173:         # Ensure that one and only one range option is specified.
+174:         range_options = ALL_RANGE_OPTIONS & options.keys
+175:         case range_options.size
+176:           when 0
+177:             raise ArgumentError, 'Range unspecified.  Specify the :within, :maximum, :minimum, or :is option.'
+178:           when 1
+179:             # Valid number of options; do nothing.
+180:           else
+181:             raise ArgumentError, 'Too many range options specified.  Choose only one.'
+182:         end
+183: 
+184:         # Get range option and value.
+185:         option = range_options.first
+186:         option_value = options[range_options.first]
+187: 
+188:         case option
+189:         when :within, :in
+190:           raise ArgumentError, ":#{option} must be a Range" unless option_value.is_a?(Range)
+191: 
+192:           too_short = [options[:too_short] , option_value.begin]
+193:           too_long  = [options[:too_long]  , option_value.end  ]
+194: 
+195:           validates_each(attrs, options) do |record, attr, value|
+196:             if value.nil? or value.split(//).size < option_value.begin
+197:               record.errors.add(attr, too_short)
+198:             elsif value.split(//).size > option_value.end
+199:               record.errors.add(attr, too_long)
+200:             end
+201:           end
+202:         when :is, :minimum, :maximum
+203:           raise ArgumentError, ":#{option} must be a nonnegative Integer" unless option_value.is_a?(Integer) and option_value >= 0
+204: 
+205:           # Declare different validations per option.
+206:           validity_checks = { :is => "==", :minimum => ">=", :maximum => "<=" }
+207:           message_options = { :is => :wrong_length, :minimum => :too_short, :maximum => :too_long }
+208: 
+209:           message = [(options[:message] || options[message_options[option]]) , option_value]
+210: 
+211:           validates_each(attrs, options) do |record, attr, value|
+212:             if value.kind_of?(String)
+213:               record.errors.add(attr, message) unless !value.nil? and value.split(//).size.method(validity_checks[option])[option_value]
+214:             else
+215:               record.errors.add(attr, message) unless !value.nil? and value.size.method(validity_checks[option])[option_value]
+216:             end
+217:           end
+218:         end
+219:       end
+
+
+
+
+ +
+ + +
+ validates_size_of(*attrs) +
+ +
+

+Alias for validates_length_of +

+
+
+ + +
+ + +
+ + +
+

[Validate]

+
+ + + \ No newline at end of file diff --git a/vendor/plugins/gloc-1.1.0/doc/classes/GLoc.html b/vendor/plugins/gloc-1.1.0/doc/classes/GLoc.html new file mode 100644 index 000000000..8a25c7de8 --- /dev/null +++ b/vendor/plugins/gloc-1.1.0/doc/classes/GLoc.html @@ -0,0 +1,774 @@ + + + + + + Module: GLoc + + + + + + + + + + +
+ + + + + + + + + + +
ModuleGLoc
In: + + lib/gloc-helpers.rb + +
+ + lib/gloc-internal.rb + +
+ + lib/gloc-version.rb + +
+ + lib/gloc.rb + +
+
+
+ + +
+ + + +
+ +
+

+Copyright © 2005-2006 David Barri +

+ +
+ + +
+ + + +
+ + + +
+

Included Modules

+ + +
+ +
+ +
+

Classes and Modules

+ + Module GLoc::ClassMethods
+Module GLoc::Helpers
+Module GLoc::InstanceMethods
+ +
+ +
+

Constants

+ +
+ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
LOCALIZED_STRINGS={}
RULES={}
LOWERCASE_LANGUAGES={}
UTF_8='utf-8'
SHIFT_JIS='sjis'
EUC_JP='euc-jp'
+
+
+ +
+

External Aliases

+ +
+ + + + + + +
clear_strings->_clear_strings
+
+
+ + + + + + +
+

Public Class methods

+ +
+ + +
+ + add_localized_strings(lang, symbol_hash, override=true, strings_charset=nil) + +
+ +
+

+Adds a collection of localized strings to the in-memory string store. +

+

[Source]

+
+
+     # File lib/gloc.rb, line 113
+113:     def add_localized_strings(lang, symbol_hash, override=true, strings_charset=nil)
+114:       _verbose_msg {"Adding #{symbol_hash.size} #{lang} strings."}
+115:       _add_localized_strings(lang, symbol_hash, override, strings_charset)
+116:       _verbose_msg :stats
+117:     end
+
+
+
+
+ +
+ + +
+ + backup_state(clear=false) + +
+ +
+

+Creates a backup of the internal state of GLoc (ie. +strings, langs, rules, config) and optionally clears everything. +

+

[Source]

+
+
+     # File lib/gloc.rb, line 121
+121:     def backup_state(clear=false)
+122:       s= _get_internal_state_vars.map{|o| o.clone}
+123:       _get_internal_state_vars.each{|o| o.clear} if clear
+124:       s
+125:     end
+
+
+
+
+ +
+ + +
+ + clear_strings(*languages) + +
+ +
+

+Removes all localized strings from memory, either of a certain language (or +languages), or entirely. +

+

[Source]

+
+
+     # File lib/gloc.rb, line 129
+129:     def clear_strings(*languages)
+130:       if languages.empty?
+131:         _verbose_msg {"Clearing all strings"}
+132:         LOCALIZED_STRINGS.clear
+133:         LOWERCASE_LANGUAGES.clear
+134:       else
+135:         languages.each {|l|
+136:           _verbose_msg {"Clearing :#{l} strings"}
+137:           l= l.to_sym
+138:           LOCALIZED_STRINGS.delete l
+139:           LOWERCASE_LANGUAGES.each_pair {|k,v| LOWERCASE_LANGUAGES.delete k if v == l}
+140:         }
+141:       end
+142:     end
+
+
+
+
+ +
+ + +
+ + clear_strings_except(*languages) + +
+ +
+

+Removes all localized strings from memory, except for those of certain +specified languages. +

+

[Source]

+
+
+     # File lib/gloc.rb, line 146
+146:     def clear_strings_except(*languages)
+147:       clear= (LOCALIZED_STRINGS.keys - languages)
+148:       _clear_strings(*clear) unless clear.empty?
+149:     end
+
+
+
+
+ +
+ + +
+ + current_language() + +
+ +
+

+Returns the default language +

+

[Source]

+
+
+     # File lib/gloc.rb, line 108
+108:     def current_language
+109:       GLoc::CONFIG[:default_language]
+110:     end
+
+
+
+
+ +
+ + +
+ + get_charset(lang) + +
+ +
+

+Returns the charset used to store localized strings in memory. +

+

[Source]

+
+
+     # File lib/gloc.rb, line 152
+152:     def get_charset(lang)
+153:       CONFIG[:internal_charset_per_lang][lang] || CONFIG[:internal_charset]
+154:     end
+
+
+
+
+ +
+ + +
+ + get_config(key) + +
+ +
+

+Returns a GLoc configuration value. +

+

[Source]

+
+
+     # File lib/gloc.rb, line 157
+157:     def get_config(key)
+158:       CONFIG[key]
+159:     end
+
+
+
+
+ +
+ + +
+ + load_gloc_default_localized_strings(override=false) + +
+ +
+

+Loads the localized strings that are included in the GLoc library. +

+

[Source]

+
+
+     # File lib/gloc.rb, line 162
+162:     def load_gloc_default_localized_strings(override=false)
+163:       GLoc.load_localized_strings "#{File.dirname(__FILE__)}/../lang", override
+164:     end
+
+
+
+
+ +
+ + +
+ + load_localized_strings(dir=nil, override=true) + +
+ +
+

+Loads localized strings from all yml files in the specifed directory. +

+

[Source]

+
+
+     # File lib/gloc.rb, line 167
+167:     def load_localized_strings(dir=nil, override=true)
+168:       _charset_required
+169:       _get_lang_file_list(dir).each {|filename|
+170:         
+171:         # Load file
+172:         raw_hash = YAML::load(File.read(filename))
+173:         raw_hash={} unless raw_hash.kind_of?(Hash)
+174:         filename =~ /([^\/\\]+)\.ya?ml$/
+175:         lang = $1.to_sym
+176:         file_charset = raw_hash['file_charset'] || UTF_8
+177:   
+178:         # Convert string keys to symbols
+179:         dest_charset= get_charset(lang)
+180:         _verbose_msg {"Reading file #{filename} [charset: #{file_charset} --> #{dest_charset}]"}
+181:         symbol_hash = {}
+182:         Iconv.open(dest_charset, file_charset) do |i|
+183:           raw_hash.each {|key, value|
+184:             symbol_hash[key.to_sym] = i.iconv(value)
+185:           }
+186:         end
+187:   
+188:         # Add strings to repos
+189:         _add_localized_strings(lang, symbol_hash, override)
+190:       }
+191:       _verbose_msg :stats
+192:     end
+
+
+
+
+ +
+ + +
+ + restore_state(state) + +
+ +
+

+Restores a backup of GLoc’s internal state +that was made with backup_state. +

+

[Source]

+
+
+     # File lib/gloc.rb, line 195
+195:     def restore_state(state)
+196:       _get_internal_state_vars.each do |o|
+197:         o.clear
+198:         o.send o.respond_to?(:merge!) ? :merge! : :concat, state.shift
+199:       end
+200:     end
+
+
+
+
+ +
+ + +
+ + set_charset(new_charset, *langs) + +
+ +
+

+Sets the charset used to internally store localized strings. You can set +the charset to use for a specific language or languages, or if none are +specified the charset for ALL localized strings will be set. +

+

[Source]

+
+
+     # File lib/gloc.rb, line 205
+205:     def set_charset(new_charset, *langs)
+206:       CONFIG[:internal_charset_per_lang] ||= {}
+207:       
+208:       # Convert symbol shortcuts
+209:       if new_charset.is_a?(Symbol)
+210:         new_charset= case new_charset
+211:           when :utf8, :utf_8 then UTF_8
+212:           when :sjis, :shift_jis, :shiftjis then SHIFT_JIS
+213:           when :eucjp, :euc_jp then EUC_JP
+214:           else new_charset.to_s
+215:           end
+216:       end
+217:       
+218:       # Convert existing strings
+219:       (langs.empty? ? LOCALIZED_STRINGS.keys : langs).each do |lang|
+220:         cur_charset= get_charset(lang)
+221:         if cur_charset && new_charset != cur_charset
+222:           _verbose_msg {"Converting :#{lang} strings from #{cur_charset} to #{new_charset}"}
+223:           Iconv.open(new_charset, cur_charset) do |i|
+224:             bundle= LOCALIZED_STRINGS[lang]
+225:             bundle.each_pair {|k,v| bundle[k]= i.iconv(v)}
+226:           end
+227:         end
+228:       end
+229:       
+230:       # Set new charset value
+231:       if langs.empty?
+232:         _verbose_msg {"Setting GLoc charset for all languages to #{new_charset}"}
+233:         CONFIG[:internal_charset]= new_charset
+234:         CONFIG[:internal_charset_per_lang].clear
+235:       else
+236:         langs.each do |lang|
+237:           _verbose_msg {"Setting GLoc charset for :#{lang} strings to #{new_charset}"}
+238:           CONFIG[:internal_charset_per_lang][lang]= new_charset
+239:         end
+240:       end
+241:     end
+
+
+
+
+ +
+ + +
+ + set_config(hash) + +
+ +
+

+Sets GLoc configuration values. +

+

[Source]

+
+
+     # File lib/gloc.rb, line 244
+244:     def set_config(hash)
+245:       CONFIG.merge! hash
+246:     end
+
+
+
+
+ +
+ + +
+ + set_kcode(charset=nil) + +
+ +
+

+Sets the $KCODE global variable according to a specified charset, or else +the current default charset for the default language. +

+

[Source]

+
+
+     # File lib/gloc.rb, line 250
+250:     def set_kcode(charset=nil)
+251:       _charset_required
+252:       charset ||= get_charset(current_language)
+253:       $KCODE= case charset
+254:         when UTF_8 then 'u'
+255:         when SHIFT_JIS then 's'
+256:         when EUC_JP then 'e'
+257:         else 'n'
+258:         end
+259:       _verbose_msg {"$KCODE set to #{$KCODE}"}
+260:     end
+
+
+
+
+ +
+ + +
+ + similar_language(lang) + +
+ +
+

+Tries to find a valid language that is similar to the argument passed. Eg. +:en, :en_au, :EN_US are all similar languages. Returns nil if no +similar languages are found. +

+

[Source]

+
+
+     # File lib/gloc.rb, line 265
+265:     def similar_language(lang)
+266:       return nil if lang.nil?
+267:       return lang.to_sym if valid_language?(lang)
+268:       # Check lowercase without dashes
+269:       lang= lang.to_s.downcase.gsub('-','_')
+270:       return LOWERCASE_LANGUAGES[lang] if LOWERCASE_LANGUAGES.has_key?(lang)
+271:       # Check without dialect
+272:       if lang.to_s =~ /^([a-z]+?)[^a-z].*/
+273:         lang= $1
+274:         return LOWERCASE_LANGUAGES[lang] if LOWERCASE_LANGUAGES.has_key?(lang)
+275:       end
+276:       # Check other dialects
+277:       lang= "#{lang}_"
+278:       LOWERCASE_LANGUAGES.keys.each {|k| return LOWERCASE_LANGUAGES[k] if k.starts_with?(lang)}
+279:       # Nothing found
+280:       nil
+281:     end
+
+
+
+
+ +
+ + +
+ + valid_language?(language) + +
+ +
+

+Returns true if there are any localized strings for a specified +language. Note that although set_langauge nil is perfectly valid, +nil is not a valid language. +

+

[Source]

+
+
+     # File lib/gloc.rb, line 290
+290:     def valid_language?(language)
+291:       LOCALIZED_STRINGS.has_key? language.to_sym rescue false
+292:     end
+
+
+
+
+ +
+ + +
+ + valid_languages() + +
+ +
+

+Returns an array of (currently) valid languages (ie. languages for which +localized data exists). +

+

[Source]

+
+
+     # File lib/gloc.rb, line 284
+284:     def valid_languages
+285:       LOCALIZED_STRINGS.keys
+286:     end
+
+
+
+
+ +

Public Instance methods

+ +
+ + +
+ + current_language() + +
+ +
+

+Returns the instance-level current language, or if not set, returns the +class-level current language. +

+

[Source]

+
+
+    # File lib/gloc.rb, line 77
+77:   def current_language
+78:     @gloc_language || self.class.current_language
+79:   end
+
+
+
+
+ + +
+ + +
+ + +
+

[Validate]

+
+ + + \ No newline at end of file diff --git a/vendor/plugins/gloc-1.1.0/doc/classes/GLoc/ClassMethods.html b/vendor/plugins/gloc-1.1.0/doc/classes/GLoc/ClassMethods.html new file mode 100644 index 000000000..ba1a28ad0 --- /dev/null +++ b/vendor/plugins/gloc-1.1.0/doc/classes/GLoc/ClassMethods.html @@ -0,0 +1,160 @@ + + + + + + Module: GLoc::ClassMethods + + + + + + + + + + +
+ + + + + + + + + + +
ModuleGLoc::ClassMethods
In: + + lib/gloc.rb + +
+
+
+ + +
+ + + +
+ +
+

+All classes/modules that include GLoc will also +gain these class methods. Notice that the GLoc::InstanceMethods module is also +included. +

+ +
+ + +
+ +
+

Methods

+ +
+ current_language   +
+
+ +
+ + + +
+

Included Modules

+ + +
+ +
+ + + + + + + + + +
+

Public Instance methods

+ +
+ + +
+ + current_language() + +
+ +
+

+Returns the current language, or if not set, returns the GLoc current language. +

+

[Source]

+
+
+    # File lib/gloc.rb, line 89
+89:     def current_language
+90:       @gloc_language || GLoc.current_language
+91:     end
+
+
+
+
+ + +
+ + +
+ + +
+

[Validate]

+
+ + + \ No newline at end of file diff --git a/vendor/plugins/gloc-1.1.0/doc/classes/GLoc/Helpers.html b/vendor/plugins/gloc-1.1.0/doc/classes/GLoc/Helpers.html new file mode 100644 index 000000000..f3fdf63e1 --- /dev/null +++ b/vendor/plugins/gloc-1.1.0/doc/classes/GLoc/Helpers.html @@ -0,0 +1,323 @@ + + + + + + Module: GLoc::Helpers + + + + + + + + + + +
+ + + + + + + + + + +
ModuleGLoc::Helpers
In: + + lib/gloc-helpers.rb + +
+
+
+ + +
+ + + +
+ +
+

+These helper methods will be included in the InstanceMethods module. +

+ +
+ + +
+ +
+

Methods

+ +
+ l_YesNo   + l_age   + l_date   + l_datetime   + l_datetime_short   + l_lang_name   + l_strftime   + l_time   + l_yesno   +
+
+ +
+ + + + +
+ + + + + + + + + +
+

Public Instance methods

+ +
+ + +
+ + l_YesNo(value) + +
+ +
+

[Source]

+
+
+    # File lib/gloc-helpers.rb, line 12
+12:     def l_YesNo(value)         l(value ? :general_text_Yes : :general_text_No) end
+
+
+
+
+ +
+ + +
+ + l_age(age) + +
+ +
+

[Source]

+
+
+   # File lib/gloc-helpers.rb, line 6
+6:     def l_age(age)             lwr :general_fmt_age, age end
+
+
+
+
+ +
+ + +
+ + l_date(date) + +
+ +
+

[Source]

+
+
+   # File lib/gloc-helpers.rb, line 7
+7:     def l_date(date)           l_strftime date, :general_fmt_date end
+
+
+
+
+ +
+ + +
+ + l_datetime(date) + +
+ +
+

[Source]

+
+
+   # File lib/gloc-helpers.rb, line 8
+8:     def l_datetime(date)       l_strftime date, :general_fmt_datetime end
+
+
+
+
+ +
+ + +
+ + l_datetime_short(date) + +
+ +
+

[Source]

+
+
+   # File lib/gloc-helpers.rb, line 9
+9:     def l_datetime_short(date) l_strftime date, :general_fmt_datetime_short end
+
+
+
+
+ +
+ + +
+ + l_lang_name(lang, display_lang=nil) + +
+ +
+

[Source]

+
+
+    # File lib/gloc-helpers.rb, line 15
+15:     def l_lang_name(lang, display_lang=nil)
+16:       ll display_lang || current_language, "general_lang_#{lang}"
+17:     end
+
+
+
+
+ +
+ + +
+ + l_strftime(date,fmt) + +
+ +
+

[Source]

+
+
+    # File lib/gloc-helpers.rb, line 10
+10:     def l_strftime(date,fmt)   date.strftime l(fmt) end
+
+
+
+
+ +
+ + +
+ + l_time(time) + +
+ +
+

[Source]

+
+
+    # File lib/gloc-helpers.rb, line 11
+11:     def l_time(time)           l_strftime time, :general_fmt_time end
+
+
+
+
+ +
+ + +
+ + l_yesno(value) + +
+ +
+

[Source]

+
+
+    # File lib/gloc-helpers.rb, line 13
+13:     def l_yesno(value)         l(value ? :general_text_yes : :general_text_no) end
+
+
+
+
+ + +
+ + +
+ + +
+

[Validate]

+
+ + + \ No newline at end of file diff --git a/vendor/plugins/gloc-1.1.0/doc/classes/GLoc/InstanceMethods.html b/vendor/plugins/gloc-1.1.0/doc/classes/GLoc/InstanceMethods.html new file mode 100644 index 000000000..4e15c9383 --- /dev/null +++ b/vendor/plugins/gloc-1.1.0/doc/classes/GLoc/InstanceMethods.html @@ -0,0 +1,364 @@ + + + + + + Module: GLoc::InstanceMethods + + + + + + + + + + +
+ + + + + + + + + + +
ModuleGLoc::InstanceMethods
In: + + lib/gloc.rb + +
+
+
+ + +
+ + + +
+ +
+

+This module will be included in both instances and classes of GLoc includees. It is also included as class +methods in the GLoc module itself. +

+ +
+ + +
+ +
+

Methods

+ +
+ l   + l_has_string?   + ll   + ltry   + lwr   + lwr_   + set_language   + set_language_if_valid   +
+
+ +
+ + + +
+

Included Modules

+ +
+ Helpers +
+
+ +
+ + + + + + + + + +
+

Public Instance methods

+ +
+ + +
+ + l(symbol, *arguments) + +
+ +
+

+Returns a localized string. +

+

[Source]

+
+
+    # File lib/gloc.rb, line 18
+18:     def l(symbol, *arguments)
+19:       return GLoc._l(symbol,current_language,*arguments)
+20:     end
+
+
+
+
+ +
+ + +
+ + l_has_string?(symbol) + +
+ +
+

+Returns true if a localized string with the specified key exists. +

+

[Source]

+
+
+    # File lib/gloc.rb, line 48
+48:     def l_has_string?(symbol)
+49:       return GLoc._l_has_string?(symbol,current_language)
+50:     end
+
+
+
+
+ +
+ + +
+ + ll(lang, symbol, *arguments) + +
+ +
+

+Returns a localized string in a specified language. This does not effect +current_language. +

+

[Source]

+
+
+    # File lib/gloc.rb, line 24
+24:     def ll(lang, symbol, *arguments)
+25:       return GLoc._l(symbol,lang.to_sym,*arguments)
+26:     end
+
+
+
+
+ +
+ + +
+ + ltry(possible_key) + +
+ +
+

+Returns a localized string if the argument is a Symbol, else just returns +the argument. +

+

[Source]

+
+
+    # File lib/gloc.rb, line 29
+29:     def ltry(possible_key)
+30:       possible_key.is_a?(Symbol) ? l(possible_key) : possible_key
+31:     end
+
+
+
+
+ +
+ + +
+ + lwr(symbol, *arguments) + +
+ +
+

+Uses the default GLoc rule to return a localized +string. See lwr_() for more info. +

+

[Source]

+
+
+    # File lib/gloc.rb, line 35
+35:     def lwr(symbol, *arguments)
+36:       lwr_(:default, symbol, *arguments)
+37:     end
+
+
+
+
+ +
+ + +
+ + lwr_(rule, symbol, *arguments) + +
+ +
+

+Uses a rule to return a localized string. A rule is a function +that uses specified arguments to return a localization key prefix. The +prefix is appended to the localization key originally specified, to create +a new key which is then used to lookup a localized string. +

+

[Source]

+
+
+    # File lib/gloc.rb, line 43
+43:     def lwr_(rule, symbol, *arguments)
+44:       GLoc._l("#{symbol}#{GLoc::_l_rule(rule,current_language).call(*arguments)}",current_language,*arguments)
+45:     end
+
+
+
+
+ +
+ + +
+ + set_language(language) + +
+ +
+

+Sets the current language for this instance/class. Setting the language of +a class effects all instances unless the instance has its own language +defined. +

+

[Source]

+
+
+    # File lib/gloc.rb, line 54
+54:     def set_language(language)
+55:       @gloc_language= language.nil? ? nil : language.to_sym
+56:     end
+
+
+
+
+ +
+ + +
+ + set_language_if_valid(language) + +
+ +
+

+Sets the current language if the language passed is a valid language. If +the language was valid, this method returns true else it will +return false. Note that nil is not a valid language. See +set_language(language) for more +info. +

+

[Source]

+
+
+    # File lib/gloc.rb, line 62
+62:     def set_language_if_valid(language)
+63:       if GLoc.valid_language?(language)
+64:         set_language(language)
+65:         true
+66:       else
+67:         false
+68:       end
+69:     end
+
+
+
+
+ + +
+ + +
+ + +
+

[Validate]

+
+ + + \ No newline at end of file diff --git a/vendor/plugins/gloc-1.1.0/doc/created.rid b/vendor/plugins/gloc-1.1.0/doc/created.rid new file mode 100644 index 000000000..eba9efa29 --- /dev/null +++ b/vendor/plugins/gloc-1.1.0/doc/created.rid @@ -0,0 +1 @@ +Sun May 28 15:21:13 E. Australia Standard Time 2006 diff --git a/vendor/plugins/gloc-1.1.0/doc/files/CHANGELOG.html b/vendor/plugins/gloc-1.1.0/doc/files/CHANGELOG.html new file mode 100644 index 000000000..aec36c5bf --- /dev/null +++ b/vendor/plugins/gloc-1.1.0/doc/files/CHANGELOG.html @@ -0,0 +1,153 @@ + + + + + + File: CHANGELOG + + + + + + + + + + +
+

CHANGELOG

+ + + + + + + + + +
Path:CHANGELOG +
Last Update:Sun May 28 15:19:38 E. Australia Standard Time 2006
+
+ + +
+ + + +
+ +
+

Version 1.1 (28 May 2006)

+
    +
  • The charset for each and/or all languages can now be easily configured. + +
    • +
  • Added a ActionController filter that auto-detects the client language. + +
    • +
  • The rake task "sort" now merges lines that match 100%, and warns +if duplicate keys are found. + +
    • +
  • Rule support. Create flexible rules to handle issues such as pluralization. + +
    • +
  • Massive speed and stability improvements to development mode. + +
    • +
  • Added Russian strings. (Thanks to Evgeny Lineytsev) + +
    • +
  • Complete RDoc documentation. + +
    • +
  • Improved helpers. + +
    • +
  • GLoc now configurable via get_config and +set_config + +
    • +
  • Added an option to tell GLoc to output +various verbose information. + +
    • +
  • More useful functions such as set_language_if_valid, similar_language + +
    • +
  • GLoc’s entire internal state can +now be backed up and restored. + +
    • +
+

Version 1.0 (17 April 2006)

+
    +
  • Initial public release. + +
    • +
+ +
+ + +
+ + +
+ + + + +
+ + + + + + + + + + + +
+ + +
+

[Validate]

+
+ + + \ No newline at end of file diff --git a/vendor/plugins/gloc-1.1.0/doc/files/README.html b/vendor/plugins/gloc-1.1.0/doc/files/README.html new file mode 100644 index 000000000..d078659d2 --- /dev/null +++ b/vendor/plugins/gloc-1.1.0/doc/files/README.html @@ -0,0 +1,480 @@ + + + + + + File: README + + + + + + + + + + +
+

README

+ + + + + + + + + +
Path:README +
Last Update:Sun May 28 15:19:38 E. Australia Standard Time 2006
+
+ + +
+ + + +
+ +
+

About

+

Preface

+

+I originally started designing this on weekends and after work in 2005. We +started to become very interested in Rails at work and I wanted to get some +experience with ruby with before we started using it full-time. I +didn’t have very many ideas for anything interesting to create so, +because we write a lot of multilingual webapps at my company, I decided to +write a localization library. That way if my little hobby project developed +into something decent, I could at least put it to good use. And here we are +in 2006, my little hobby project has come a long way and become quite a +useful piece of software. Not only do I use it in production sites I write +at work, but I also prefer it to other existing alternatives. Therefore I +have decided to make it publicly available, and I hope that other +developers will find it useful too. +

+

About

+

+GLoc is a localization library. It +doesn’t aim to do everything l10n-related that you can imagine, but +what it does, it does very well. It was originally designed as a Rails +plugin, but can also be used for plain ruby projects. Here are a list of +its main features: +

+
    +
  • Lightweight and efficient. + +
    • +
  • Uses file-based string bundles. Strings can also be set directly. + +
    • +
  • Intelligent, cascading language configuration. + +
    • +
  • Create flexible rules to handle issues such as pluralization. + +
    • +
  • Includes a ActionController filter that auto-detects the client language. + +
    • +
  • Works perfectly with Rails Engines and allows strings to be overridden just +as easily as controllers, models, etc. + +
    • +
  • Automatically localizes Rails functions such as distance_in_minutes, +select_month etc + +
    • +
  • Supports different charsets. You can even specify the encoding to use for +each language seperately. + +
    • +
  • Special Rails mods/helpers. + +
    • +
+

What does GLoc mean?

+

+If you’re wondering about the name "GLoc", I’m sure you’re not +alone. This project was originally just called "Localization" +which was a bit too common, so when I decided to release it I decided to +call it "Golly’s Localization Library" instead (Golly is my +nickname), and that was long and boring so I then abbreviated that to +"GLoc". What a fun story!! +

+

Localization helpers

+

+This also includes a few helpers for common situations such as displaying +localized date, time, "yes" or "no", etc. +

+

Rails Localization

+

+At the moment, unless you manually remove the require +‘gloc-rails-text’ line from init.rb, this plugin overrides +certain Rails functions to provide multilingual versions. This +automatically localizes functions such as select_date(), +distance_of_time_in_words() and more… The strings can be found in +lang/*.yml. NOTE: This is not complete. Timezones and countries are not +currently localized. +

+

Usage

+

Quickstart

+

+Windows users will need to first install iconv. wiki.rubyonrails.com/rails/pages/iconv +

+
    +
  • Create a dir "#{RAILS_ROOT}/lang" + +
    • +
  • Create a file "#{RAILS_ROOT}/lang/en.yml" and write your strings. +The format is "key: string". Save it as UTF-8. If you save it in +a different encoding, add a key called file_charset (eg. +"file_charset: iso-2022-jp") + +
    • +
  • Put the following in config/environment.rb and change the values as you see +fit. The following example is for an app that uses English and Japanese, +with Japanese being the default. + +
    +  GLoc.set_config :default_language => :ja
+  GLoc.clear_strings_except :en, :ja
+  GLoc.set_kcode
+  GLoc.load_localized_strings
+
    +
    • +
  • Add ‘include GLoc’ to all +classes that will use localization. This is added to most Rails classes +automatically. + +
    • +
  • Optionally, you can set the language for models and controllers by simply +inserting set_language :en in classes and/or methods. + +
    • +
  • To use localized strings, replace text such as "Welcome" +with l(:welcome_string_key), and "Hello +#{name}." with l(:hello_string_key, name). (Of course +the strings will need to exist in your string bundle.) + +
    • +
+

+There is more functionality provided by this plugin, that is not +demonstrated above. Please read the API summary for details. +

+

API summary

+

+The following methods are added as both class methods and instance methods +to modules/classes that include GLoc. +They are also available as class methods of GLoc. +

+
+  current_language               # Returns the current language
+  l(symbol, *arguments)          # Returns a localized string
+  ll(lang, symbol, *arguments)   # Returns a localized string in a specific language
+  ltry(possible_key)             # Returns a localized string if passed a Symbol, else returns the same argument passed
+  lwr(symbol, *arguments)        # Uses the default rule to return a localized string.
+  lwr_(rule, symbol, *arguments) # Uses a specified rule to return a localized string.
+  l_has_string?(symbol)          # Checks if a localized string exists
+  set_language(language)         # Sets the language for the current class or class instance
+  set_language_if_valid(lang)    # Sets the current language if the language passed is a valid language
+
+

+The GLoc module also defines the +following class methods: +

+
+  add_localized_strings(lang, symbol_hash, override=true) # Adds a hash of localized strings
+  backup_state(clear=false)                               # Creates a backup of GLoc's internal state and optionally clears everything too
+  clear_strings(*languages)                               # Removes localized strings from memory
+  clear_strings_except(*languages)                        # Removes localized strings from memory except for those of certain specified languages
+  get_charset(lang)                                       # Returns the charset used to store localized strings in memory
+  get_config(key)                                         # Returns a GLoc configuration value (see below)
+  load_localized_strings(dir=nil, override=true)          # Loads localized strings from all YML files in a given directory
+  restore_state(state)                                    # Restores a backup of GLoc's internal state
+  set_charset(new_charset, *langs)                        # Sets the charset used to internally store localized strings
+  set_config(hash)                                        # Sets GLoc configuration values (see below)
+  set_kcode(charset=nil)                                  # Sets the $KCODE global variable
+  similar_language(language)                              # Tries to find a valid language that is similar to the argument passed
+  valid_languages                                         # Returns an array of (currently) valid languages (ie. languages for which localized data exists)
+  valid_language?(language)                               # Checks whether any localized strings are in memory for a given language
+
+

+GLoc uses the following configuration +items. They can be accessed via get_config and +set_config. +

+
+  :default_cookie_name
+  :default_language
+  :default_param_name
+  :raise_string_not_found_errors
+  :verbose
+
+

+The GLoc module is automatically +included in the following classes: +

+
+  ActionController::Base
+  ActionMailer::Base
+  ActionView::Base
+  ActionView::Helpers::InstanceTag
+  ActiveRecord::Base
+  ActiveRecord::Errors
+  ApplicationHelper
+  Test::Unit::TestCase
+
+

+The GLoc module also defines the +following controller filters: +

+
+  autodetect_language_filter
+
+

+GLoc also makes the following change to +Rails: +

+
    +
  • Views for ActionMailer are now #{view_name}_#{language}.rb rather than just +#{view_name}.rb + +
    • +
  • All ActiveRecord validation class methods now accept a localized string key +(symbol) as a :message value. + +
    • +
  • ActiveRecord::Errors.add +now accepts symbols as valid message values. At runtime these symbols are +converted to localized strings using the current_language of the base +record. + +
    • +
  • ActiveRecord::Errors.add +now accepts arrays as arguments so that printf-style strings can be +generated at runtime. This also applies to the validates_* class methods. + +
    +  Eg. validates_xxxxxx_of :name, :message => ['Your name must be at least %d characters.', MIN_LEN]
+  Eg. validates_xxxxxx_of :name, :message => [:user_error_validation_name_too_short, MIN_LEN]
+
    +
    • +
  • Instances of ActiveView inherit their current_language from the controller +(or mailer) creating them. + +
    • +
+

+This plugin also adds the following rake tasks: +

+
+  * gloc:sort - Sorts the keys in the lang ymls (also accepts a DIR argument)
+
+

Cascading language configuration

+

+The language can be set at three levels: +

+
+  1. The default     # GLoc.get_config :default_language
+  2. Class level     # class A; set_language :de; end
+  3. Instance level  # b= B.new; b.set_language :zh
+
+

+Instance level has the highest priority and the default has the lowest. +

+

+Because GLoc is included at class level +too, it becomes easy to associate languages with contexts. For example: +

+
+  class Student
+    set_language :en
+    def say_hello
+      puts "We say #{l :hello} but our teachers say #{Teacher.l :hello}"
+    end
+  end
+
+

Rules

+

+There are often situations when depending on the value of one or more +variables, the surrounding text changes. The most common case of this is +pluralization. Rather than hardcode these rules, they are completely +definable by the user so that the user can eaasily accomodate for more +complicated grammatical rules such as those found in Russian and Polish (or +so I hear). To define a rule, simply include a string in the string bundle +whose key begins with "gloc_rule" and then write ruby +code as the value. The ruby code will be converted to a Proc when the +string bundle is first read, and should return a prefix that will be +appended to the string key at runtime to point to a new string. Make sense? +Probably not… Please look at the following example and I am sure it +will all make sense. +

+

+Simple example (string bundle / en.yml) +

+
+  _gloc_rule_default: ' |n| n==1 ? "_single" : "_plural" '
+  man_count_plural: There are %d men.
+  man_count_single: There is 1 man.
+
+

+Simple example (code) +

+
+  lwr(:man_count, 1)  # => There is 1 man.
+  lwr(:man_count, 8)  # => There are 8 men.
+
+

+To use rules other than the default simply call lwr_ instead of lwr, and +specify the rule. +

+

+Example 2 (string bundle / en.yml) +

+
+  _gloc_rule_default: ' |n| n==1 ? "_single" : "_plural" '
+  _gloc_rule_custom: ' |n| return "_none" if n==0; return "_heaps" if n>100; n==1 ? "_single" : "_plural" '
+  man_count_none: There are no men.
+  man_count_heaps: There are heaps of men!!
+  man_count_plural: There are %d men.
+  man_count_single: There is 1 man.
+
+

+Example 2 (code) +

+
+  lwr_(:custom, :man_count, 0)    # => There are no men.
+  lwr_(:custom, :man_count, 1)    # => There is 1 man.
+  lwr_(:custom, :man_count, 8)    # => There are 8 men.
+  lwr_(:custom, :man_count, 150)  # => There are heaps of men!!
+
+

Helpers

+

+GLoc includes the following helpers: +

+
+  l_age(age)             # Returns a localized version of an age. eg "3 years old"
+  l_date(date)           # Returns a date in a localized format
+  l_datetime(date)       # Returns a date+time in a localized format
+  l_datetime_short(date) # Returns a date+time in a localized short format.
+  l_lang_name(l,dl=nil)  # Returns the name of a language (you must supply your own strings)
+  l_strftime(date,fmt)   # Formats a date/time in a localized format.
+  l_time(date)           # Returns a time in a localized format
+  l_YesNo(value)         # Returns localized string of "Yes" or "No" depending on the arg
+  l_yesno(value)         # Returns localized string of "yes" or "no" depending on the arg
+
+

Rails localization

+

+Not all of Rails is covered but the following functions are: +

+
+  distance_of_time_in_words
+  select_day
+  select_month
+  select_year
+  add_options
+
+

FAQ

+

How do I use it in engines?

+

+Simply put this in your init_engine.rb +

+
+  GLoc.load_localized_strings File.join(File.dirname(__FILE__),'lang')
+
+

+That way your engines strings will be loaded when the engine is started. +Just simply make sure that you load your application strings after you +start your engines to safely override any engine strings. +

+

Why am I getting an Iconv::IllegalSequence error when calling GLoc.set_charset?

+

+By default GLoc loads all of its default +strings at startup. For example, calling set_charset +‘iso-2022-jp’ will cause this error because Russian +strings are loaded by default, and the Russian strings use characters that +cannot be expressed in the ISO-2022-JP charset. Before calling +set_charset you should call clear_strings_except to +remove strings from any languages that you will not be using. +Alternatively, you can simply specify the language(s) as follows, +set_charset ‘iso-2022-jp’, :ja. +

+

How do I make GLoc ignore StringNotFoundErrors?

+

+Disable it as follows: +

+
+  GLoc.set_config :raise_string_not_found_errors => false
+
+ +
+ + +
+ + +
+ + + + +
+ + + + + + + + + + + +
+ + +
+

[Validate]

+
+ + + \ No newline at end of file diff --git a/vendor/plugins/gloc-1.1.0/doc/files/lib/gloc-helpers_rb.html b/vendor/plugins/gloc-1.1.0/doc/files/lib/gloc-helpers_rb.html new file mode 100644 index 000000000..394b79d70 --- /dev/null +++ b/vendor/plugins/gloc-1.1.0/doc/files/lib/gloc-helpers_rb.html @@ -0,0 +1,107 @@ + + + + + + File: gloc-helpers.rb + + + + + + + + + + +
+

gloc-helpers.rb

+ + + + + + + + + +
Path:lib/gloc-helpers.rb +
Last Update:Sun May 28 15:19:38 E. Australia Standard Time 2006
+
+ + +
+ + + +
+ +
+

+Copyright © 2005-2006 David Barri +

+ +
+ + +
+ + +
+ + + + +
+ + + + + + + + + + + +
+ + +
+

[Validate]

+
+ + + \ No newline at end of file diff --git a/vendor/plugins/gloc-1.1.0/doc/files/lib/gloc-internal_rb.html b/vendor/plugins/gloc-1.1.0/doc/files/lib/gloc-internal_rb.html new file mode 100644 index 000000000..6d09fec7b --- /dev/null +++ b/vendor/plugins/gloc-1.1.0/doc/files/lib/gloc-internal_rb.html @@ -0,0 +1,115 @@ + + + + + + File: gloc-internal.rb + + + + + + + + + + +
+

gloc-internal.rb

+ + + + + + + + + +
Path:lib/gloc-internal.rb +
Last Update:Sun May 28 15:19:38 E. Australia Standard Time 2006
+
+ + +
+ + + +
+ +
+

+Copyright © 2005-2006 David Barri +

+ +
+ +
+

Required files

+ +
+ iconv   + gloc-version   +
+
+ +
+ + +
+ + + + +
+ + + + + + + + + + + +
+ + +
+

[Validate]

+
+ + + \ No newline at end of file diff --git a/vendor/plugins/gloc-1.1.0/doc/files/lib/gloc-rails-text_rb.html b/vendor/plugins/gloc-1.1.0/doc/files/lib/gloc-rails-text_rb.html new file mode 100644 index 000000000..52a387218 --- /dev/null +++ b/vendor/plugins/gloc-1.1.0/doc/files/lib/gloc-rails-text_rb.html @@ -0,0 +1,114 @@ + + + + + + File: gloc-rails-text.rb + + + + + + + + + + +
+

gloc-rails-text.rb

+ + + + + + + + + +
Path:lib/gloc-rails-text.rb +
Last Update:Sun May 28 15:19:38 E. Australia Standard Time 2006
+
+ + +
+ + + +
+ +
+

+Copyright © 2005-2006 David Barri +

+ +
+ +
+

Required files

+ +
+ date   +
+
+ +
+ + +
+ + + + +
+ + + + + + + + + + + +
+ + +
+

[Validate]

+
+ + + \ No newline at end of file diff --git a/vendor/plugins/gloc-1.1.0/doc/files/lib/gloc-rails_rb.html b/vendor/plugins/gloc-1.1.0/doc/files/lib/gloc-rails_rb.html new file mode 100644 index 000000000..3ae73b87b --- /dev/null +++ b/vendor/plugins/gloc-1.1.0/doc/files/lib/gloc-rails_rb.html @@ -0,0 +1,114 @@ + + + + + + File: gloc-rails.rb + + + + + + + + + + +
+

gloc-rails.rb

+ + + + + + + + + +
Path:lib/gloc-rails.rb +
Last Update:Sun May 28 15:19:38 E. Australia Standard Time 2006
+
+ + +
+ + + +
+ +
+

+Copyright © 2005-2006 David Barri +

+ +
+ +
+

Required files

+ +
+ gloc   +
+
+ +
+ + +
+ + + + +
+ + + + + + + + + + + +
+ + +
+

[Validate]

+
+ + + \ No newline at end of file diff --git a/vendor/plugins/gloc-1.1.0/doc/files/lib/gloc-ruby_rb.html b/vendor/plugins/gloc-1.1.0/doc/files/lib/gloc-ruby_rb.html new file mode 100644 index 000000000..4b29e9d94 --- /dev/null +++ b/vendor/plugins/gloc-1.1.0/doc/files/lib/gloc-ruby_rb.html @@ -0,0 +1,107 @@ + + + + + + File: gloc-ruby.rb + + + + + + + + + + +
+

gloc-ruby.rb

+ + + + + + + + + +
Path:lib/gloc-ruby.rb +
Last Update:Sun May 28 15:19:38 E. Australia Standard Time 2006
+
+ + +
+ + + +
+ +
+

+Copyright © 2005-2006 David Barri +

+ +
+ + +
+ + +
+ + + + +
+ + + + + + + + + + + +
+ + +
+

[Validate]

+
+ + + \ No newline at end of file diff --git a/vendor/plugins/gloc-1.1.0/doc/files/lib/gloc-version_rb.html b/vendor/plugins/gloc-1.1.0/doc/files/lib/gloc-version_rb.html new file mode 100644 index 000000000..17f93aa43 --- /dev/null +++ b/vendor/plugins/gloc-1.1.0/doc/files/lib/gloc-version_rb.html @@ -0,0 +1,101 @@ + + + + + + File: gloc-version.rb + + + + + + + + + + +
+

gloc-version.rb

+ + + + + + + + + +
Path:lib/gloc-version.rb +
Last Update:Sun May 28 15:19:38 E. Australia Standard Time 2006
+
+ + +
+ + + +
+ + + +
+ + +
+ + + + +
+ + + + + + + + + + + +
+ + +
+

[Validate]

+
+ + + \ No newline at end of file diff --git a/vendor/plugins/gloc-1.1.0/doc/files/lib/gloc_rb.html b/vendor/plugins/gloc-1.1.0/doc/files/lib/gloc_rb.html new file mode 100644 index 000000000..9e68a89cd --- /dev/null +++ b/vendor/plugins/gloc-1.1.0/doc/files/lib/gloc_rb.html @@ -0,0 +1,116 @@ + + + + + + File: gloc.rb + + + + + + + + + + +
+

gloc.rb

+ + + + + + + + + +
Path:lib/gloc.rb +
Last Update:Sun May 28 15:19:38 E. Australia Standard Time 2006
+
+ + +
+ + + +
+ +
+

+Copyright © 2005-2006 David Barri +

+ +
+ +
+

Required files

+ +
+ yaml   + gloc-internal   + gloc-helpers   +
+
+ +
+ + +
+ + + + +
+ + + + + + + + + + + +
+ + +
+

[Validate]

+
+ + + \ No newline at end of file diff --git a/vendor/plugins/gloc-1.1.0/doc/fr_class_index.html b/vendor/plugins/gloc-1.1.0/doc/fr_class_index.html new file mode 100644 index 000000000..08e0418f3 --- /dev/null +++ b/vendor/plugins/gloc-1.1.0/doc/fr_class_index.html @@ -0,0 +1,37 @@ + + + + + + + + Classes + + + + + +
+

Classes

+ +
+ + \ No newline at end of file diff --git a/vendor/plugins/gloc-1.1.0/doc/fr_file_index.html b/vendor/plugins/gloc-1.1.0/doc/fr_file_index.html new file mode 100644 index 000000000..839e378d3 --- /dev/null +++ b/vendor/plugins/gloc-1.1.0/doc/fr_file_index.html @@ -0,0 +1,35 @@ + + + + + + + + Files + + + + + +
+

Files

+ +
+ + \ No newline at end of file diff --git a/vendor/plugins/gloc-1.1.0/doc/fr_method_index.html b/vendor/plugins/gloc-1.1.0/doc/fr_method_index.html new file mode 100644 index 000000000..325ed3589 --- /dev/null +++ b/vendor/plugins/gloc-1.1.0/doc/fr_method_index.html @@ -0,0 +1,72 @@ + + + + + + + + Methods + + + + + +
+

Methods

+
+ add (ActiveRecord::Errors)
+ add_localized_strings (GLoc)
+ autodetect_language_filter (ActionController::Filters::ClassMethods)
+ backup_state (GLoc)
+ clear_strings (GLoc)
+ clear_strings_except (GLoc)
+ current_language (GLoc::ClassMethods)
+ current_language (GLoc)
+ current_language (GLoc)
+ current_language (ActionView::Helpers::InstanceTag)
+ current_language (ActiveRecord::Errors)
+ distance_of_time_in_words (ActionView::Helpers::DateHelper)
+ get_charset (GLoc)
+ get_config (GLoc)
+ l (GLoc::InstanceMethods)
+ l_YesNo (GLoc::Helpers)
+ l_age (GLoc::Helpers)
+ l_date (GLoc::Helpers)
+ l_datetime (GLoc::Helpers)
+ l_datetime_short (GLoc::Helpers)
+ l_has_string? (GLoc::InstanceMethods)
+ l_lang_name (GLoc::Helpers)
+ l_strftime (GLoc::Helpers)
+ l_time (GLoc::Helpers)
+ l_yesno (GLoc::Helpers)
+ ll (GLoc::InstanceMethods)
+ load_gloc_default_localized_strings (GLoc)
+ load_localized_strings (GLoc)
+ ltry (GLoc::InstanceMethods)
+ lwr (GLoc::InstanceMethods)
+ lwr_ (GLoc::InstanceMethods)
+ new (ActionView::Base)
+ restore_state (GLoc)
+ select_day (ActionView::Helpers::DateHelper)
+ select_month (ActionView::Helpers::DateHelper)
+ select_year (ActionView::Helpers::DateHelper)
+ set_charset (GLoc)
+ set_config (GLoc)
+ set_kcode (GLoc)
+ set_language (GLoc::InstanceMethods)
+ set_language_if_valid (GLoc::InstanceMethods)
+ similar_language (GLoc)
+ valid_language? (GLoc)
+ valid_languages (GLoc)
+ validates_length_of (ActiveRecord::Validations::ClassMethods)
+ validates_size_of (ActiveRecord::Validations::ClassMethods)
+
+
+ + \ No newline at end of file diff --git a/vendor/plugins/gloc-1.1.0/doc/index.html b/vendor/plugins/gloc-1.1.0/doc/index.html new file mode 100644 index 000000000..f29103142 --- /dev/null +++ b/vendor/plugins/gloc-1.1.0/doc/index.html @@ -0,0 +1,24 @@ + + + + + + + GLoc Localization Library Documentation + + + + + + + + + + + \ No newline at end of file diff --git a/vendor/plugins/gloc-1.1.0/doc/rdoc-style.css b/vendor/plugins/gloc-1.1.0/doc/rdoc-style.css new file mode 100644 index 000000000..fbf7326af --- /dev/null +++ b/vendor/plugins/gloc-1.1.0/doc/rdoc-style.css @@ -0,0 +1,208 @@ + +body { + font-family: Verdana,Arial,Helvetica,sans-serif; + font-size: 90%; + margin: 0; + margin-left: 40px; + padding: 0; + background: white; +} + +h1,h2,h3,h4 { margin: 0; color: #efefef; background: transparent; } +h1 { font-size: 150%; } +h2,h3,h4 { margin-top: 1em; } + +a { background: #eef; color: #039; text-decoration: none; } +a:hover { background: #039; color: #eef; } + +/* Override the base stylesheet's Anchor inside a table cell */ +td > a { + background: transparent; + color: #039; + text-decoration: none; +} + +/* and inside a section title */ +.section-title > a { + background: transparent; + color: #eee; + text-decoration: none; +} + +/* === Structural elements =================================== */ + +div#index { + margin: 0; + margin-left: -40px; + padding: 0; + font-size: 90%; +} + + +div#index a { + margin-left: 0.7em; +} + +div#index .section-bar { + margin-left: 0px; + padding-left: 0.7em; + background: #ccc; + font-size: small; +} + + +div#classHeader, div#fileHeader { + width: auto; + color: white; + padding: 0.5em 1.5em 0.5em 1.5em; + margin: 0; + margin-left: -40px; + border-bottom: 3px solid #006; +} + +div#classHeader a, div#fileHeader a { + background: inherit; + color: white; +} + +div#classHeader td, div#fileHeader td { + background: inherit; + color: white; +} + + +div#fileHeader { + background: #057; +} + +div#classHeader { + background: #048; +} + + +.class-name-in-header { + font-size: 180%; + font-weight: bold; +} + + +div#bodyContent { + padding: 0 1.5em 0 1.5em; +} + +div#description { + padding: 0.5em 1.5em; + background: #efefef; + border: 1px dotted #999; +} + +div#description h1,h2,h3,h4,h5,h6 { + color: #125;; + background: transparent; +} + +div#validator-badges { + text-align: center; +} +div#validator-badges img { border: 0; } + +div#copyright { + color: #333; + background: #efefef; + font: 0.75em sans-serif; + margin-top: 5em; + margin-bottom: 0; + padding: 0.5em 2em; +} + + +/* === Classes =================================== */ + +table.header-table { + color: white; + font-size: small; +} + +.type-note { + font-size: small; + color: #DEDEDE; +} + +.xxsection-bar { + background: #eee; + color: #333; + padding: 3px; +} + +.section-bar { + color: #333; + border-bottom: 1px solid #999; + margin-left: -20px; +} + + +.section-title { + background: #79a; + color: #eee; + padding: 3px; + margin-top: 2em; + margin-left: -30px; + border: 1px solid #999; +} + +.top-aligned-row { vertical-align: top } +.bottom-aligned-row { vertical-align: bottom } + +/* --- Context section classes ----------------------- */ + +.context-row { } +.context-item-name { font-family: monospace; font-weight: bold; color: black; } +.context-item-value { font-size: small; color: #448; } +.context-item-desc { color: #333; padding-left: 2em; } + +/* --- Method classes -------------------------- */ +.method-detail { + background: #efefef; + padding: 0; + margin-top: 0.5em; + margin-bottom: 1em; + border: 1px dotted #ccc; +} +.method-heading { + color: black; + background: #ccc; + border-bottom: 1px solid #666; + padding: 0.2em 0.5em 0 0.5em; +} +.method-signature { color: black; background: inherit; } +.method-name { font-weight: bold; } +.method-args { font-style: italic; } +.method-description { padding: 0 0.5em 0 0.5em; } + +/* --- Source code sections -------------------- */ + +a.source-toggle { font-size: 90%; } +div.method-source-code { + background: #262626; + color: #ffdead; + margin: 1em; + padding: 0.5em; + border: 1px dashed #999; + overflow: hidden; +} + +div.method-source-code pre { color: #ffdead; overflow: hidden; } + +/* --- Ruby keyword styles --------------------- */ + +.standalone-code { background: #221111; color: #ffdead; overflow: hidden; } + +.ruby-constant { color: #7fffd4; background: transparent; } +.ruby-keyword { color: #00ffff; background: transparent; } +.ruby-ivar { color: #eedd82; background: transparent; } +.ruby-operator { color: #00ffee; background: transparent; } +.ruby-identifier { color: #ffdead; background: transparent; } +.ruby-node { color: #ffa07a; background: transparent; } +.ruby-comment { color: #b22222; font-weight: bold; background: transparent; } +.ruby-regexp { color: #ffa07a; background: transparent; } +.ruby-value { color: #7fffd4; background: transparent; } \ No newline at end of file diff --git a/vendor/plugins/gloc-1.1.0/init.rb b/vendor/plugins/gloc-1.1.0/init.rb new file mode 100644 index 000000000..9d99acd61 --- /dev/null +++ b/vendor/plugins/gloc-1.1.0/init.rb @@ -0,0 +1,11 @@ +# Copyright (c) 2005-2006 David Barri + +require 'gloc' +require 'gloc-ruby' +require 'gloc-rails' +require 'gloc-rails-text' +require 'gloc-config' + +require 'gloc-dev' if ENV['RAILS_ENV'] == 'development' + +GLoc.load_gloc_default_localized_strings diff --git a/vendor/plugins/gloc-1.1.0/lib/gloc-config.rb b/vendor/plugins/gloc-1.1.0/lib/gloc-config.rb new file mode 100644 index 000000000..e85b041f5 --- /dev/null +++ b/vendor/plugins/gloc-1.1.0/lib/gloc-config.rb @@ -0,0 +1,16 @@ +# Copyright (c) 2005-2006 David Barri + +module GLoc + + private + + CONFIG= {} unless const_defined?(:CONFIG) + unless CONFIG.frozen? + CONFIG[:default_language] ||= :en + CONFIG[:default_param_name] ||= 'lang' + CONFIG[:default_cookie_name] ||= 'lang' + CONFIG[:raise_string_not_found_errors]= true unless CONFIG.has_key?(:raise_string_not_found_errors) + CONFIG[:verbose] ||= false + end + +end diff --git a/vendor/plugins/gloc-1.1.0/lib/gloc-dev.rb b/vendor/plugins/gloc-1.1.0/lib/gloc-dev.rb new file mode 100644 index 000000000..cb12b4cb3 --- /dev/null +++ b/vendor/plugins/gloc-1.1.0/lib/gloc-dev.rb @@ -0,0 +1,97 @@ +# Copyright (c) 2005-2006 David Barri + +puts "GLoc v#{GLoc::VERSION} running in development mode. Strings can be modified at runtime." + +module GLoc + class << self + + alias :actual_add_localized_strings :add_localized_strings + def add_localized_strings(lang, symbol_hash, override=true, strings_charset=nil) + _verbose_msg {"dev::add_localized_strings #{lang}, [#{symbol_hash.size}], #{override}, #{strings_charset ? strings_charset : 'nil'}"} + STATE.push [:hash, lang, {}.merge(symbol_hash), override, strings_charset] + _force_refresh + end + + alias :actual_load_localized_strings :load_localized_strings + def load_localized_strings(dir=nil, override=true) + _verbose_msg {"dev::load_localized_strings #{dir ? dir : 'nil'}, #{override}"} + STATE.push [:dir, dir, override] + _get_lang_file_list(dir).each {|filename| FILES[filename]= nil} + end + + alias :actual_clear_strings :clear_strings + def clear_strings(*languages) + _verbose_msg {"dev::clear_strings #{languages.map{|l|l.to_s}.join(', ')}"} + STATE.push [:clear, languages.clone] + _force_refresh + end + + alias :actual_clear_strings_except :clear_strings_except + def clear_strings_except(*languages) + _verbose_msg {"dev::clear_strings_except #{languages.map{|l|l.to_s}.join(', ')}"} + STATE.push [:clear_except, languages.clone] + _force_refresh + end + + # Replace methods + [:_l, :_l_rule, :_l_has_string?, :similar_language, :valid_languages, :valid_language?].each do |m| + class_eval <<-EOB + alias :actual_#{m} :#{m} + def #{m}(*args) + _assert_gloc_strings_up_to_date + actual_#{m}(*args) + end + EOB + end + + #------------------------------------------------------------------------- + private + + STATE= [] + FILES= {} + + def _assert_gloc_strings_up_to_date + changed= @@force_refresh + + # Check if any lang files have changed + unless changed + FILES.each_pair {|f,mtime| + changed ||= (File.stat(f).mtime != mtime) + } + end + + return unless changed + puts "GLoc reloading strings..." + @@force_refresh= false + + # Update file timestamps + FILES.each_key {|f| + FILES[f]= File.stat(f).mtime + } + + # Reload strings + actual_clear_strings + STATE.each {|s| + case s[0] + when :dir then actual_load_localized_strings s[1], s[2] + when :hash then actual_add_localized_strings s[1], s[2], s[3], s[4] + when :clear then actual_clear_strings(*s[1]) + when :clear_except then actual_clear_strings_except(*s[1]) + else raise "Invalid state id: '#{s[0]}'" + end + } + _verbose_msg :stats + end + + @@force_refresh= false + def _force_refresh + @@force_refresh= true + end + + alias :super_get_internal_state_vars :_get_internal_state_vars + def _get_internal_state_vars + super_get_internal_state_vars + [ STATE, FILES ] + end + + end +end diff --git a/vendor/plugins/gloc-1.1.0/lib/gloc-helpers.rb b/vendor/plugins/gloc-1.1.0/lib/gloc-helpers.rb new file mode 100644 index 000000000..f2ceb8e3d --- /dev/null +++ b/vendor/plugins/gloc-1.1.0/lib/gloc-helpers.rb @@ -0,0 +1,20 @@ +# Copyright (c) 2005-2006 David Barri + +module GLoc + # These helper methods will be included in the InstanceMethods module. + module Helpers + def l_age(age) lwr :general_fmt_age, age end + def l_date(date) l_strftime date, :general_fmt_date end + def l_datetime(date) l_strftime date, :general_fmt_datetime end + def l_datetime_short(date) l_strftime date, :general_fmt_datetime_short end + def l_strftime(date,fmt) date.strftime l(fmt) end + def l_time(time) l_strftime time, :general_fmt_time end + def l_YesNo(value) l(value ? :general_text_Yes : :general_text_No) end + def l_yesno(value) l(value ? :general_text_yes : :general_text_no) end + + def l_lang_name(lang, display_lang=nil) + ll display_lang || current_language, "general_lang_#{lang}" + end + + end +end diff --git a/vendor/plugins/gloc-1.1.0/lib/gloc-internal.rb b/vendor/plugins/gloc-1.1.0/lib/gloc-internal.rb new file mode 100644 index 000000000..f16e90555 --- /dev/null +++ b/vendor/plugins/gloc-1.1.0/lib/gloc-internal.rb @@ -0,0 +1,134 @@ +# Copyright (c) 2005-2006 David Barri + +require 'iconv' +require 'gloc-version' + +module GLoc + class GLocError < StandardError #:nodoc: + end + class InvalidArgumentsError < GLocError #:nodoc: + end + class InvalidKeyError < GLocError #:nodoc: + end + class RuleNotFoundError < GLocError #:nodoc: + end + class StringNotFoundError < GLocError #:nodoc: + end + + class << self + private + + def _add_localized_data(lang, symbol_hash, override, target) #:nodoc: + lang= lang.to_sym + if override + target[lang] ||= {} + target[lang].merge!(symbol_hash) + else + symbol_hash.merge!(target[lang]) if target[lang] + target[lang]= symbol_hash + end + end + + def _add_localized_strings(lang, symbol_hash, override=true, strings_charset=nil) #:nodoc: + _charset_required + + # Convert all incoming strings to the gloc charset + if strings_charset + Iconv.open(get_charset(lang), strings_charset) do |i| + symbol_hash.each_pair {|k,v| symbol_hash[k]= i.iconv(v)} + end + end + + # Convert rules + rules= {} + old_kcode= $KCODE + begin + $KCODE= 'u' + Iconv.open(UTF_8, get_charset(lang)) do |i| + symbol_hash.each {|k,v| + if /^_gloc_rule_(.+)$/ =~ k.to_s + v= i.iconv(v) if v + v= '""' if v.nil? + rules[$1.to_sym]= eval "Proc.new do #{v} end" + end + } + end + ensure + $KCODE= old_kcode + end + rules.keys.each {|k| symbol_hash.delete "_gloc_rule_#{k}".to_sym} + + # Add new localized data + LOWERCASE_LANGUAGES[lang.to_s.downcase]= lang + _add_localized_data(lang, symbol_hash, override, LOCALIZED_STRINGS) + _add_localized_data(lang, rules, override, RULES) + end + + def _charset_required #:nodoc: + set_charset UTF_8 unless CONFIG[:internal_charset] + end + + def _get_internal_state_vars + [ CONFIG, LOCALIZED_STRINGS, RULES, LOWERCASE_LANGUAGES ] + end + + def _get_lang_file_list(dir) #:nodoc: + dir= File.join(RAILS_ROOT,'lang') if dir.nil? + Dir[File.join(dir,'*.{yaml,yml}')] + end + + def _l(symbol, language, *arguments) #:nodoc: + symbol= symbol.to_sym if symbol.is_a?(String) + raise InvalidKeyError.new("Symbol or String expected as key.") unless symbol.kind_of?(Symbol) + + translation= LOCALIZED_STRINGS[language][symbol] rescue nil + if translation.nil? + raise StringNotFoundError.new("There is no key called '#{symbol}' in the #{language} strings.") if CONFIG[:raise_string_not_found_errors] + translation= symbol.to_s + end + + begin + return translation % arguments + rescue => e + raise InvalidArgumentsError.new("Translation value #{translation.inspect} with arguments #{arguments.inspect} caused error '#{e.message}'") + end + end + + def _l_has_string?(symbol,lang) #:nodoc: + symbol= symbol.to_sym if symbol.is_a?(String) + LOCALIZED_STRINGS[lang].has_key?(symbol.to_sym) rescue false + end + + def _l_rule(symbol,lang) #:nodoc: + symbol= symbol.to_sym if symbol.is_a?(String) + raise InvalidKeyError.new("Symbol or String expected as key.") unless symbol.kind_of?(Symbol) + + r= RULES[lang][symbol] rescue nil + raise RuleNotFoundError.new("There is no rule called '#{symbol}' in the #{lang} rules.") if r.nil? + r + end + + def _verbose_msg(type=nil) + return unless CONFIG[:verbose] + x= case type + when :stats + x= valid_languages.map{|l| ":#{l}(#{LOCALIZED_STRINGS[l].size}/#{RULES[l].size})"}.sort.join(', ') + "Current stats -- #{x}" + else + yield + end + puts "[GLoc] #{x}" + end + + public :_l, :_l_has_string?, :_l_rule + end + + private + + unless const_defined?(:LOCALIZED_STRINGS) + LOCALIZED_STRINGS= {} + RULES= {} + LOWERCASE_LANGUAGES= {} + end + +end diff --git a/vendor/plugins/gloc-1.1.0/lib/gloc-rails-text.rb b/vendor/plugins/gloc-1.1.0/lib/gloc-rails-text.rb new file mode 100644 index 000000000..abbb7a190 --- /dev/null +++ b/vendor/plugins/gloc-1.1.0/lib/gloc-rails-text.rb @@ -0,0 +1,137 @@ +# Copyright (c) 2005-2006 David Barri + +require 'date' + +module ActionView #:nodoc: + module Helpers #:nodoc: + module DateHelper + + unless const_defined?(:LOCALIZED_HELPERS) + LOCALIZED_HELPERS= true + LOCALIZED_MONTHNAMES = {} + LOCALIZED_ABBR_MONTHNAMES = {} + end + + # This method uses current_language to return a localized string. + def distance_of_time_in_words(from_time, to_time = 0, include_seconds = false) + from_time = from_time.to_time if from_time.respond_to?(:to_time) + to_time = to_time.to_time if to_time.respond_to?(:to_time) + distance_in_minutes = (((to_time - from_time).abs)/60).round + distance_in_seconds = ((to_time - from_time).abs).round + + case distance_in_minutes + when 0..1 + return (distance_in_minutes==0) ? l(:actionview_datehelper_time_in_words_minute_less_than) : l(:actionview_datehelper_time_in_words_minute_single) unless include_seconds + case distance_in_seconds + when 0..5 then lwr(:actionview_datehelper_time_in_words_second_less_than, 5) + when 6..10 then lwr(:actionview_datehelper_time_in_words_second_less_than, 10) + when 11..20 then lwr(:actionview_datehelper_time_in_words_second_less_than, 20) + when 21..40 then l(:actionview_datehelper_time_in_words_minute_half) + when 41..59 then l(:actionview_datehelper_time_in_words_minute_less_than) + else l(:actionview_datehelper_time_in_words_minute) + end + + when 2..45 then lwr(:actionview_datehelper_time_in_words_minute, distance_in_minutes) + when 46..90 then l(:actionview_datehelper_time_in_words_hour_about_single) + when 90..1440 then lwr(:actionview_datehelper_time_in_words_hour_about, (distance_in_minutes.to_f / 60.0).round) + when 1441..2880 then lwr(:actionview_datehelper_time_in_words_day, 1) + else lwr(:actionview_datehelper_time_in_words_day, (distance_in_minutes / 1440).round) + end + end + + # This method has been modified so that a localized string can be appended to the day numbers. + def select_day(date, options = {}) + day_options = [] + prefix = l :actionview_datehelper_select_day_prefix + + 1.upto(31) do |day| + day_options << ((date && (date.kind_of?(Fixnum) ? date : date.day) == day) ? + %(\n) : + %(\n) + ) + end + + select_html(options[:field_name] || 'day', day_options, options[:prefix], options[:include_blank], options[:discard_type], options[:disabled]) + end + + # This method has been modified so that + # * the month names are localized. + # * it uses options: :min_date, :max_date, :start_month, :end_month + # * a localized string can be appended to the month numbers when the :use_month_numbers option is specified. + def select_month(date, options = {}) + unless LOCALIZED_MONTHNAMES.has_key?(current_language) + LOCALIZED_MONTHNAMES[current_language] = [''] + l(:actionview_datehelper_select_month_names).split(',') + LOCALIZED_ABBR_MONTHNAMES[current_language] = [''] + l(:actionview_datehelper_select_month_names_abbr).split(',') + end + + month_options = [] + month_names = options[:use_short_month] ? LOCALIZED_ABBR_MONTHNAMES[current_language] : LOCALIZED_MONTHNAMES[current_language] + + if options.has_key?(:min_date) && options.has_key?(:max_date) + if options[:min_date].year == options[:max_date].year + start_month, end_month = options[:min_date].month, options[:max_date].month + end + end + start_month = (options[:start_month] || 1) unless start_month + end_month = (options[:end_month] || 12) unless end_month + prefix = l :actionview_datehelper_select_month_prefix + + start_month.upto(end_month) do |month_number| + month_name = if options[:use_month_numbers] + "#{month_number}#{prefix}" + elsif options[:add_month_numbers] + month_number.to_s + ' - ' + month_names[month_number] + else + month_names[month_number] + end + + month_options << ((date && (date.kind_of?(Fixnum) ? date : date.month) == month_number) ? + %(\n) : + %(\n) + ) + end + + select_html(options[:field_name] || 'month', month_options, options[:prefix], options[:include_blank], options[:discard_type], options[:disabled]) + end + + # This method has been modified so that + # * it uses options: :min_date, :max_date + # * a localized string can be appended to the years numbers. + def select_year(date, options = {}) + year_options = [] + y = date ? (date.kind_of?(Fixnum) ? (y = (date == 0) ? Date.today.year : date) : date.year) : Date.today.year + + start_year = options.has_key?(:min_date) ? options[:min_date].year : (options[:start_year] || y-5) + end_year = options.has_key?(:max_date) ? options[:max_date].year : (options[:end_year] || y+5) + step_val = start_year < end_year ? 1 : -1 + prefix = l :actionview_datehelper_select_year_prefix + + start_year.step(end_year, step_val) do |year| + year_options << ((date && (date.kind_of?(Fixnum) ? date : date.year) == year) ? + %(\n) : + %(\n) + ) + end + + select_html(options[:field_name] || 'year', year_options, options[:prefix], options[:include_blank], options[:discard_type], options[:disabled]) + end + + end + + # The private method add_options is overridden so that "Please select" is localized. + class InstanceTag + private + + def add_options(option_tags, options, value = nil) + option_tags = "\n" + option_tags if options[:include_blank] + + if value.blank? && options[:prompt] + ("\n") + option_tags + else + option_tags + end + end + + end + end +end diff --git a/vendor/plugins/gloc-1.1.0/lib/gloc-rails.rb b/vendor/plugins/gloc-1.1.0/lib/gloc-rails.rb new file mode 100644 index 000000000..0a35b90ab --- /dev/null +++ b/vendor/plugins/gloc-1.1.0/lib/gloc-rails.rb @@ -0,0 +1,230 @@ +# Copyright (c) 2005-2006 David Barri + +require 'gloc' + +module ActionController #:nodoc: + class Base #:nodoc: + include GLoc + end + module Filters #:nodoc: + module ClassMethods + + # This filter attempts to auto-detect the clients desired language. + # It first checks the params, then a cookie and then the HTTP_ACCEPT_LANGUAGE + # request header. If a language is found to match or be similar to a currently + # valid language, then it sets the current_language of the controller. + # + # class ExampleController < ApplicationController + # set_language :en + # autodetect_language_filter :except => 'monkey', :on_no_lang => :lang_not_autodetected_callback + # autodetect_language_filter :only => 'monkey', :check_cookie => 'monkey_lang', :check_accept_header => false + # ... + # def lang_not_autodetected_callback + # redirect_to somewhere + # end + # end + # + # The args for this filter are exactly the same the arguments of + # before_filter with the following exceptions: + # * :check_params -- If false, then params will not be checked for a language. + # If a String, then this will value will be used as the name of the param. + # * :check_cookie -- If false, then the cookie will not be checked for a language. + # If a String, then this will value will be used as the name of the cookie. + # * :check_accept_header -- If false, then HTTP_ACCEPT_LANGUAGE will not be checked for a language. + # * :on_set_lang -- You can specify the name of a callback function to be called when the language + # is successfully detected and set. The param must be a Symbol or a String which is the name of the function. + # The callback function must accept one argument (the language) and must be instance level. + # * :on_no_lang -- You can specify the name of a callback function to be called when the language + # couldn't be detected automatically. The param must be a Symbol or a String which is the name of the function. + # The callback function must be instance level. + # + # You override the default names of the param or cookie by calling GLoc.set_config :default_param_name => 'new_param_name' + # and GLoc.set_config :default_cookie_name => 'new_cookie_name'. + def autodetect_language_filter(*args) + options= args.last.is_a?(Hash) ? args.last : {} + x= 'Proc.new { |c| l= nil;' + # :check_params + unless (v= options.delete(:check_params)) == false + name= v ? ":#{v}" : 'GLoc.get_config(:default_param_name)' + x << "l ||= GLoc.similar_language(c.params[#{name}]);" + end + # :check_cookie + unless (v= options.delete(:check_cookie)) == false + name= v ? ":#{v}" : 'GLoc.get_config(:default_cookie_name)' + x << "l ||= GLoc.similar_language(c.send(:cookies)[#{name}]);" + end + # :check_accept_header + unless options.delete(:check_accept_header) == false + x << %< + unless l + a= c.request.env['HTTP_ACCEPT_LANGUAGE'].split(/,|;/) rescue nil + a.each {|x| l ||= GLoc.similar_language(x)} if a + end; > + end + # Set language + x << 'ret= true;' + x << 'if l; c.set_language(l); c.headers[\'Content-Language\']= l.to_s; ' + if options.has_key?(:on_set_lang) + x << "ret= c.#{options.delete(:on_set_lang)}(l);" + end + if options.has_key?(:on_no_lang) + x << "else; ret= c.#{options.delete(:on_no_lang)};" + end + x << 'end; ret }' + + # Create filter + block= eval x + before_filter(*args, &block) + end + + end + end +end + +# ============================================================================== + +module ActionMailer #:nodoc: + # In addition to including GLoc, render_message is also overridden so + # that mail templates contain the current language at the end of the file. + # Eg. deliver_hello will render hello_en.rhtml. + class Base + include GLoc + private + alias :render_message_without_gloc :render_message + def render_message(method_name, body) + render_message_without_gloc("#{method_name}_#{current_language}", body) + end + end +end + +# ============================================================================== + +module ActionView #:nodoc: + # initialize is overridden so that new instances of this class inherit + # the current language of the controller. + class Base + include GLoc + + alias :initialize_without_gloc :initialize + def initialize(base_path = nil, assigns_for_first_render = {}, controller = nil) + initialize_without_gloc(base_path, assigns_for_first_render, controller) + set_language controller.current_language unless controller.nil? + end + end + + module Helpers #:nodoc: + class InstanceTag + include GLoc + # Inherits the current language from the template object. + def current_language + @template_object.current_language + end + end + end +end + +# ============================================================================== + +module ActiveRecord #:nodoc: + class Base #:nodoc: + include GLoc + end + + class Errors + include GLoc + alias :add_without_gloc :add + # The GLoc version of this method provides two extra features + # * If msg is a string, it will be considered a GLoc string key. + # * If msg is an array, the first element will be considered + # the string and the remaining elements will be considered arguments for the + # string. Eg. ['Hi %s.','John'] + def add(attribute, msg= @@default_error_messages[:invalid]) + if msg.is_a?(Array) + args= msg.clone + msg= args.shift + args= nil if args.empty? + end + msg= ltry(msg) + msg= msg % args unless args.nil? + add_without_gloc(attribute, msg) + end + # Inherits the current language from the base record. + def current_language + @base.current_language + end + end + + module Validations #:nodoc: + module ClassMethods + # The default Rails version of this function creates an error message and then + # passes it to ActiveRecord.Errors. + # The GLoc version of this method, sends an array to ActiveRecord.Errors that will + # be turned into a string by ActiveRecord.Errors which in turn allows for the message + # of this validation function to be a GLoc string key. + def validates_length_of(*attrs) + # Merge given options with defaults. + options = { + :too_long => ActiveRecord::Errors.default_error_messages[:too_long], + :too_short => ActiveRecord::Errors.default_error_messages[:too_short], + :wrong_length => ActiveRecord::Errors.default_error_messages[:wrong_length] + }.merge(DEFAULT_VALIDATION_OPTIONS) + options.update(attrs.pop.symbolize_keys) if attrs.last.is_a?(Hash) + + # Ensure that one and only one range option is specified. + range_options = ALL_RANGE_OPTIONS & options.keys + case range_options.size + when 0 + raise ArgumentError, 'Range unspecified. Specify the :within, :maximum, :minimum, or :is option.' + when 1 + # Valid number of options; do nothing. + else + raise ArgumentError, 'Too many range options specified. Choose only one.' + end + + # Get range option and value. + option = range_options.first + option_value = options[range_options.first] + + case option + when :within, :in + raise ArgumentError, ":#{option} must be a Range" unless option_value.is_a?(Range) + + too_short = [options[:too_short] , option_value.begin] + too_long = [options[:too_long] , option_value.end ] + + validates_each(attrs, options) do |record, attr, value| + if value.nil? or value.split(//).size < option_value.begin + record.errors.add(attr, too_short) + elsif value.split(//).size > option_value.end + record.errors.add(attr, too_long) + end + end + when :is, :minimum, :maximum + raise ArgumentError, ":#{option} must be a nonnegative Integer" unless option_value.is_a?(Integer) and option_value >= 0 + + # Declare different validations per option. + validity_checks = { :is => "==", :minimum => ">=", :maximum => "<=" } + message_options = { :is => :wrong_length, :minimum => :too_short, :maximum => :too_long } + + message = [(options[:message] || options[message_options[option]]) , option_value] + + validates_each(attrs, options) do |record, attr, value| + if value.kind_of?(String) + record.errors.add(attr, message) unless !value.nil? and value.split(//).size.method(validity_checks[option])[option_value] + else + record.errors.add(attr, message) unless !value.nil? and value.size.method(validity_checks[option])[option_value] + end + end + end + end + + alias_method :validates_size_of, :validates_length_of + end + end +end + +# ============================================================================== + +module ApplicationHelper #:nodoc: + include GLoc +end diff --git a/vendor/plugins/gloc-1.1.0/lib/gloc-ruby.rb b/vendor/plugins/gloc-1.1.0/lib/gloc-ruby.rb new file mode 100644 index 000000000..f96ab6cf9 --- /dev/null +++ b/vendor/plugins/gloc-1.1.0/lib/gloc-ruby.rb @@ -0,0 +1,7 @@ +# Copyright (c) 2005-2006 David Barri + +module Test # :nodoc: + module Unit # :nodoc: + class TestCase # :nodoc: + include GLoc +end; end; end diff --git a/vendor/plugins/gloc-1.1.0/lib/gloc-version.rb b/vendor/plugins/gloc-1.1.0/lib/gloc-version.rb new file mode 100644 index 000000000..91afcf482 --- /dev/null +++ b/vendor/plugins/gloc-1.1.0/lib/gloc-version.rb @@ -0,0 +1,12 @@ +module GLoc + module VERSION #:nodoc: + MAJOR = 1 + MINOR = 1 + TINY = nil + + STRING= [MAJOR, MINOR, TINY].delete_if{|x|x.nil?}.join('.') + def self.to_s; STRING end + end +end + +puts "NOTICE: You are using a dev version of GLoc." if GLoc::VERSION::TINY == 'DEV' \ No newline at end of file diff --git a/vendor/plugins/gloc-1.1.0/lib/gloc.rb b/vendor/plugins/gloc-1.1.0/lib/gloc.rb new file mode 100644 index 000000000..bcad0ed9b --- /dev/null +++ b/vendor/plugins/gloc-1.1.0/lib/gloc.rb @@ -0,0 +1,294 @@ +# Copyright (c) 2005-2006 David Barri + +require 'yaml' +require 'gloc-internal' +require 'gloc-helpers' + +module GLoc + UTF_8= 'utf-8' + SHIFT_JIS= 'sjis' + EUC_JP= 'euc-jp' + + # This module will be included in both instances and classes of GLoc includees. + # It is also included as class methods in the GLoc module itself. + module InstanceMethods + include Helpers + + # Returns a localized string. + def l(symbol, *arguments) + return GLoc._l(symbol,current_language,*arguments) + end + + # Returns a localized string in a specified language. + # This does not effect current_language. + def ll(lang, symbol, *arguments) + return GLoc._l(symbol,lang.to_sym,*arguments) + end + + # Returns a localized string if the argument is a Symbol, else just returns the argument. + def ltry(possible_key) + possible_key.is_a?(Symbol) ? l(possible_key) : possible_key + end + + # Uses the default GLoc rule to return a localized string. + # See lwr_() for more info. + def lwr(symbol, *arguments) + lwr_(:default, symbol, *arguments) + end + + # Uses a rule to return a localized string. + # A rule is a function that uses specified arguments to return a localization key prefix. + # The prefix is appended to the localization key originally specified, to create a new key which + # is then used to lookup a localized string. + def lwr_(rule, symbol, *arguments) + GLoc._l("#{symbol}#{GLoc::_l_rule(rule,current_language).call(*arguments)}",current_language,*arguments) + end + + # Returns true if a localized string with the specified key exists. + def l_has_string?(symbol) + return GLoc._l_has_string?(symbol,current_language) + end + + # Sets the current language for this instance/class. + # Setting the language of a class effects all instances unless the instance has its own language defined. + def set_language(language) + @gloc_language= language.nil? ? nil : language.to_sym + end + + # Sets the current language if the language passed is a valid language. + # If the language was valid, this method returns true else it will return false. + # Note that nil is not a valid language. + # See set_language(language) for more info. + def set_language_if_valid(language) + if GLoc.valid_language?(language) + set_language(language) + true + else + false + end + end + end + + #--------------------------------------------------------------------------- + # Instance + + include ::GLoc::InstanceMethods + # Returns the instance-level current language, or if not set, returns the class-level current language. + def current_language + @gloc_language || self.class.current_language + end + + #--------------------------------------------------------------------------- + # Class + + # All classes/modules that include GLoc will also gain these class methods. + # Notice that the GLoc::InstanceMethods module is also included. + module ClassMethods + include ::GLoc::InstanceMethods + # Returns the current language, or if not set, returns the GLoc current language. + def current_language + @gloc_language || GLoc.current_language + end + end + + def self.included(target) #:nodoc: + super + class << target + include ::GLoc::ClassMethods + end + end + + #--------------------------------------------------------------------------- + # GLoc module + + class << self + include ::GLoc::InstanceMethods + + # Returns the default language + def current_language + GLoc::CONFIG[:default_language] + end + + # Adds a collection of localized strings to the in-memory string store. + def add_localized_strings(lang, symbol_hash, override=true, strings_charset=nil) + _verbose_msg {"Adding #{symbol_hash.size} #{lang} strings."} + _add_localized_strings(lang, symbol_hash, override, strings_charset) + _verbose_msg :stats + end + + # Creates a backup of the internal state of GLoc (ie. strings, langs, rules, config) + # and optionally clears everything. + def backup_state(clear=false) + s= _get_internal_state_vars.map{|o| o.clone} + _get_internal_state_vars.each{|o| o.clear} if clear + s + end + + # Removes all localized strings from memory, either of a certain language (or languages), + # or entirely. + def clear_strings(*languages) + if languages.empty? + _verbose_msg {"Clearing all strings"} + LOCALIZED_STRINGS.clear + LOWERCASE_LANGUAGES.clear + else + languages.each {|l| + _verbose_msg {"Clearing :#{l} strings"} + l= l.to_sym + LOCALIZED_STRINGS.delete l + LOWERCASE_LANGUAGES.each_pair {|k,v| LOWERCASE_LANGUAGES.delete k if v == l} + } + end + end + alias :_clear_strings :clear_strings + + # Removes all localized strings from memory, except for those of certain specified languages. + def clear_strings_except(*languages) + clear= (LOCALIZED_STRINGS.keys - languages) + _clear_strings(*clear) unless clear.empty? + end + + # Returns the charset used to store localized strings in memory. + def get_charset(lang) + CONFIG[:internal_charset_per_lang][lang] || CONFIG[:internal_charset] + end + + # Returns a GLoc configuration value. + def get_config(key) + CONFIG[key] + end + + # Loads the localized strings that are included in the GLoc library. + def load_gloc_default_localized_strings(override=false) + GLoc.load_localized_strings "#{File.dirname(__FILE__)}/../lang", override + end + + # Loads localized strings from all yml files in the specifed directory. + def load_localized_strings(dir=nil, override=true) + _charset_required + _get_lang_file_list(dir).each {|filename| + + # Load file + raw_hash = YAML::load(File.read(filename)) + raw_hash={} unless raw_hash.kind_of?(Hash) + filename =~ /([^\/\\]+)\.ya?ml$/ + lang = $1.to_sym + file_charset = raw_hash['file_charset'] || UTF_8 + + # Convert string keys to symbols + dest_charset= get_charset(lang) + _verbose_msg {"Reading file #{filename} [charset: #{file_charset} --> #{dest_charset}]"} + symbol_hash = {} + Iconv.open(dest_charset, file_charset) do |i| + raw_hash.each {|key, value| + symbol_hash[key.to_sym] = i.iconv(value) + } + end + + # Add strings to repos + _add_localized_strings(lang, symbol_hash, override) + } + _verbose_msg :stats + end + + # Restores a backup of GLoc's internal state that was made with backup_state. + def restore_state(state) + _get_internal_state_vars.each do |o| + o.clear + o.send o.respond_to?(:merge!) ? :merge! : :concat, state.shift + end + end + + # Sets the charset used to internally store localized strings. + # You can set the charset to use for a specific language or languages, + # or if none are specified the charset for ALL localized strings will be set. + def set_charset(new_charset, *langs) + CONFIG[:internal_charset_per_lang] ||= {} + + # Convert symbol shortcuts + if new_charset.is_a?(Symbol) + new_charset= case new_charset + when :utf8, :utf_8 then UTF_8 + when :sjis, :shift_jis, :shiftjis then SHIFT_JIS + when :eucjp, :euc_jp then EUC_JP + else new_charset.to_s + end + end + + # Convert existing strings + (langs.empty? ? LOCALIZED_STRINGS.keys : langs).each do |lang| + cur_charset= get_charset(lang) + if cur_charset && new_charset != cur_charset + _verbose_msg {"Converting :#{lang} strings from #{cur_charset} to #{new_charset}"} + Iconv.open(new_charset, cur_charset) do |i| + bundle= LOCALIZED_STRINGS[lang] + bundle.each_pair {|k,v| bundle[k]= i.iconv(v)} + end + end + end + + # Set new charset value + if langs.empty? + _verbose_msg {"Setting GLoc charset for all languages to #{new_charset}"} + CONFIG[:internal_charset]= new_charset + CONFIG[:internal_charset_per_lang].clear + else + langs.each do |lang| + _verbose_msg {"Setting GLoc charset for :#{lang} strings to #{new_charset}"} + CONFIG[:internal_charset_per_lang][lang]= new_charset + end + end + end + + # Sets GLoc configuration values. + def set_config(hash) + CONFIG.merge! hash + end + + # Sets the $KCODE global variable according to a specified charset, or else the + # current default charset for the default language. + def set_kcode(charset=nil) + _charset_required + charset ||= get_charset(current_language) + $KCODE= case charset + when UTF_8 then 'u' + when SHIFT_JIS then 's' + when EUC_JP then 'e' + else 'n' + end + _verbose_msg {"$KCODE set to #{$KCODE}"} + end + + # Tries to find a valid language that is similar to the argument passed. + # Eg. :en, :en_au, :EN_US are all similar languages. + # Returns nil if no similar languages are found. + def similar_language(lang) + return nil if lang.nil? + return lang.to_sym if valid_language?(lang) + # Check lowercase without dashes + lang= lang.to_s.downcase.gsub('-','_') + return LOWERCASE_LANGUAGES[lang] if LOWERCASE_LANGUAGES.has_key?(lang) + # Check without dialect + if lang.to_s =~ /^([a-z]+?)[^a-z].*/ + lang= $1 + return LOWERCASE_LANGUAGES[lang] if LOWERCASE_LANGUAGES.has_key?(lang) + end + # Check other dialects + lang= "#{lang}_" + LOWERCASE_LANGUAGES.keys.each {|k| return LOWERCASE_LANGUAGES[k] if k.starts_with?(lang)} + # Nothing found + nil + end + + # Returns an array of (currently) valid languages (ie. languages for which localized data exists). + def valid_languages + LOCALIZED_STRINGS.keys + end + + # Returns true if there are any localized strings for a specified language. + # Note that although set_langauge nil is perfectly valid, nil is not a valid language. + def valid_language?(language) + LOCALIZED_STRINGS.has_key? language.to_sym rescue false + end + end +end diff --git a/vendor/plugins/gloc-1.1.0/tasks/gloc.rake b/vendor/plugins/gloc-1.1.0/tasks/gloc.rake new file mode 100644 index 000000000..8da73779e --- /dev/null +++ b/vendor/plugins/gloc-1.1.0/tasks/gloc.rake @@ -0,0 +1,30 @@ +namespace :gloc do + desc 'Sorts the keys in the lang ymls' + task :sort do + dir = ENV['DIR'] || '{.,vendor/plugins/*}/lang' + puts "Processing directory #{dir}" + files = Dir.glob(File.join(dir,'*.{yaml,yml}')) + puts 'No files found.' if files.empty? + files.each {|file| + puts "Sorting file: #{file}" + header = [] + content = IO.readlines(file) + content.each {|line| line.gsub!(/[\s\r\n\t]+$/,'')} + content.delete_if {|line| line==''} + tmp= [] + content.each {|x| tmp << x unless tmp.include?(x)} + content= tmp + header << content.shift if !content.empty? && content[0] =~ /^file_charset:/ + content.sort! + filebak = "#{file}.bak" + File.rename file, filebak + File.open(file, 'w') {|fout| fout << header.join("\n") << content.join("\n") << "\n"} + File.delete filebak + # Report duplicates + count= {} + content.map {|x| x.gsub(/:.+$/, '') }.each {|x| count[x] ||= 0; count[x] += 1} + count.delete_if {|k,v|v==1} + puts count.keys.sort.map{|x|" WARNING: Duplicate key '#{x}' (#{count[x]} occurances)"}.join("\n") unless count.empty? + } + end +end \ No newline at end of file diff --git a/vendor/plugins/gloc-1.1.0/test/gloc_rails_test.rb b/vendor/plugins/gloc-1.1.0/test/gloc_rails_test.rb new file mode 100644 index 000000000..4cb232904 --- /dev/null +++ b/vendor/plugins/gloc-1.1.0/test/gloc_rails_test.rb @@ -0,0 +1,118 @@ +# Copyright (c) 2005-2006 David Barri + +$LOAD_PATH.push File.join(File.dirname(__FILE__),'..','lib') +require "#{File.dirname(__FILE__)}/../../../../test/test_helper" +require "#{File.dirname(__FILE__)}/../init" + +class GLocRailsTestController < ActionController::Base + autodetect_language_filter :only => :auto, :on_set_lang => :called_when_set, :on_no_lang => :called_when_bad + autodetect_language_filter :only => :auto2, :check_accept_header => false, :check_params => 'xx' + autodetect_language_filter :only => :auto3, :check_cookie => false + autodetect_language_filter :only => :auto4, :check_cookie => 'qwe', :check_params => false + def rescue_action(e) raise e end + def auto; render :text => 'auto'; end + def auto2; render :text => 'auto'; end + def auto3; render :text => 'auto'; end + def auto4; render :text => 'auto'; end + attr_accessor :callback_set, :callback_bad + def called_when_set(l) @callback_set ||= 0; @callback_set += 1 end + def called_when_bad; @callback_bad ||= 0; @callback_bad += 1 end +end + +class GLocRailsTest < Test::Unit::TestCase + + def setup + @lstrings = GLoc::LOCALIZED_STRINGS.clone + @old_config= GLoc::CONFIG.clone + begin_new_request + end + + def teardown + GLoc.clear_strings + GLoc::LOCALIZED_STRINGS.merge! @lstrings + GLoc::CONFIG.merge! @old_config + end + + def begin_new_request + @controller = GLocRailsTestController.new + @request = ActionController::TestRequest.new + @response = ActionController::TestResponse.new + end + + def test_autodetect_language + GLoc::CONFIG[:default_language]= :def + GLoc::CONFIG[:default_param_name] = 'plang' + GLoc::CONFIG[:default_cookie_name] = 'clang' + GLoc.clear_strings + GLoc.add_localized_strings :en, :a => 'a' + GLoc.add_localized_strings :en_au, :a => 'a' + GLoc.add_localized_strings :en_US, :a => 'a' + GLoc.add_localized_strings :Ja, :a => 'a' + GLoc.add_localized_strings :ZH_HK, :a => 'a' + + # default + subtest_autodetect_language :def, nil, nil, nil + subtest_autodetect_language :def, 'its', 'all', 'bullshit,man;q=zxc' + # simple + subtest_autodetect_language :en_au, 'en_au', nil, nil + subtest_autodetect_language :en_US, nil, 'en_us', nil + subtest_autodetect_language :Ja, nil, nil, 'ja' + # priority + subtest_autodetect_language :Ja, 'ja', 'en_us', 'qwe_ja,zh,monkey_en;q=0.5' + subtest_autodetect_language :en_US, 'why', 'en_us', 'qwe_ja,zh,monkey_en;q=0.5' + subtest_autodetect_language :Ja, nil, nil, 'qwe_en,JA,zh,monkey_en;q=0.5' + # dashes to underscores in accept string + subtest_autodetect_language :en_au, 'monkey', nil, 'de,EN-Au' + # remove dialect + subtest_autodetect_language :en, nil, 'en-bullshit', nil + subtest_autodetect_language :en, 'monkey', nil, 'de,EN-NZ,ja' + # different dialect + subtest_autodetect_language :ZH_HK, 'zh', nil, 'de,EN-NZ,ja' + subtest_autodetect_language :ZH_HK, 'monkey', 'zh', 'de,EN-NZ,ja' + + # Check param/cookie names use defaults + GLoc::CONFIG[:default_param_name] = 'p_lang' + GLoc::CONFIG[:default_cookie_name] = 'c_lang' + # :check_params + subtest_autodetect_language :def, 'en_au', nil, nil + subtest_autodetect_language :en_au, {:p_lang => 'en_au'}, nil, nil + # :check_cookie + subtest_autodetect_language :def, nil, 'en_us', nil + subtest_autodetect_language :en_US, nil, {:c_lang => 'en_us'}, nil + GLoc::CONFIG[:default_param_name] = 'plang' + GLoc::CONFIG[:default_cookie_name] = 'clang' + + # autodetect_language_filter :only => :auto2, :check_accept_header => false, :check_params => 'xx' + subtest_autodetect_language :def, 'ja', nil, 'en_US', :auto2 + subtest_autodetect_language :Ja, {:xx => 'ja'}, nil, 'en_US', :auto2 + subtest_autodetect_language :en_au, 'ja', 'en_au', 'en_US', :auto2 + + # autodetect_language_filter :only => :auto3, :check_cookie => false + subtest_autodetect_language :Ja, 'ja', 'en_us', 'qwe_ja,zh,monkey_en;q=0.5', :auto3 + subtest_autodetect_language :ZH_HK, 'hehe', 'en_us', 'qwe_ja,zh,monkey_en;q=0.5', :auto3 + + # autodetect_language_filter :only => :auto4, :check_cookie => 'qwe', :check_params => false + subtest_autodetect_language :def, 'ja', 'en_us', nil, :auto4 + subtest_autodetect_language :ZH_HK, 'ja', 'en_us', 'qwe_ja,zh,monkey_en;q=0.5', :auto4 + subtest_autodetect_language :en_US, 'ja', {:qwe => 'en_us'}, 'ja', :auto4 + end + + def subtest_autodetect_language(expected,params,cookie,accept, action=:auto) + begin_new_request + params= {'plang' => params} if params.is_a?(String) + params ||= {} + if cookie + cookie={'clang' => cookie} unless cookie.is_a?(Hash) + cookie.each_pair {|k,v| @request.cookies[k.to_s]= CGI::Cookie.new(k.to_s,v)} + end + @request.env['HTTP_ACCEPT_LANGUAGE']= accept + get action, params + assert_equal expected, @controller.current_language + if action == :auto + s,b = expected != :def ? [1,nil] : [nil,1] + assert_equal s, @controller.callback_set + assert_equal b, @controller.callback_bad + end + end + +end \ No newline at end of file diff --git a/vendor/plugins/gloc-1.1.0/test/gloc_test.rb b/vendor/plugins/gloc-1.1.0/test/gloc_test.rb new file mode 100644 index 000000000..a39d5c41c --- /dev/null +++ b/vendor/plugins/gloc-1.1.0/test/gloc_test.rb @@ -0,0 +1,433 @@ +# Copyright (c) 2005-2006 David Barri + +$LOAD_PATH.push File.join(File.dirname(__FILE__),'..','lib') +require 'gloc' +require 'gloc-ruby' +require 'gloc-config' +require 'gloc-rails-text' +require File.join(File.dirname(__FILE__),'lib','rails-time_ext') unless 3.respond_to?(:days) +require File.join(File.dirname(__FILE__),'lib','rails-string_ext') unless ''.respond_to?(:starts_with?) +#require 'gloc-dev' + +class LClass; include GLoc; end +class LClass2 < LClass; end +class LClass_en < LClass2; set_language :en; end +class LClass_ja < LClass2; set_language :ja; end +# class LClass_forced_au < LClass; set_language :en; force_language :en_AU; set_language :ja; end + +class GLocTest < Test::Unit::TestCase + include GLoc + include ActionView::Helpers::DateHelper + + def setup + @l1 = LClass.new + @l2 = LClass.new + @l3 = LClass.new + @l1.set_language :ja + @l2.set_language :en + @l3.set_language 'en_AU' + @gloc_state= GLoc.backup_state true + GLoc::CONFIG.merge!({ + :default_param_name => 'lang', + :default_cookie_name => 'lang', + :default_language => :ja, + :raise_string_not_found_errors => true, + :verbose => false, + }) + end + + def teardown + GLoc.restore_state @gloc_state + end + + #--------------------------------------------------------------------------- + + def test_basic + assert_localized_value [nil, @l1, @l2, @l3], nil, :in_both_langs + + GLoc.load_localized_strings File.join(File.dirname(__FILE__),'lang') + + assert_localized_value [nil, @l1], 'enにもjaにもある', :in_both_langs + assert_localized_value [nil, @l1], '日本語のみ', :ja_only + assert_localized_value [nil, @l1], nil, :en_only + + assert_localized_value @l2, 'This is in en+ja', :in_both_langs + assert_localized_value @l2, nil, :ja_only + assert_localized_value @l2, 'English only', :en_only + + assert_localized_value @l3, "Thiz in en 'n' ja", :in_both_langs + assert_localized_value @l3, nil, :ja_only + assert_localized_value @l3, 'Aussie English only bro', :en_only + + @l3.set_language :en + assert_localized_value @l3, 'This is in en+ja', :in_both_langs + assert_localized_value @l3, nil, :ja_only + assert_localized_value @l3, 'English only', :en_only + + assert_localized_value nil, 'enにもjaにもある', :in_both_langs + assert_localized_value nil, '日本語のみ', :ja_only + assert_localized_value nil, nil, :en_only + end + + def test_load_twice_with_override + GLoc.load_localized_strings File.join(File.dirname(__FILE__),'lang') + GLoc.load_localized_strings File.join(File.dirname(__FILE__),'lang2') + + assert_localized_value [nil, @l1], '更新された', :in_both_langs + assert_localized_value [nil, @l1], '日本語のみ', :ja_only + assert_localized_value [nil, @l1], nil, :en_only + assert_localized_value [nil, @l1], nil, :new_en + assert_localized_value [nil, @l1], '新たな日本語ストリング', :new_ja + + assert_localized_value @l2, 'This is in en+ja', :in_both_langs + assert_localized_value @l2, nil, :ja_only + assert_localized_value @l2, 'overriden dude', :en_only + assert_localized_value @l2, 'This is a new English string', :new_en + assert_localized_value @l2, nil, :new_ja + + assert_localized_value @l3, "Thiz in en 'n' ja", :in_both_langs + assert_localized_value @l3, nil, :ja_only + assert_localized_value @l3, 'Aussie English only bro', :en_only + end + + def test_load_twice_without_override + GLoc.load_localized_strings File.join(File.dirname(__FILE__),'lang') + GLoc.load_localized_strings File.join(File.dirname(__FILE__),'lang2'), false + + assert_localized_value [nil, @l1], 'enにもjaにもある', :in_both_langs + assert_localized_value [nil, @l1], '日本語のみ', :ja_only + assert_localized_value [nil, @l1], nil, :en_only + assert_localized_value [nil, @l1], nil, :new_en + assert_localized_value [nil, @l1], '新たな日本語ストリング', :new_ja + + assert_localized_value @l2, 'This is in en+ja', :in_both_langs + assert_localized_value @l2, nil, :ja_only + assert_localized_value @l2, 'English only', :en_only + assert_localized_value @l2, 'This is a new English string', :new_en + assert_localized_value @l2, nil, :new_ja + + assert_localized_value @l3, "Thiz in en 'n' ja", :in_both_langs + assert_localized_value @l3, nil, :ja_only + assert_localized_value @l3, 'Aussie English only bro', :en_only + end + + def test_add_localized_strings + assert_localized_value nil, nil, :add + assert_localized_value nil, nil, :ja_only + GLoc.load_localized_strings File.join(File.dirname(__FILE__),'lang') + assert_localized_value nil, nil, :add + assert_localized_value nil, '日本語のみ', :ja_only + GLoc.add_localized_strings 'en', {:ja_only => 'bullshit'}, true + GLoc.add_localized_strings 'en', {:ja_only => 'bullshit'}, false + assert_localized_value nil, nil, :add + assert_localized_value nil, '日本語のみ', :ja_only + GLoc.add_localized_strings 'ja', {:ja_only => 'bullshit', :add => '123'}, false + assert_localized_value nil, '123', :add + assert_localized_value nil, '日本語のみ', :ja_only + GLoc.add_localized_strings 'ja', {:ja_only => 'bullshit', :add => '234'} + assert_localized_value nil, '234', :add + assert_localized_value nil, 'bullshit', :ja_only + end + + def test_class_set_language + GLoc.load_localized_strings File.join(File.dirname(__FILE__),'lang') + + @l1 = LClass_ja.new + @l2 = LClass_en.new + @l3 = LClass_en.new + + assert_localized_value @l1, 'enにもjaにもある', :in_both_langs + assert_localized_value @l2, 'This is in en+ja', :in_both_langs + assert_localized_value @l3, 'This is in en+ja', :in_both_langs + + @l3.set_language 'en_AU' + + assert_localized_value @l1, 'enにもjaにもある', :in_both_langs + assert_localized_value @l2, 'This is in en+ja', :in_both_langs + assert_localized_value @l3, "Thiz in en 'n' ja", :in_both_langs + end + + def test_ll + GLoc.load_localized_strings File.join(File.dirname(__FILE__),'lang') + + assert_equal 'enにもjaにもある', ll('ja',:in_both_langs) + assert_equal 'enにもjaにもある', GLoc::ll('ja',:in_both_langs) + assert_equal 'enにもjaにもある', LClass_en.ll('ja',:in_both_langs) + assert_equal 'enにもjaにもある', LClass_ja.ll('ja',:in_both_langs) + + assert_equal 'This is in en+ja', ll('en',:in_both_langs) + assert_equal 'This is in en+ja', GLoc::ll('en',:in_both_langs) + assert_equal 'This is in en+ja', LClass_en.ll('en',:in_both_langs) + assert_equal 'This is in en+ja', LClass_ja.ll('en',:in_both_langs) + end + + def test_lsym + GLoc.load_localized_strings File.join(File.dirname(__FILE__),'lang') + assert_equal 'enにもjaにもある', LClass_ja.ltry(:in_both_langs) + assert_equal 'hello', LClass_ja.ltry('hello') + assert_equal nil, LClass_ja.ltry(nil) + end + +# def test_forced +# assert_equal :en_AU, LClass_forced_au.current_language +# a= LClass_forced_au.new +# a.set_language :ja +# assert_equal :en_AU, a.current_language +# a.force_language :ja +# assert_equal :ja, a.current_language +# assert_equal :en_AU, LClass_forced_au.current_language +# end + + def test_pluralization + GLoc.add_localized_strings :en, :_gloc_rule_default => %[|n| case n; when 0 then '_none'; when 1 then '_single'; else '_many'; end], :a_single => '%d man', :a_many => '%d men', :a_none => 'No men' + GLoc.add_localized_strings :en, :_gloc_rule_asd => %[|n| n<10 ? '_few' : '_heaps'], :a_few => 'a few men (%d)', :a_heaps=> 'soo many men' + set_language :en + + assert_equal 'No men', lwr(:a, 0) + assert_equal '1 man', lwr(:a, 1) + assert_equal '3 men', lwr(:a, 3) + assert_equal '20 men', lwr(:a, 20) + + assert_equal 'a few men (0)', lwr_(:asd, :a, 0) + assert_equal 'a few men (1)', lwr_(:asd, :a, 1) + assert_equal 'a few men (3)', lwr_(:asd, :a, 3) + assert_equal 'soo many men', lwr_(:asd, :a, 12) + assert_equal 'soo many men', lwr_(:asd, :a, 20) + + end + + def test_distance_in_words + load_default_strings + [ + [20.seconds, 'less than a minute', '1分以内', 'меньше минуты'], + [80.seconds, '1 minute', '1分', '1 минуту'], + [3.seconds, 'less than 5 seconds', '5秒以内', 'менее 5 секунд', true], + [9.seconds, 'less than 10 seconds', '10秒以内', 'менее 10 секунд', true], + [16.seconds, 'less than 20 seconds', '20秒以内', 'менее 20 секунд', true], + [35.seconds, 'half a minute', '約30秒', 'полминуты', true], + [50.seconds, 'less than a minute', '1分以内', 'меньше минуты', true], + [1.1.minutes, '1 minute', '1分', '1 минуту'], + [2.1.minutes, '2 minutes', '2分', '2 минуты'], + [4.1.minutes, '4 minutes', '4分', '4 минуты'], + [5.1.minutes, '5 minutes', '5分', '5 минут'], + [1.1.hours, 'about an hour', '約1時間', 'около часа'], + [3.1.hours, 'about 3 hours', '約3時間', 'около 3 часов'], + [9.1.hours, 'about 9 hours', '約9時間', 'около 9 часов'], + [1.1.days, '1 day', '1日間', '1 день'], + [2.1.days, '2 days', '2日間', '2 дня'], + [4.days, '4 days', '4日間', '4 дня'], + [6.days, '6 days', '6日間', '6 дней'], + [11.days, '11 days', '11日間', '11 дней'], + [12.days, '12 days', '12日間', '12 дней'], + [15.days, '15 days', '15日間', '15 дней'], + [20.days, '20 days', '20日間', '20 дней'], + [21.days, '21 days', '21日間', '21 день'], + [22.days, '22 days', '22日間', '22 дня'], + [25.days, '25 days', '25日間', '25 дней'], + ].each do |a| + t, en, ja, ru = a + inc_sec= (a.size == 5) ? a[-1] : false + set_language :en + assert_equal en, distance_of_time_in_words(t,0,inc_sec) + set_language :ja + assert_equal ja, distance_of_time_in_words(t,0,inc_sec) + set_language :ru + assert_equal ru, distance_of_time_in_words(t,0,inc_sec) + end + end + + def test_age + load_default_strings + [ + [1, '1 yr', '1歳', '1 год'], + [22, '22 yrs', '22歳', '22 года'], + [27, '27 yrs', '27歳', '27 лет'], + ].each do |a, en, ja, ru| + set_language :en + assert_equal en, l_age(a) + set_language :ja + assert_equal ja, l_age(a) + set_language :ru + assert_equal ru, l_age(a) + end + end + + def test_yesno + load_default_strings + set_language :en + assert_equal 'yes', l_yesno(true) + assert_equal 'no', l_yesno(false) + assert_equal 'Yes', l_YesNo(true) + assert_equal 'No', l_YesNo(false) + end + + def test_all_languages_have_values_for_helpers + load_default_strings + t= Time.local(2000, 9, 15, 11, 23, 57) + GLoc.valid_languages.each {|l| + set_language l + 0.upto(120) {|n| l_age(n)} + l_date(t) + l_datetime(t) + l_datetime_short(t) + l_time(t) + [true,false].each{|v| l_YesNo(v); l_yesno(v) } + } + end + + def test_similar_languages + GLoc.add_localized_strings :en, :a => 'a' + GLoc.add_localized_strings :en_AU, :a => 'a' + GLoc.add_localized_strings :ja, :a => 'a' + GLoc.add_localized_strings :zh_tw, :a => 'a' + + assert_equal :en, GLoc.similar_language(:en) + assert_equal :en, GLoc.similar_language('en') + assert_equal :ja, GLoc.similar_language(:ja) + assert_equal :ja, GLoc.similar_language('ja') + # lowercase + dashes to underscores + assert_equal :en, GLoc.similar_language('EN') + assert_equal :en, GLoc.similar_language(:EN) + assert_equal :en_AU, GLoc.similar_language(:EN_Au) + assert_equal :en_AU, GLoc.similar_language('eN-Au') + # remove dialect + assert_equal :ja, GLoc.similar_language(:ja_Au) + assert_equal :ja, GLoc.similar_language('JA-ASDF') + assert_equal :ja, GLoc.similar_language('jA_ASD_ZXC') + # different dialect + assert_equal :zh_tw, GLoc.similar_language('ZH') + assert_equal :zh_tw, GLoc.similar_language('ZH_HK') + assert_equal :zh_tw, GLoc.similar_language('ZH-BUL') + # non matching + assert_equal nil, GLoc.similar_language('WW') + assert_equal nil, GLoc.similar_language('WW_AU') + assert_equal nil, GLoc.similar_language('WW-AU') + assert_equal nil, GLoc.similar_language('eZ_en') + assert_equal nil, GLoc.similar_language('AU-ZH') + end + + def test_clear_strings_and_similar_langs + GLoc.add_localized_strings :en, :a => 'a' + GLoc.add_localized_strings :en_AU, :a => 'a' + GLoc.add_localized_strings :ja, :a => 'a' + GLoc.add_localized_strings :zh_tw, :a => 'a' + GLoc.clear_strings :en, :ja + assert_equal nil, GLoc.similar_language('ja') + assert_equal :en_AU, GLoc.similar_language('en') + assert_equal :zh_tw, GLoc.similar_language('ZH_HK') + GLoc.clear_strings + assert_equal nil, GLoc.similar_language('ZH_HK') + end + + def test_lang_name + GLoc.add_localized_strings :en, :general_lang_en => 'English', :general_lang_ja => 'Japanese' + GLoc.add_localized_strings :ja, :general_lang_en => '英語', :general_lang_ja => '日本語' + set_language :en + assert_equal 'Japanese', l_lang_name(:ja) + assert_equal 'English', l_lang_name('en') + set_language :ja + assert_equal '日本語', l_lang_name('ja') + assert_equal '英語', l_lang_name(:en) + end + + def test_charset_change_all + load_default_strings + GLoc.add_localized_strings :ja2, :a => 'a' + GLoc.valid_languages # Force refresh if in dev mode + GLoc.class_eval 'LOCALIZED_STRINGS[:ja2]= LOCALIZED_STRINGS[:ja].clone' + + [:ja, :ja2].each do |l| + set_language l + assert_equal 'はい', l_yesno(true) + assert_equal "E381AFE38184", l_yesno(true).unpack('H*')[0].upcase + end + + GLoc.set_charset 'sjis' + assert_equal 'sjis', GLoc.get_charset(:ja) + assert_equal 'sjis', GLoc.get_charset(:ja2) + + [:ja, :ja2].each do |l| + set_language l + assert_equal "82CD82A2", l_yesno(true).unpack('H*')[0].upcase + end + end + + def test_charset_change_single + load_default_strings + GLoc.add_localized_strings :ja2, :a => 'a' + GLoc.add_localized_strings :ja3, :a => 'a' + GLoc.valid_languages # Force refresh if in dev mode + GLoc.class_eval 'LOCALIZED_STRINGS[:ja2]= LOCALIZED_STRINGS[:ja].clone' + GLoc.class_eval 'LOCALIZED_STRINGS[:ja3]= LOCALIZED_STRINGS[:ja].clone' + + [:ja, :ja2, :ja3].each do |l| + set_language l + assert_equal 'はい', l_yesno(true) + assert_equal "E381AFE38184", l_yesno(true).unpack('H*')[0].upcase + end + + GLoc.set_charset 'sjis', :ja + assert_equal 'sjis', GLoc.get_charset(:ja) + assert_equal 'utf-8', GLoc.get_charset(:ja2) + assert_equal 'utf-8', GLoc.get_charset(:ja3) + + set_language :ja + assert_equal "82CD82A2", l_yesno(true).unpack('H*')[0].upcase + set_language :ja2 + assert_equal "E381AFE38184", l_yesno(true).unpack('H*')[0].upcase + set_language :ja3 + assert_equal "E381AFE38184", l_yesno(true).unpack('H*')[0].upcase + + GLoc.set_charset 'euc-jp', :ja, :ja3 + assert_equal 'euc-jp', GLoc.get_charset(:ja) + assert_equal 'utf-8', GLoc.get_charset(:ja2) + assert_equal 'euc-jp', GLoc.get_charset(:ja3) + + set_language :ja + assert_equal "A4CFA4A4", l_yesno(true).unpack('H*')[0].upcase + set_language :ja2 + assert_equal "E381AFE38184", l_yesno(true).unpack('H*')[0].upcase + set_language :ja3 + assert_equal "A4CFA4A4", l_yesno(true).unpack('H*')[0].upcase + end + + def test_set_language_if_valid + GLoc.add_localized_strings :en, :a => 'a' + GLoc.add_localized_strings :zh_tw, :a => 'a' + + assert set_language_if_valid('en') + assert_equal :en, current_language + + assert set_language_if_valid('zh_tw') + assert_equal :zh_tw, current_language + + assert !set_language_if_valid(nil) + assert_equal :zh_tw, current_language + + assert !set_language_if_valid('ja') + assert_equal :zh_tw, current_language + + assert set_language_if_valid(:en) + assert_equal :en, current_language + end + + #=========================================================================== + protected + + def assert_localized_value(objects,expected,key) + objects = [objects] unless objects.kind_of?(Array) + objects.each {|object| + o = object || GLoc + assert_equal !expected.nil?, o.l_has_string?(key) + if expected.nil? + assert_raise(GLoc::StringNotFoundError) {o.l(key)} + else + assert_equal expected, o.l(key) + end + } + end + + def load_default_strings + GLoc.load_localized_strings File.join(File.dirname(__FILE__),'..','lang') + end +end \ No newline at end of file diff --git a/vendor/plugins/gloc-1.1.0/test/lang/en.yaml b/vendor/plugins/gloc-1.1.0/test/lang/en.yaml new file mode 100644 index 000000000..325dc599e --- /dev/null +++ b/vendor/plugins/gloc-1.1.0/test/lang/en.yaml @@ -0,0 +1,2 @@ +in_both_langs: This is in en+ja +en_only: English only \ No newline at end of file diff --git a/vendor/plugins/gloc-1.1.0/test/lang/en_AU.yaml b/vendor/plugins/gloc-1.1.0/test/lang/en_AU.yaml new file mode 100644 index 000000000..307cc7859 --- /dev/null +++ b/vendor/plugins/gloc-1.1.0/test/lang/en_AU.yaml @@ -0,0 +1,2 @@ +in_both_langs: Thiz in en 'n' ja +en_only: Aussie English only bro \ No newline at end of file diff --git a/vendor/plugins/gloc-1.1.0/test/lang/ja.yml b/vendor/plugins/gloc-1.1.0/test/lang/ja.yml new file mode 100644 index 000000000..64df03376 --- /dev/null +++ b/vendor/plugins/gloc-1.1.0/test/lang/ja.yml @@ -0,0 +1,2 @@ +in_both_langs: enにもjaにもある +ja_only: 日本語のみ \ No newline at end of file diff --git a/vendor/plugins/gloc-1.1.0/test/lang2/en.yml b/vendor/plugins/gloc-1.1.0/test/lang2/en.yml new file mode 100644 index 000000000..e6467e7a0 --- /dev/null +++ b/vendor/plugins/gloc-1.1.0/test/lang2/en.yml @@ -0,0 +1,2 @@ +en_only: overriden dude +new_en: This is a new English string \ No newline at end of file diff --git a/vendor/plugins/gloc-1.1.0/test/lang2/ja.yaml b/vendor/plugins/gloc-1.1.0/test/lang2/ja.yaml new file mode 100644 index 000000000..864b287d0 --- /dev/null +++ b/vendor/plugins/gloc-1.1.0/test/lang2/ja.yaml @@ -0,0 +1,2 @@ +in_both_langs: 更新された +new_ja: 新たな日本語ストリング \ No newline at end of file diff --git a/vendor/plugins/gloc-1.1.0/test/lib/rails-string_ext.rb b/vendor/plugins/gloc-1.1.0/test/lib/rails-string_ext.rb new file mode 100644 index 000000000..418d28db2 --- /dev/null +++ b/vendor/plugins/gloc-1.1.0/test/lib/rails-string_ext.rb @@ -0,0 +1,23 @@ +module ActiveSupport #:nodoc: + module CoreExtensions #:nodoc: + module String #:nodoc: + # Additional string tests. + module StartsEndsWith + # Does the string start with the specified +prefix+? + def starts_with?(prefix) + prefix = prefix.to_s + self[0, prefix.length] == prefix + end + + # Does the string end with the specified +suffix+? + def ends_with?(suffix) + suffix = suffix.to_s + self[-suffix.length, suffix.length] == suffix + end + end + end + end +end +class String + include ActiveSupport::CoreExtensions::String::StartsEndsWith +end \ No newline at end of file diff --git a/vendor/plugins/gloc-1.1.0/test/lib/rails-time_ext.rb b/vendor/plugins/gloc-1.1.0/test/lib/rails-time_ext.rb new file mode 100644 index 000000000..d8771e4e6 --- /dev/null +++ b/vendor/plugins/gloc-1.1.0/test/lib/rails-time_ext.rb @@ -0,0 +1,76 @@ +module ActiveSupport #:nodoc: + module CoreExtensions #:nodoc: + module Numeric #:nodoc: + # Enables the use of time calculations and declarations, like 45.minutes + 2.hours + 4.years. + # + # If you need precise date calculations that doesn't just treat months as 30 days, then have + # a look at Time#advance. + # + # Some of these methods are approximations, Ruby's core + # Date[http://stdlib.rubyonrails.org/libdoc/date/rdoc/index.html] and + # Time[http://stdlib.rubyonrails.org/libdoc/time/rdoc/index.html] should be used for precision + # date and time arithmetic + module Time + def seconds + self + end + alias :second :seconds + + def minutes + self * 60 + end + alias :minute :minutes + + def hours + self * 60.minutes + end + alias :hour :hours + + def days + self * 24.hours + end + alias :day :days + + def weeks + self * 7.days + end + alias :week :weeks + + def fortnights + self * 2.weeks + end + alias :fortnight :fortnights + + def months + self * 30.days + end + alias :month :months + + def years + (self * 365.25.days).to_i + end + alias :year :years + + # Reads best without arguments: 10.minutes.ago + def ago(time = ::Time.now) + time - self + end + + # Reads best with argument: 10.minutes.until(time) + alias :until :ago + + # Reads best with argument: 10.minutes.since(time) + def since(time = ::Time.now) + time + self + end + + # Reads best without arguments: 10.minutes.from_now + alias :from_now :since + end + end + end +end + +class Numeric #:nodoc: + include ActiveSupport::CoreExtensions::Numeric::Time +end -- cgit v1.2.3