# File actionview/lib/action_view/helpers/translation_helper.rb, line 116
def localize(object, **options)
  I18n.localize(object, **options)
end

Делегирует вызов к I18n.localize без дополнительной функциональности.

См. www.rubydoc.info/gems/i18n/I18n/Backend/Base:localize для получения дополнительной информации.

# File actionview/lib/action_view/helpers/translation_helper.rb, line 73
def translate(key, **options)
  return key.map { |k| translate(k, **options) } if key.is_a?(Array)
  key = key&.to_s unless key.is_a?(Symbol)

  alternatives = if options.key?(:default)
    options[:default].is_a?(Array) ? options.delete(:default).compact : [options.delete(:default)]
  end

  options[:raise] = true if options[:raise].nil? && TranslationHelper.raise_on_missing_translations
  default = MISSING_TRANSLATION

  translation = while key || alternatives.present?
    if alternatives.blank? && !options[:raise].nil?
      default = NO_DEFAULT # let I18n handle missing translation
    end

    key = scope_key_by_partial(key)

    translated = ActiveSupport::HtmlSafeTranslation.translate(key, **options, default: default)

    break translated unless translated == MISSING_TRANSLATION

    if alternatives.present? && !alternatives.first.is_a?(Symbol)
      break alternatives.first && I18n.translate(nil, **options, default: alternatives)
    end

    first_key ||= key
    key = alternatives&.shift
  end

  if key.nil? && !first_key.nil?
    translation = missing_translation(first_key, options)
    key = first_key
  end

  block_given? ? yield(translation, key) : translation
end

Делегирует вызов к I18n#translate, но также выполняет три дополнительных функции.

Во-первых, она гарантирует, что все возникшие MissingTranslation сообщения будут отображаться как вложенные span, которые:

• Получают класс translation-missing

• Содержат пропущенный ключ в качестве значения атрибута title

• Содержат титл-версию последнего сегмента ключа в качестве текста

Например, значение, возвращаемое для пропущенного ключа перевода "blog.post.title", будет:

<span
  class="translation_missing"
  title="translation missing: en.blog.post.title">Title</span>

Это позволяет представлениям отображать достаточно осмысленные строки, одновременно предоставляя разработчикам возможность поиска пропущенных переводов.

Если вы предпочитаете, чтобы пропущенные переводы генерировали ошибку, вы можете отказаться от поведения span-обёртывания глобально, установив config.i18n.raise_on_missing_translations = true, или индивидуально, передав raise: true в качестве опции в translate.

Во-вторых, если ключ начинается с точки translate, ключ будет ограничен текущей части. Вызов translate(".foo") из шаблона people/index.html.erb эквивалентен вызову translate("people.index.foo"). Это делает перевод многих ключей в рамках одной части менее повторяемым и предоставляет соглашение для последовательного ограничения ключей.

В-третьих, перевод будет помечен как html_safe, если ключ имеет суффикс «_html» или последним элементом ключа является «html». Вызов translate("footer_html") или translate("footer.html") вернёт строку, безопасную для HTML, которая не будет экранироваться другими методами HTML-помощников. Это соглашение об именовании помогает определить переводы, содержащие HTML-теги, чтобы вы знали, какой вид вывода ожидать при вызове translate в шаблоне, а переводчики знают, какие ключи могут содержать HTML-значения.

Для доступа к переведённому тексту и полностью разрешённому ключу перевода translate принимает блок:

<%= translate(".relative_key") do |translation, resolved_key| %>
  <span title="<%= resolved_key %>"><%= translation %></span>
<% end %>

Это позволяет аннотациям переведённого текста знать область, к которой он был применён.