Contents

module FastGettext
  # this module should be included
  # Responsibility:
  #  - direct translation queries to the current repository
  #  - handle untranslated values
  #  - understand / enforce namespaces
  #  - decide which plural form is used
  module Translation
    extend self

    #make it usable in class definition, e.g.
    # class Y
    #   include FastGettext::Translation
    #   @@x = _('y')
    # end
    def self.included(klas)  #:nodoc:
      klas.extend self
    end

    def _(translate)
      found = FastGettext.current_cache[translate] and return found
      FastGettext.current_cache[translate] = FastGettext.current_repository[translate] || translate
    end

    #translate pluralized
    # some languages have up to 4 plural forms...
    # n_(singular, plural, plural form 2, ..., count)
    # n_('apple','apples',3)
    def n_(*msgids)
      count = msgids.pop
      
      translations = FastGettext.current_repository.plural(*msgids)
      selected = FastGettext.current_repository.pluralisation_rule.call(count)
      selected = selected ? 1 : 0 unless selected.is_a? Numeric #convert booleans to numbers
      translations[selected] || msgids[selected] || msgids.last
    end

    #translate, but discard namespace if nothing was found
    # Car|Tire -> Tire if no translation could be found
    def s_(translate,seperator=nil)
      if translation = FastGettext.current_repository[translate]
        translation
      else
        translate.split(seperator||NAMESPACE_SEPERATOR).last
      end
    end

    #tell gettext: this string need translation (will be found during parsing)
    def N_(translate)
      translate
    end

    #tell gettext: this string need translation (will be found during parsing)
    def Nn_(*msgids)
      msgids
    end
  end
end

Version data entries

8 entries across 8 versions & 1 rubygems

Version	Path
grosser-fast_gettext-0.3.1	lib/fast_gettext/translation.rb
grosser-fast_gettext-0.3.2	lib/fast_gettext/translation.rb
grosser-fast_gettext-0.3.3	lib/fast_gettext/translation.rb
grosser-fast_gettext-0.3.4	lib/fast_gettext/translation.rb
grosser-fast_gettext-0.3.5	lib/fast_gettext/translation.rb
grosser-fast_gettext-0.3.6	lib/fast_gettext/translation.rb
grosser-fast_gettext-0.3.7	lib/fast_gettext/translation.rb
grosser-fast_gettext-0.3.8	lib/fast_gettext/translation.rb