Module: Sinatra::Templates

Included in:
Base
Defined in:
lib/sinatra/base.rb

Overview

Template rendering methods. Each method takes the name of a template to render as a Symbol and returns a String with the rendered output, as well as an optional hash with additional options.

‘template` is either the name or path of the template as symbol (Use `:’subdir/myview’‘ for views in subdirectories), or a string that will be rendered.

Possible options are:

:content_type   The content type to use, same arguments as content_type.
:layout         If set to false, no layout is rendered, otherwise
                the specified layout is used (Ignored for `sass` and `less`)
:layout_engine  Engine to use for rendering the layout.
:locals         A hash with local variables that should be available
                in the template
:scope          If set, template is evaluate with the binding of the given
                object rather than the application instance.
:views          Views directory to use.

Defined Under Namespace

Modules: ContentTyped

Instance Method Summary collapse

Instance Method Details

#builder(template = nil, options = {}, locals = {}, &block) ⇒ Object 



576
577
578
579
 
# File 'lib/sinatra/base.rb', line 576

def builder(template=nil, options={}, locals={}, &block)
  options[:default_content_type] = :xml
  render_ruby(:builder, template, options, locals, &block)
end

#coffee(template, options = {}, locals = {}) ⇒ Object 



605
606
607
608
 
# File 'lib/sinatra/base.rb', line 605

def coffee(template, options={}, locals={})
  options.merge! :layout => false, :default_content_type => :js
  render :coffee, template, options, locals
end

#creole(template, options = {}, locals = {}) ⇒ Object 



619
620
621
 
# File 'lib/sinatra/base.rb', line 619

def creole(template, options={}, locals={})
  render :creole, template, options, locals
end

#erb(template, options = {}, locals = {}) ⇒ Object 



547
548
549
 
# File 'lib/sinatra/base.rb', line 547

def erb(template, options={}, locals={})
  render :erb, template, options, locals
end

#erubis(template, options = {}, locals = {}) ⇒ Object 



551
552
553
554
555
 
# File 'lib/sinatra/base.rb', line 551

def erubis(template, options={}, locals={})
  warn "Sinatra::Templates#erubis is deprecated and will be removed, use #erb instead.\n" \
    "If you have Erubis installed, it will be used automatically."
  render :erubis, template, options, locals
end

#find_template(views, name, engine) {|::File.join(views, "#{name}.#{@preferred_extension}")| ... } ⇒ Object

Calls the given block for every possible template file in views, named name.ext, where ext is registered on engine.

Yields:

  • (::File.join(views, "#{name}.#{@preferred_extension}")) 


630
631
632
633
634
635
636
 
# File 'lib/sinatra/base.rb', line 630

def find_template(views, name, engine)
  yield ::File.join(views, "#{name}.#{@preferred_extension}")
  Tilt.mappings.each do |ext, engines|
    next unless ext != @preferred_extension and engines.include? engine
    yield ::File.join(views, "#{name}.#{ext}")
  end
end

#haml(template, options = {}, locals = {}) ⇒ Object 



557
558
559
 
# File 'lib/sinatra/base.rb', line 557

def haml(template, options={}, locals={})
  render :haml, template, options, locals
end

#initialize ⇒ Object 



542
543
544
545
 
# File 'lib/sinatra/base.rb', line 542

def initialize
  super
  @default_layout = :layout
end

#less(template, options = {}, locals = {}) ⇒ Object 



571
572
573
574
 
# File 'lib/sinatra/base.rb', line 571

def less(template, options={}, locals={})
  options.merge! :layout => false, :default_content_type => :css
  render :less, template, options, locals
end

#liquid(template, options = {}, locals = {}) ⇒ Object 



581
582
583
 
# File 'lib/sinatra/base.rb', line 581

def liquid(template, options={}, locals={})
  render :liquid, template, options, locals
end

#markaby(template = nil, options = {}, locals = {}, &block) ⇒ Object 



601
602
603
 
# File 'lib/sinatra/base.rb', line 601

def markaby(template=nil, options={}, locals={}, &block)
  render_ruby(:mab, template, options, locals, &block)
end

#markdown(template, options = {}, locals = {}) ⇒ Object 



585
586
587
 
# File 'lib/sinatra/base.rb', line 585

def markdown(template, options={}, locals={})
  render :markdown, template, options, locals
end

#nokogiri(template = nil, options = {}, locals = {}, &block) ⇒ Object 



610
611
612
613
 
# File 'lib/sinatra/base.rb', line 610

def nokogiri(template=nil, options={}, locals={}, &block)
  options[:default_content_type] = :xml
  render_ruby(:nokogiri, template, options, locals, &block)
end

#radius(template, options = {}, locals = {}) ⇒ Object 



597
598
599
 
# File 'lib/sinatra/base.rb', line 597

def radius(template, options={}, locals={})
  render :radius, template, options, locals
end

#rdoc(template, options = {}, locals = {}) ⇒ Object 



593
594
595
 
# File 'lib/sinatra/base.rb', line 593

def rdoc(template, options={}, locals={})
  render :rdoc, template, options, locals
end

#sass(template, options = {}, locals = {}) ⇒ Object 



561
562
563
564
 
# File 'lib/sinatra/base.rb', line 561

def sass(template, options={}, locals={})
  options.merge! :layout => false, :default_content_type => :css
  render :sass, template, options, locals
end

#scss(template, options = {}, locals = {}) ⇒ Object 



566
567
568
569
 
# File 'lib/sinatra/base.rb', line 566

def scss(template, options={}, locals={})
  options.merge! :layout => false, :default_content_type => :css
  render :scss, template, options, locals
end

#slim(template, options = {}, locals = {}) ⇒ Object 



615
616
617
 
# File 'lib/sinatra/base.rb', line 615

def slim(template, options={}, locals={})
  render :slim, template, options, locals
end

#textile(template, options = {}, locals = {}) ⇒ Object 



589
590
591
 
# File 'lib/sinatra/base.rb', line 589

def textile(template, options={}, locals={})
  render :textile, template, options, locals
end

#yajl(template, options = {}, locals = {}) ⇒ Object 



623
624
625
626
 
# File 'lib/sinatra/base.rb', line 623

def yajl(template, options={}, locals={})
  options[:default_content_type] = :json
  render :yajl, template, options, locals
end