There's no documentation for this item.

Source Code

# File action_controller/layout.rb, line 246
def render_with_a_layout(options = nil, &block) #:nodoc:
  template_with_options = options.is_a?(Hash)

  if apply_layout?(template_with_options, options) && (layout = pick_layout(template_with_options, options))
    assert_existence_of_template_file(layout)

    options = options.merge :layout => false if template_with_options
    logger.info("Rendering template within #{layout}") if logger

    content_for_layout = render_with_no_layout(options, &block)
    erase_render_results
    add_variables_to_assigns
    @template.instance_variable_set("@content_for_layout", content_for_layout)
    response.layout = layout
    status = template_with_options ? options[:status] : nil
    render_for_text(@template.render_file(layout, true), status)
  else
    render_with_no_layout(options, &block)
  end
end