gettext_rails 2.0.0

data/COPYING

@@ -0,0 +1,55 @@
+You can redistribute this program  and/or modify it under either the terms of 
+the LGPL (see the file LGPL), or the conditions below:
+
+  1. You may make and give away verbatim copies of the source form of the
+     software without restriction, provided that you duplicate all of the
+     original copyright notices and associated disclaimers.
+
+  2. You may modify your copy of the software in any way, provided that
+     you do at least ONE of the following:
+
+       a) place your modifications in the Public Domain or otherwise
+          make them Freely Available, such as by posting said
+	  modifications to Usenet or an equivalent medium, or by allowing
+	  the author to include your modifications in the software.
+
+       b) use the modified software only within your corporation or
+          organization.
+
+       c) rename any non-standard executables so the names do not conflict
+	  with standard executables, which must also be provided.
+
+       d) make other distribution arrangements with the author.
+
+  3. You may distribute the software in object code or executable
+     form, provided that you do at least ONE of the following:
+
+       a) distribute the executables and library files of the software,
+	  together with instructions (in the manual page or equivalent)
+	  on where to get the original distribution.
+
+       b) accompany the distribution with the machine-readable source of
+	  the software.
+
+       c) give non-standard executables non-standard names, with
+          instructions on where to get the original software distribution.
+
+       d) make other distribution arrangements with the author.
+
+  4. You may modify and include the part of the software into any other
+     software (possibly commercial).  But some files in the distribution
+     are not written by the author, so that they are not under these terms.
+
+     For the list of those files and their copying conditions, see the
+     file LEGAL.
+
+  5. The scripts and library files supplied as input to or produced as 
+     output from the software do not automatically fall under the
+     copyright of the software, but belong to whomever generated them, 
+     and may be sold commercially, and may be aggregated with this
+     software.
+
+  6. THIS SOFTWARE IS PROVIDED "AS IS" AND WITHOUT ANY EXPRESS OR
+     IMPLIED WARRANTIES, INCLUDING, WITHOUT LIMITATION, THE IMPLIED
+     WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR
+     PURPOSE.

data/ChangeLog

@@ -0,0 +1,4 @@
+= gettext_rails-2.0.0 (2009-03-22)
+
+* Support Rails-2.3.2.
+* Work with other I18n backends.

data/README.rdoc

