class Knj::Gettext_threadded

This class reads .po-files generated by something like POEdit and can be used to run multi-language applications or websites.

Attributes

args[R]

Config-hash that contains encoding and more.

langs[R]

Hash that contains all translations loaded.

Public Class Methods

new(args = {}) click to toggle source

Initializes various data.

# 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

Public Instance Methods

gettext(str, locale) click to toggle source

This function can be used to make your string be recognized by gettext tools.

# File lib/knj/gettext_threadded.rb, line 72
def gettext(str, locale)
  return trans(locale, str)
end
lang_opts() click to toggle source

Returns a hash with the language ID string as key and the language human-readable-title as value.

# 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) click to toggle source

Loads a 'locales'-directory with .mo- and .po-files and fills the '@langs'-hash.

Examples

gtext.load_dir("#{File.dirname(__FILE__)}/../locales")
# 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) click to toggle source

Translates a given string to a given locale from the read .po-files.

Examples

str = "Hello" #=> "Hello"
gtext.trans("da_DK", str) #=> "Hej"
# 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