File: README.rdoc

package info (click to toggle)
libgettext-rails-ruby 2.1.0-1
  • links: PTS, VCS
  • area: main
  • in suites: squeeze
  • size: 4,384 kB
  • ctags: 383
  • sloc: ruby: 1,042; makefile: 10
file content (175 lines) | stat: -rw-r--r-- 6,407 bytes parent folder | download | duplicates (2)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
= 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)  (not supported yet)
    (sudo/su on POSIX system)
    #gem install mutoh-gettext_rails -s http://gems.github.com/

    #from rubyforge (stable)
    (sudo/su on POSIX system)
    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"
    config.gem "locale_rails"
    config.gem "gettext"
    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.1.0 - rails-2.3.2,2.3.3,2.3.4
* gettext_rails-2.0.2 - rails-2.3.2
* gettext_rails-2.0.1 - rails-2.3.2
* gettext_rails-2.0.0 - rails-2.3.2

== License
This program is licenced under the same licence as Ruby(See COPYING) or
LGPL(Lesser General Public License: http://www.gnu.org/licenses/lgpl-3.0.txt).

* 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)                  - Bart ten Brinke<info at retrosync.com> (current)
                               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)                 - 2.0.2
* 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.1.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>