Ruby-GetText-Package HOWTO for CGI/ERB
ruby-gettext-howto-cgi
HOWTO using Ruby-GetText-Package with CGI.
See also samples in ruby-gettext-x.x.x/samples/cgi/.
A table of contents
- Using Ruby-GetText with CGI
- Using Ruby-GetText with ERB
- Using Ruby-GetText with other Template engines or split HTML files
Using Ruby-GetText with CGI
This is very simple/easy sample. It's same as normal applications.
See a sample below. The domainname is "index" and the mo file is installed to "/app/locale/#{lang}/LC_MESSAGES/".
require 'gettext/cgi'
include GetText
set_output_charset("UTF-8")
bindtextdomain("index", "/app/locale")
print "Content-type:text/html; charset=UTF-8\n\n"
puts %Q[<html><head>
<meta http-equiv="content-type" content="text/html; charset=UTF-8">
<title>]
puts _("Sample script for CGI/ERB and Ruby-GetText-Package")
puts "</title><body>"
puts "<h1>" + _("Hello World") + "</h1>"
puts "</body></html>"
In this sample, output charset is UTF-8 forcely.
If you want to set the charset flexibility, you can do as follows:
require 'gettext/cgi'
include GetText
bindtextdomain("index", "/app/locale")
print "Content-type:text/html; charset=#{Locale.charset}\n\n"
puts %Q[<html><head>
<meta http-equiv="content-type" content="text/html; charset=#{Locale.charset}">
<title>]
puts _("Sample script for CGI/ERB and Ruby-GetText-Package")
puts "</title><body>"
puts "<h1>" + _("Hello World") + "</h1>"
puts "</body></html>"
But I don't recommand this way and recommand to set output charset to 'UTF-8'. Because if the WWW browser doesn't return HTTP_ACCEPT_CHARSET, it won't work as you think. And also if you want to store the data to DB, you need to convert the charset carefully.
How to get the locale information from WWW browser
The locale value is get from the order by "lang" value of QUERY_STRING > "lang" value of Cookie > HTTP_ACCEPT_LANGUAGE value > "en" (English). And the charset is set order by HTTP_ACCEPT_CHARSET > "UTF-8".
Your application needs to set "lang" value of QUERY_STRING or Cookies properly by itself.
Notice: If you set locale/charset using GetText functions such as GetText.output_string=, the setting has forced and the WWW browser requests are ignored.
Using Ruby-GetText with ERB
This is a sample to use Ruby-GetText with ERB. See a sample below. This sample also in ruby-gettext-package-x.x.x/samples/cgi/helloerb.rhtml.
require 'gettext/cgi'
require 'gettext/erb'
class SimpleContainer1
include GetText::ErbContainer
def initialize(domainname, domainpath = nil, locale = nil, charset = nil)
bindtextdomain(domainname, domainpath, locale)
end
def description
_("Sample script for CGI/ERB (UTF-8).")
end
def to_html(path)
eval_file(path)
end
end
GetText.output_charset = "UTF-8"
print "Content-type:text/html; charset=UTF-8\n\n"
con = SimpleContainer1.new("helloerb1", "locale")
if GetText.cgi["other"] == "true"
print con.to_html("other.rhtml")
else
print con.to_html("helloerb.rhtml")
end
Both of helloerb.rhtml and other.rhtml are ERB files(.rhtml). You can find both of samples/cgi/helloerb.rhtml and other.rhtml don't call GetText.bindtextdomain in each .rhtml files.
Because the class which includes GetText::ErbContainer binds a TextDomain as a class.
And you can call instance variables/methods of SimpleContainer1 from ERB files(.rhtml). SimpleContainer1#description is an example for that purpose.
In the ERB(rhtml) files, write GetText methods like as:
<h1><%= _("Hello World") %></h1>
You can use rgettext to rhtml file.
$ rgettext foo.rhtml -o foo.pot
Using Ruby-GetText with other Template engines or split HTML files
If you want to separate HTML to some files or to use other template engines. See gettext/erb.rb which is an implementation of that purpose.
![[Music] Hodge Podge : Johnny Hodges](http://www.tdiary.org/images/amazondefaults/medium.png "[Music] Hodge Podge : Johnny Hodges")
![[Music] PHOTON : BOOM BOOM SATELLITES](http://images.amazon.com/images/P/B00006962W.01._SCTHUMBZZZ_.jpg "[Music] PHOTON : BOOM BOOM SATELLITES")
![[DVD] 舞妓Haaaan!!! : 出演: 阿部サダヲ, 堤真一, 柴咲コウ, 他 | 監督: 水田伸生](http://ecx.images-amazon.com/images/I/61HplP6QUYL._SL75_.jpg "[DVD] 舞妓Haaaan!!! : 出演: 阿部サダヲ, 堤真一, 柴咲コウ, 他 | 監督: 水田伸生")
![[Music] 愛 am BEST （通常盤）(DVD付) : 大塚愛](http://g-ec2.images-amazon.com/images/I/11drDEqn-YL.jpg "[Music] 愛 am BEST （通常盤）(DVD付) : 大塚愛")
![[Music] ワーク・ソング : ナット・アダレイ](http://images.amazon.com/images/P/B0007OE3LQ.01._SCTHUMBZZZ_.jpg "[Music] ワーク・ソング : ナット・アダレイ")
![[Music] SOLID BRASS II : YOUICHI MURATA](http://www.tdiary.org/images/amazondefaults/small.png "[Music] SOLID BRASS II : YOUICHI MURATA")
![[DVD] 12人の優しい日本人 : 出演: 塩見三省, 豊川悦司, 他 | 監督: 中原俊](http://ecx.images-amazon.com/images/I/2113D4PQYEL._SL75_.jpg "[DVD] 12人の優しい日本人 : 出演: 塩見三省, 豊川悦司, 他 | 監督: 中原俊")
![[Music] ザ・ビートルズ : ザ・ビートルズ](http://ec1.images-amazon.com/images/P/B00005GL0S.09._SCTHUMBZZZ_.jpg "[Music] ザ・ビートルズ : ザ・ビートルズ")
![[Music] Quartet : Herbie Hancock Quartet](http://ec1.images-amazon.com/images/P/B0000025SI.01._SCTHUMBZZZ_.jpg "[Music] Quartet : Herbie Hancock Quartet")
Keyword(s):
References:[Ruby-GetText-Package HOWTO] [Ruby-GetText-Package document for Developers]