@@ -0,0 +1,173 @@
+= gettext_rails
+
+gettext_rails provides the localization for Ruby on Rails-2.3 or later
+using Ruby-GetText-Package.
+
+* Autodetect client locale using locale/locale_rails.
+* Easy maintainance of translations to use powerful tools for gettext family.
+* Model translation using gettext_activerecord.
+* Localization for some helpers.
+* Works with other Rails I18n backend.
+  * Note that gettext_rails is not the one of I18n backend.
+* Thread safe.
+
+== Website
+* homepage[http://www.yotabanana.com/hiki/ruby-gettext.html]
+* on rubyforge[http://gettext/rubyforge.org/]
+* on github[http://github.com/mutoh/gettext_rails/tree/master]
+
+== Requirements
+* {Ruby 1.8.3 or later}[http://www.ruby-lang.org]
+* {Rubygems}[http://www.rubygems.org/]
+* {locale gem}[http://rubyforge.org/projects/locale/]
+* {locale_rails gem}[http://rubyforge.org/projects/locale_rails/]
+* {gettext gem}[http://rubyforge.org/projects/gettext/]
+* {gettext_activerecord gem}[http://rubyforge.org/projects/gettext/]
+* {gettext_rails gem}[http://rubyforge.org/projects/gettext/]
+
+== Install
+    #Uninstall old gettext if exists.
+    (sudo/su on POSIX system)
+    gem uninstall gettext
+
+    #from github (edge/unstable)
+    (sudo/su on POSIX system)
+    gem install gettext
+    gem install gettext_activerecord
+    gem install gettext_rails
+    gem install mutoh-gettext_rails -s http://gems.github.com/
+
+    #from rubyforge (stable)
+    (sudo/su on POSIX system)
+    gem install gettext
+    gem install gettext_activerecord
+    gem install gettext_rails
+
+== Usage
+See sample direcotries for more details.
+
+==== Rakefile
+  require 'rubygems'
+  
+  desc "Create mo files"
+  task :makemo do
+    require 'gettext_rails/tools'
+    GetText.create_mofiles
+  end
+  
+  task :updatepo do
+    require 'gettext_rails/tools'
+    # Need to access DB to find Model table/column names.
+    # Use config/database.yml which is the same style with rails.
+    GetText.update_pofiles("sample_rails", ["topic.rb"], "sample_rails 1.0.0")
+  end
+
+==== config/environment.rb
+  Rails::Initializer.run do |config|
+    :
+    :
+    config.gem "locale_rails"
+    config.gem "gettext_activerecord"
+    config.gem "gettext_rails"
+  end
+
+==== application_controller.rb   
+class ApplicationController < ActionController::Base
+    init_gettext "blog"  # replace "blog" to your textdomain name.
+end
+
+==== Then ...
+  $ rake updatepo
+  $ cd po
+  $ mkdir ja
+  $ msginit -l ja_JP.UTF-8 -i blog.pot -o ja/sample.po
+  $ Edit ja/sample.po
+  $ cd ../../
+  $ rake makemo
+  $ ruby sample.rb
+
+See {Ruby-GetText-Package HOWTO for Ruby on Rails}[http://www.yotabanana.com/hiki/ruby-gettext-howto-rails.html] for more details.
+
+== Support matrix
+* gettext_rails-2.0.0 - rails-2.3.2
+
+== License
+This program is licenced under the same licence as Ruby.
+(See the file 'COPYING'.)
+
+* Copyright (C) 2001-2009 Masao Mutoh <mutoh at highwhay.ne.jp>
+== Translators
+* Bosnian(bs)                - Sanjin Sehic <saserr at gmail.com>
+* Bulgarian(bg)              - Sava Chankov <sava.chankov at gmail.com>
+* Catalan(ca)                - Ramon Salvadó <rsalvado at gnuine.com>
+* Chinese(Simplified)(zh_CN)
+  * Yang Bob <bob.yang.dev at gmail.com> (current)
+  * Yingfeng <blogyingfeng at gmail.com>
+* Chinese(Traditional)(zh_TW)
+  * Yang Bob <bob.yang.dev at gmail.com> (current)
+  * LIN CHUNG-YI <xmarsh at gmail.com>
+* Croatian(hr)               - Sanjin Sehic <saserr at gmail.com>
+* Czech(cs)                  - Karel Miarka <kajism at yahoo.com>
+* Dutch(nl)                  - Menno Jonkers <ruby-gettext at jonkers.com>
+* Esperanto(eo)              - Malte Milatz <malte at gmx-topmail.de>
+* Estonian(et)               - Erkki Eilonen <erkki at itech.ee>
+* French(fr)
+  * Vincent Isambart <vincent.isambart at gmail.com> (current)
+  * David Sulc <davidsulc at gmail.com>
+  * David Sulc <davidsulc at gmail.com>
+  * Laurent Sansonetti <laurent.sansonetti at gmail.com>
+* German(de)
+  * Patrick Lenz <patrick at limited-overload.de> (current)
+  * Detlef Reichl <detlef.reichl at gmx.org>
+  * Sven Herzberg <herzi at abi02.de>
+  * Sascha Ebach <se at digitale-wertschoepfung.de>
+* Greek(el)                  - Vassilis Rizopoulos <damphyr at gmx.net>
+* Hungarian(hu)              - Tamás Tompa <tompata at gmail.com>
+* Italian(it)
+  * Marco Lazzeri <marco.lazzeri at gmail.com>
+  * Gabriele Renzi <surrender_it at yahoo.it>
+* Japanese(ja)               - Masao Mutoh <mutomasa at gmail.com>
+* Korean(ko)                 - Gyoung-Yoon Noh <nohmad at gmail.com>
+* Latvian(lv)                - Aivars Akots <aivars.akots at gmail.com>
+* Norwegian(nb)              - Runar Ingebrigtsen <runar at mopo.no>
+* Portuguese(Brazil)(pt_BR)
+  * Antonio S. de A. Terceiro <terceiro at softwarelivre.org> (current)
+  * Joao Pedrosa <joaopedrosa at gmail.com>
+* Russian(ru)                - Yuri Kozlov <kozlov.y at gmail.com>
+* Serbian(sr)                - Slobodan Paunović" <slobodan.paunovic at gmail.com>
+* Spanish(es)
+  * David Espada <davinci at escomposlinux.org> (current)
+  * David Moreno Garza <damog at damog.net>
+* Ukrainian(ua)              - Alex Rootoff <rootoff at pisem.net>
+* Vietnamese(vi)             - Ngoc Dao Thanh <ngocdaothanh at gmail.com>
+
+== Status of translations
+* Bosnian(bs)               - 1.90.0 (old)
+* Bulgarian(bg)             - 2.0.0 
+* Catalan(ca)               - 2.0.0
+* Croatian(hr)              - 1.90.0 (old)
+* Chinese(zh_CN)            - 2.0.0
+* Chinese(zh_TW)            - 2.0.0
+* Czech(cs)                 - 1.9.0 (old)
+* Dutch(nl)                 - 1.90.0 (old)
+* English(default)          - 1.90.0 (old)
+* Esperanto(eo)             - 2.0.0
+* Estonian(et)              - 2.0.0
+* French(fr)                - 2.0.0
+* German(de)                - 2.0.0
+* Greek(el)                 - 2.0.0
+* Hungarian(hu)             - 2.0.0
+* Italian(it)               - 1.6.0 (old)
+* Japanese(ja)              - 2.0.0
+* Korean(ko)                - 1.9.0 (old)
+* Latvian(lv)               - 2.0.0 
+* Norwegian(nb)             - 2.0.0
+* Portuguese(Brazil)(pt_BR) - 2.0.0
+* Russian(ru)               - 2.0.0
+* Serbian(sr)               - 1.91.0 (old)
+* Spanish(es)               - 2.0.0
+* Ukrainian(ua)             - 2.0.0
+* Vietnamese(vi)            - 2.0.0
+
+== Maintainer
+Masao Mutoh <mutomasa at gmail.com>

data/Rakefile

@@ -0,0 +1,113 @@
+#
+# Rakefile for gettext_rails.
+#
+# Use setup.rb or gem for installation.
+# You don't need to use this file directly.
+#
+# Copyright(c) 2009 Masao Mutoh
+#
+# This program is licenced under the same licence as Ruby.
+#
+
+#make lib and paralel gettext checkout available
+$LOAD_PATH.unshift "./lib"
+gettext_path = File.join(ENV["GETTEXT_PATH"] || "../gettext/", "lib")
+$LOAD_PATH.unshift gettext_path
+
+require 'rubygems'
+require 'rake'
+require 'rake/packagetask'
+require 'rake/gempackagetask'
+require 'rake/rdoctask'
+
+gettext_path = File.join(ENV["GETTEXT_PATH"] || "../gettext/", "lib")
+$LOAD_PATH.unshift gettext_path
+
+require 'gettext_rails/version'
+
+PKG_VERSION = GetTextRails::VERSION
+
+task :default => [:makemo]
+
+############################################################
+# Manage po/mo files
+############################################################
+desc "Create *.mo from *.po"
+task :makemo do
+  $stderr.puts "Create active_record mo files."
+  require 'gettext/tools'
+  GetText.create_mofiles
+
+  $stderr.puts "Create sample mo files."
+  GetText.create_mofiles(:po_root => "sample/po", 
+                         :mo_root => "sample/locale")
+
+  $stderr.puts "Create samples/rails plugin mo files."
+  GetText.create_mofiles(:po_root => "sample/vendor/plugins/lang_helper/po", 
+                         :mo_root => "sample/vendor/plugins/lang_helper/locale")
+end
+
+desc "Update pot/po files to match new version."
+task :updatepo do
+  require 'gettext/tools'
+
+  GetText.update_pofiles("gettext_rails", 
+			 Dir.glob("lib/**/*.rb"),
+			 "gettext_rails #{PKG_VERSION}")
+
+end
+
+############################################################
+# Package tasks
+############################################################
+
+desc "Create gem and tar.gz"
+spec = Gem::Specification.new do |s|
+  s.name = 'gettext_rails'
+  s.version = PKG_VERSION
+  s.summary = 'Localization support for Ruby on Rails(>=2.3) by Ruby-GetText-Package.'
+  s.author = 'Masao Mutoh'
+  s.email = 'mutomasa at gmail.com'
+  s.homepage = 'http://gettext.rubyforge.org/'
+  s.rubyforge_project = "gettext"
+  s.files = FileList['**/*'].to_a.select{|v| v !~ /pkg|git/}
+  s.add_dependency('gettext_activerecord', '>= 2.0.0')
+  s.add_dependency('locale_rails', '>= 2.0.0')
+  s.add_dependency('rails', '>= 2.3.2')
+  s.require_path = 'lib'
+  s.has_rdoc = true
+  s.description = 'Localization support for Ruby on Rails(>=2.3.2) by Ruby-GetText-Package.'
+end
+
+Rake::GemPackageTask.new(spec) do |p|
+  p.gem_spec = spec
+  p.need_tar_gz = false
+  p.need_zip = false
+end
+
+############################################################
+# Misc tasks
+############################################################
+
+Rake::RDocTask.new { |rdoc|
+  allison = `allison --path`.chop
+  rdoc.rdoc_dir = 'doc'
+  rdoc.title    = "gettext_rails API Reference"
+  rdoc.options << '--line-numbers' << '--inline-source'
+  rdoc.rdoc_files.include('README', 'ChangeLog')
+  rdoc.rdoc_files.include('lib/**/*.rb')
+  rdoc.template = allison if allison.size > 0
+}
+
+desc "Publish the release files to RubyForge."
+task :release => [ :package ] do
+  require 'rubyforge'
+
+  rubyforge = RubyForge.new
+  rubyforge.configure
+  rubyforge.login
+  rubyforge.add_release("gettext", "gettext_rails", 
+                        PKG_VERSION, 
+                        "pkg/gettext_rails-#{PKG_VERSION}.gem")
+end
+

data/lib/gettext_rails.rb

@@ -0,0 +1,33 @@
+=begin
+  gettext_rails.rb- GetText for "Ruby on Rails"
+
+  Copyright (C) 2005-2009  Masao Mutoh
+
+  You may redistribute it and/or modify it under the same
+  license terms as Ruby.
+
+  Original: gettext/lib/rails.rb from Ruby-GetText-Package-1.93.0
+
+  $Id$
+=end
+
+require 'gettext_rails/action_controller.rb'
+require 'gettext_rails/action_view.rb'
+require 'gettext_rails/action_mailer.rb'
+require 'gettext_rails/version.rb'
+
+begin
+  Rails::Info.property("GetText version") do 
+    GetText::VERSION 
+  end
+  Rails::Info.property("GetText for Rails version") do 
+    GetTextRails::VERSION 
+  end
+rescue Exception
+  $stderr.puts "GetText's Rails::Info is not found." if $DEBUG
+end
+
+if ::RAILS_ENV == "development"
+  GetText::TextDomainManager.cached = false
+end
+

data/lib/gettext_rails/action_controller.rb

@@ -0,0 +1,104 @@
+=begin
+  gettext_rails/action_controller.rb - GetText for ActionController.
+
+  Copyright (C) 2005-2009  Masao Mutoh
+
+  You may redistribute it and/or modify it under the same
+  license terms as Ruby.
+
+  Original: gettext/lib/rails.rb from Ruby-GetText-Package-1.93.0
+
+  $Id$
+=end
+require 'gettext/cgi'
+require 'locale_rails'
+require 'action_controller'
+
+module ActionController #:nodoc:
+  class Base
+    include GetText
+
+    # Append a block which is called before initializing gettext on the each WWW request.
+    #
+    # (e.g.)
+    #   class ApplicationController < ActionController::Base
+    #     before_init_gettext{|controller|
+    #       cookies = controller.cookies
+    #       if (cookies["lang"].nil? or cookies["lang"].empty?)
+    #         GetText.locale = "zh_CN"
+    #       else
+    #         GetText.locale = cookies["lang"]
+    #       end
+    #     }
+    #     init_gettext "myapp"
+    #     # ...
+    #   end
+    def self.before_init_gettext(*filters, &block)
+      before_init_locale(*filters, &block)
+    end
+
+    # Append a block which is called after initializing gettext on the each WWW request.
+    #
+    # The GetText.locale is set the locale which bound to the textdomains
+    # when gettext is initialized.
+    #
+    # (e.g.)
+    #   class ApplicationController < ActionController::Base
+    #     after_init_gettext {|controller|
+    #       L10nClass.new(GetText.locale)
+    #     }
+    #     init_gettext "foo"
+    #     # ...
+    #   end
+    def self.after_init_gettext(*filters, &block)
+      after_init_locale(*filters, &block)
+    end
+
+    # Bind a 'textdomain' to all of the controllers/views/models. Call this instead of GetText.bindtextdomain.
+    # * textdomain: the textdomain
+    # * options: options as a Hash.
+    #   * :charset - the output charset. Default is "UTF-8"
+    #   * :locale_path - the path to locale directory. Default is {RAILS_ROOT}/locale or {plugin root directory}/locale.
+    #
+    # locale is searched the order by params["lang"] > "lang" value of QUERY_STRING > 
+    # "lang" value of Cookie > HTTP_ACCEPT_LANGUAGE value > Default locale(en). 
+    # And the charset is set order by "the argument of bindtextdomain" > HTTP_ACCEPT_CHARSET > Default charset(UTF-8).
+    # Refer Ruby-Locale for more details.
+    #
+    # If you want to separate the textdomain each controllers, you need to call this function in the each controllers.
+    #
+    # app/controller/blog_controller.rb:
+    #  class BlogController < ApplicationController
+    #    init_gettext "blog"
+    #      :
+    #    end
+    def self.init_gettext(domainname, options = {})
+      opt = {:charset => "UTF-8"}.merge(options)
+
+      set_output_charset(opt[:charset])
+      locale_path = opt[:locale_path]
+      unless locale_path
+        cal = caller[0]
+        if cal =~ /app.controllers/
+          # Don't use RAILS_ROOT first, for RailsEngines. 
+          locale_path = File.join(cal.split(/app.controllers/)[0] + "locale")
+        else
+          locale_path = File.join(RAILS_ROOT, "locale")
+        end
+      end
+
+      bindtextdomain(domainname, {:path => locale_path})
+
+      if defined? ActiveRecord::Base
+        textdomain_to(ActiveRecord::Base, domainname) 
+        textdomain_to(ActiveRecord::Validations, domainname)
+      end
+      textdomain_to(ActionView::Base, domainname) if defined? ActionView::Base
+      textdomain_to(ApplicationHelper, domainname) if defined? ApplicationHelper
+      textdomain_to(ActionMailer::Base, domainname) if defined? ActionMailer::Base
+      textdomain_to(ActionView::Helpers, domainname) if defined? ActionView::Helpers
+    end
+
+  end
+
+end