Class: Tr8n::Language
Overview
– Copyright © 2014 Michael Berkovich, TranslationExchange.com
_______ _ _ _ ______ _
|__ __| | | | | (_) | __| | |
| |_ __ __ _ _ __ ___| | __ _| |_ _ ___ _ __ | |__ __ _____| |__ __ _ _ __ __ _ ___
| | '__/ _` | '_ \/ __| |/ _` | __| |/ _ \| '_ \| __| \ \/ / __| '_ \ / _` | '_ \ / _` |/ _ \
| | | | (_| | | | \__ \ | (_| | |_| | (_) | | | | |____ > < (__| | | | (_| | | | | (_| | __/
|_|_| \__,_|_| |_|___/_|\__,_|\__|_|\___/|_| |_|______/_/\_\___|_| |_|\__,_|_| |_|\__, |\___|
__/ |
|___/
Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the “Software”), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:
The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.
THE SOFTWARE IS PROVIDED “AS IS”, WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE. ++
Instance Attribute Summary
Attributes inherited from Base
Class Method Summary collapse
Instance Method Summary collapse
- #align(dest) ⇒ Object
- #case_by_keyword(keyword) ⇒ Object
- #context_by_keyword(keyword) ⇒ Object
- #context_by_token_name(token_name) ⇒ Object
- #current_source(options) ⇒ Object
- #default? ⇒ Boolean
- #dir ⇒ Object
- #fetch ⇒ Object
- #full_name ⇒ Object
- #has_definition? ⇒ Boolean
-
#translate(label, description = nil, tokens = {}, options = {}) ⇒ Object
(also: #tr)
Translation Methods.
- #update_attributes(attrs) ⇒ Object
Methods inherited from Base
attributes, belongs_to, has_many, hash_value, #hash_value, #initialize, #method_missing, #to_hash
Constructor Details
This class inherits a constructor from Tr8n::Base
Dynamic Method Handling
This class handles dynamic methods through the method_missing method in the class Tr8n::Base
Class Method Details
.cache_key(locale) ⇒ Object
38 39 40 |
# File 'lib/tr8n/language.rb', line 38 def self.cache_key(locale) File.join(locale, 'language') end |
Instance Method Details
#align(dest) ⇒ Object
92 93 94 95 |
# File 'lib/tr8n/language.rb', line 92 def align(dest) return dest unless right_to_left? dest.to_s == 'left' ? 'right' : 'left' end |
#case_by_keyword(keyword) ⇒ Object
75 76 77 |
# File 'lib/tr8n/language.rb', line 75 def case_by_keyword(keyword) cases[keyword] end |
#context_by_keyword(keyword) ⇒ Object
67 68 69 |
# File 'lib/tr8n/language.rb', line 67 def context_by_keyword(keyword) hash_value(contexts, keyword) end |
#context_by_token_name(token_name) ⇒ Object
71 72 73 |
# File 'lib/tr8n/language.rb', line 71 def context_by_token_name(token_name) contexts.values.detect{|ctx| ctx.applies_to_token?(token_name)} end |
#current_source(options) ⇒ Object
102 103 104 |
# File 'lib/tr8n/language.rb', line 102 def current_source() ([:source] || Tr8n.session.[:source] || Tr8n.session.current_source || 'undefined').to_s end |
#default? ⇒ Boolean
83 84 85 86 |
# File 'lib/tr8n/language.rb', line 83 def default? return true unless application application.default_locale == locale end |
#dir ⇒ Object
88 89 90 |
# File 'lib/tr8n/language.rb', line 88 def dir right_to_left? ? 'rtl' : 'ltr' end |
#fetch ⇒ Object
42 43 44 45 46 47 |
# File 'lib/tr8n/language.rb', line 42 def fetch update_attributes(application.api_client.get("language/#{locale}", {}, {:cache_key => self.class.cache_key(locale)})) rescue Tr8n::Exception => ex Tr8n.logger.error("Failed to load language: #{ex}") self end |
#full_name ⇒ Object
97 98 99 100 |
# File 'lib/tr8n/language.rb', line 97 def full_name return english_name if english_name == native_name "#{english_name} - #{native_name}" end |
#has_definition? ⇒ Boolean
79 80 81 |
# File 'lib/tr8n/language.rb', line 79 def has_definition? contexts.any? end |
#translate(label, description = nil, tokens = {}, options = {}) ⇒ Object Also known as: tr
Translation Methods
Note - when inline translation mode is enable, cache will not be used and translators will always hit the live service to get the most recent translations
Some cache adapters cache by source, others by key. Some are read-only, some are built on the fly.
There are three ways to call the tr method
tr(label, description = “”, tokens = {}, options = {}) or tr(label, tokens = {}, options = {}) or tr(:label => label, :description => “”, :tokens => {}, :options => {})
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 |
# File 'lib/tr8n/language.rb', line 123 def translate(label, description = nil, tokens = {}, = {}) params = Tr8n::Utils.normalize_tr_params(label, description, tokens, ) return params[:label] if params[:label].tr8n_translated? translation_key = Tr8n::TranslationKey.new({ :application => application, :label => params[:label], :description => params[:description], :locale => hash_value(params[:options], :locale) || hash_value(Tr8n.session., :locale) || Tr8n.config.default_locale, :level => hash_value(params[:options], :level) || hash_value(Tr8n.session., :level) || Tr8n.config.default_level, :translations => [] }) #Tr8n.logger.info("Translating " + params[:label] + " from: " + translation_key.locale.inspect + " to " + locale.inspect) params[:tokens] ||= {} params[:tokens][:viewing_user] ||= Tr8n.session.current_user if Tr8n.config.disabled? or self.locale == translation_key.locale return translation_key.substitute_tokens( params[:label], params[:tokens], self, params[:options] ).tr8n_translated end cached_translations = application.cached_translations(locale, translation_key.key) if cached_translations translation_key.set_translations(locale, cached_translations) return translation_key.translate(self, params[:tokens], params[:options]).tr8n_translated end source_key = current_source() if Tr8n.cache.segmented? or Tr8n.session.inline_mode? source = application.source(source_key, locale) cached_translations = source.cached_translations(locale, translation_key.key) else cached_translations = application.fetch_translations(locale)[translation_key.key] end if cached_translations translation_key.set_translations(locale, cached_translations) else application.register_missing_key(source_key, translation_key) end translation_key.translate(self, params[:tokens], params[:options]).tr8n_translated end |
#update_attributes(attrs) ⇒ Object
49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 |
# File 'lib/tr8n/language.rb', line 49 def update_attributes(attrs) super self.attributes[:contexts] = {} if hash_value(attrs, :contexts) hash_value(attrs, :contexts).each do |key, context| self.attributes[:contexts][key] = Tr8n::LanguageContext.new(context.merge(:keyword => key, :language => self)) end end self.attributes[:cases] = {} if hash_value(attrs, :cases) hash_value(attrs, :cases).each do |key, lcase| self.attributes[:cases][key] = Tr8n::LanguageCase.new(lcase.merge(:keyword => key, :language => self)) end end end |