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 something falsy, 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
- #asciidoc(template, options = {}, locals = {}) ⇒ Object
- #builder(template = nil, options = {}, locals = {}, &block) ⇒ Object
- #coffee(template, options = {}, locals = {}) ⇒ Object
- #creole(template, options = {}, locals = {}) ⇒ Object
- #erb(template, options = {}, locals = {}, &block) ⇒ Object
- #erubis(template, options = {}, locals = {}) ⇒ Object
-
#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.
- #haml(template, options = {}, locals = {}, &block) ⇒ Object
- #initialize ⇒ Object
- #less(template, options = {}, locals = {}) ⇒ Object
- #liquid(template, options = {}, locals = {}, &block) ⇒ Object
- #markaby(template = nil, options = {}, locals = {}, &block) ⇒ Object
- #markdown(template, options = {}, locals = {}) ⇒ Object
- #mediawiki(template, options = {}, locals = {}) ⇒ Object
- #nokogiri(template = nil, options = {}, locals = {}, &block) ⇒ Object
- #rabl(template, options = {}, locals = {}) ⇒ Object
- #radius(template, options = {}, locals = {}) ⇒ Object
- #rdoc(template, options = {}, locals = {}) ⇒ Object
- #sass(template, options = {}, locals = {}) ⇒ Object
- #scss(template, options = {}, locals = {}) ⇒ Object
- #slim(template, options = {}, locals = {}, &block) ⇒ Object
- #stylus(template, options = {}, locals = {}) ⇒ Object
- #textile(template, options = {}, locals = {}) ⇒ Object
- #wlang(template, options = {}, locals = {}, &block) ⇒ Object
- #yajl(template, options = {}, locals = {}) ⇒ Object
Instance Method Details
#asciidoc(template, options = {}, locals = {}) ⇒ Object
757 758 759 |
# File 'lib/sinatra/base.rb', line 757 def asciidoc(template, = {}, locals = {}) render :asciidoc, template, , locals end |
#builder(template = nil, options = {}, locals = {}, &block) ⇒ Object
735 736 737 738 |
# File 'lib/sinatra/base.rb', line 735 def builder(template = nil, = {}, locals = {}, &block) [:default_content_type] = :xml render_ruby(:builder, template, , locals, &block) end |
#coffee(template, options = {}, locals = {}) ⇒ Object
769 770 771 772 |
# File 'lib/sinatra/base.rb', line 769 def coffee(template, = {}, locals = {}) .merge! :layout => false, :default_content_type => :js render :coffee, template, , locals end |
#creole(template, options = {}, locals = {}) ⇒ Object
783 784 785 |
# File 'lib/sinatra/base.rb', line 783 def creole(template, = {}, locals = {}) render :creole, template, , locals end |
#erb(template, options = {}, locals = {}, &block) ⇒ Object
701 702 703 |
# File 'lib/sinatra/base.rb', line 701 def erb(template, = {}, locals = {}, &block) render(:erb, template, , locals, &block) end |
#erubis(template, options = {}, locals = {}) ⇒ Object
705 706 707 708 709 |
# File 'lib/sinatra/base.rb', line 705 def erubis(template, = {}, 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, , 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.
807 808 809 810 811 812 813 |
# File 'lib/sinatra/base.rb', line 807 def find_template(views, name, engine) yield ::File.join(views, "#{name}.#{@preferred_extension}") Tilt.default_mapping.extensions_for(engine).each do |ext| yield ::File.join(views, "#{name}.#{ext}") unless ext == @preferred_extension end end |
#haml(template, options = {}, locals = {}, &block) ⇒ Object
711 712 713 |
# File 'lib/sinatra/base.rb', line 711 def haml(template, = {}, locals = {}, &block) render(:haml, template, , locals, &block) end |
#initialize ⇒ Object
695 696 697 698 699 |
# File 'lib/sinatra/base.rb', line 695 def initialize super @default_layout = :layout @preferred_extension = nil end |
#less(template, options = {}, locals = {}) ⇒ Object
725 726 727 728 |
# File 'lib/sinatra/base.rb', line 725 def less(template, = {}, locals = {}) .merge! :layout => false, :default_content_type => :css render :less, template, , locals end |
#liquid(template, options = {}, locals = {}, &block) ⇒ Object
740 741 742 |
# File 'lib/sinatra/base.rb', line 740 def liquid(template, = {}, locals = {}, &block) render(:liquid, template, , locals, &block) end |
#markaby(template = nil, options = {}, locals = {}, &block) ⇒ Object
765 766 767 |
# File 'lib/sinatra/base.rb', line 765 def markaby(template = nil, = {}, locals = {}, &block) render_ruby(:mab, template, , locals, &block) end |
#markdown(template, options = {}, locals = {}) ⇒ Object
744 745 746 747 |
# File 'lib/sinatra/base.rb', line 744 def markdown(template, = {}, locals = {}) [:exclude_outvar] = true render :markdown, template, , locals end |
#mediawiki(template, options = {}, locals = {}) ⇒ Object
787 788 789 |
# File 'lib/sinatra/base.rb', line 787 def mediawiki(template, = {}, locals = {}) render :mediawiki, template, , locals end |
#nokogiri(template = nil, options = {}, locals = {}, &block) ⇒ Object
774 775 776 777 |
# File 'lib/sinatra/base.rb', line 774 def nokogiri(template = nil, = {}, locals = {}, &block) [:default_content_type] = :xml render_ruby(:nokogiri, template, , locals, &block) end |
#rabl(template, options = {}, locals = {}) ⇒ Object
800 801 802 803 |
# File 'lib/sinatra/base.rb', line 800 def rabl(template, = {}, locals = {}) Rabl.register! render :rabl, template, , locals end |
#radius(template, options = {}, locals = {}) ⇒ Object
761 762 763 |
# File 'lib/sinatra/base.rb', line 761 def radius(template, = {}, locals = {}) render :radius, template, , locals end |
#rdoc(template, options = {}, locals = {}) ⇒ Object
753 754 755 |
# File 'lib/sinatra/base.rb', line 753 def rdoc(template, = {}, locals = {}) render :rdoc, template, , locals end |
#sass(template, options = {}, locals = {}) ⇒ Object
715 716 717 718 |
# File 'lib/sinatra/base.rb', line 715 def sass(template, = {}, locals = {}) .merge! :layout => false, :default_content_type => :css render :sass, template, , locals end |
#scss(template, options = {}, locals = {}) ⇒ Object
720 721 722 723 |
# File 'lib/sinatra/base.rb', line 720 def scss(template, = {}, locals = {}) .merge! :layout => false, :default_content_type => :css render :scss, template, , locals end |
#slim(template, options = {}, locals = {}, &block) ⇒ Object
779 780 781 |
# File 'lib/sinatra/base.rb', line 779 def slim(template, = {}, locals = {}, &block) render(:slim, template, , locals, &block) end |
#stylus(template, options = {}, locals = {}) ⇒ Object
730 731 732 733 |
# File 'lib/sinatra/base.rb', line 730 def stylus(template, = {}, locals = {}) .merge! :layout => false, :default_content_type => :css render :styl, template, , locals end |
#textile(template, options = {}, locals = {}) ⇒ Object
749 750 751 |
# File 'lib/sinatra/base.rb', line 749 def textile(template, = {}, locals = {}) render :textile, template, , locals end |
#wlang(template, options = {}, locals = {}, &block) ⇒ Object
791 792 793 |
# File 'lib/sinatra/base.rb', line 791 def wlang(template, = {}, locals = {}, &block) render(:wlang, template, , locals, &block) end |
#yajl(template, options = {}, locals = {}) ⇒ Object
795 796 797 798 |
# File 'lib/sinatra/base.rb', line 795 def yajl(template, = {}, locals = {}) [:default_content_type] = :json render :yajl, template, , locals end |