Class: Knj::Gettext_threadded
Overview
This class reads .po-files generated by something like POEdit and can be used to run multi-language applications or websites.
Instance Attribute Summary collapse
-
#args ⇒ Object
readonly
Config-hash that contains encoding and more.
-
#langs ⇒ Object
readonly
Hash that contains all translations loaded.
Instance Method Summary collapse
-
#gettext(str, locale) ⇒ Object
This function can be used to make your string be recognized by gettext tools.
-
#initialize(args = {}) ⇒ Gettext_threadded
constructor
Initializes various data.
-
#lang_opts ⇒ Object
Returns a hash with the language ID string as key and the language human-readable-title as value.
-
#load_dir(dir) ⇒ Object
Loads a ‘locales’-directory with .mo- and .po-files and fills the ‘@langs’-hash.
-
#trans(locale, str) ⇒ Object
Translates a given string to a given locale from the read .po-files.
Constructor Details
#initialize(args = {}) ⇒ Gettext_threadded
Initializes various data.
10 11 12 13 14 15 16 17 |
# File 'lib/knj/gettext_threadded.rb', line 10 def initialize(args = {}) @args = { :encoding => "utf-8" }.merge(args) @langs = {} @dirs = [] load_dir(@args["dir"]) if @args["dir"] end |
Instance Attribute Details
#args ⇒ Object (readonly)
Config-hash that contains encoding and more.
7 8 9 |
# File 'lib/knj/gettext_threadded.rb', line 7 def args @args end |
#langs ⇒ Object (readonly)
Hash that contains all translations loaded.
4 5 6 |
# File 'lib/knj/gettext_threadded.rb', line 4 def langs @langs end |
Instance Method Details
#gettext(str, locale) ⇒ Object
This function can be used to make your string be recognized by gettext tools.
72 73 74 |
# File 'lib/knj/gettext_threadded.rb', line 72 def gettext(str, locale) return trans(locale, str) end |
#lang_opts ⇒ Object
Returns a hash with the language ID string as key and the language human-readable-title as value.
77 78 79 80 81 82 83 84 85 86 87 88 89 90 91 92 93 94 95 96 97 |
# File 'lib/knj/gettext_threadded.rb', line 77 def lang_opts langs = {} @langs.keys.sort.each do |lang| title = nil @dirs.each do |dir| title_file_path = "#{dir}/#{lang}/title.txt" if File.exists?(title_file_path) title = File.read(title_file_path, {:encoding => @args[:encoding]}).to_s.strip else title = lang.to_s.strip end break if title end langs[lang] = title end return langs end |
#load_dir(dir) ⇒ Object
Loads a ‘locales’-directory with .mo- and .po-files and fills the ‘@langs’-hash.
Examples
gtext.load_dir(“#File.dirname(__FILE__)/../locales”)
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 |
# File 'lib/knj/gettext_threadded.rb', line 22 def load_dir(dir) @dirs << dir check_folders = ["LC_MESSAGES", "LC_ALL"] Dir.foreach(dir) do |file| fn = "#{dir}/#{file}" if File.directory?(fn) and file.match(/^[a-z]{2}_[A-Z]{2}$/) @langs[file] = {} if !@langs[file] check_folders.each do |fname| fpath = "#{dir}/#{file}/#{fname}" if File.exists?(fpath) and File.directory?(fpath) Dir.foreach(fpath) do |pofile| if pofile.match(/\.po$/) pofn = "#{dir}/#{file}/#{fname}/#{pofile}" cont = nil File.open(pofn, "r", {:encoding => @args[:encoding]}) do |fp| cont = fp.read.encode("utf-8") end cont.scan(/msgid\s+\"(.+)\"(\r|)\nmsgstr\s+\"(.+)\"(\r|)\n(\r|)\n/) do |match| @langs[file][match[0]] = match[2].to_s.encode("utf-8") end end end end end end end end |
#trans(locale, str) ⇒ Object
Translates a given string to a given locale from the read .po-files.
Examples
str = “Hello” #=> “Hello” gtext.trans(“da_DK”, str) #=> “Hej”
59 60 61 62 63 64 65 66 67 68 69 |
# File 'lib/knj/gettext_threadded.rb', line 59 def trans(locale, str) locale = locale.to_s str = str.to_s if !@langs.key?(locale) raise "Locale was not found: '#{locale}' in '#{@langs.keys.join(", ")}'." end return str if !@langs[locale].key?(str) return @langs[locale][str] end |