Class: Tilt::LiquidTemplate

Inherits:
Template show all
Defined in:
lib/tilt/liquid.rb

Overview

Liquid template implementation. See: liquid.rubyforge.org/

Liquid is designed to be a safe template system and threfore does not provide direct access to execuatable scopes. In order to support a scope, the scope must be able to represent itself as a hash by responding to #to_h. If the scope does not respond to #to_h it will be ignored.

LiquidTemplate does not support yield blocks.

It's suggested that your program require 'liquid' at load time when using this template engine.

Instance Attribute Summary

Attributes inherited from Template

#data, #file, #line, #options

Class Method Summary (collapse)

Instance Method Summary (collapse)

Methods inherited from Template

#basename, cached_evaluate, #compile_template_method, #eval_file, #evaluate_source, #initialize, #name, #render

Constructor Details

This class inherits a constructor from Tilt::Template

Class Method Details

+ (Boolean) engine_initialized?

Returns:

  • (Boolean)


18
19
20
# File 'lib/tilt/liquid.rb', line 18

def self.engine_initialized?
  defined? ::Liquid::Template
end

Instance Method Details

- (Object) evaluate(scope, locals, &block)



30
31
32
33
34
35
36
37
38
39
# File 'lib/tilt/liquid.rb', line 30

def evaluate(scope, locals, &block)
  locals = locals.inject({}){ |h,(k,v)| h[k.to_s] = v ; h }
  if scope.respond_to?(:to_h)
    scope  = scope.to_h.inject({}){ |h,(k,v)| h[k.to_s] = v ; h }
    locals = scope.merge(locals)
  end
  locals['yield'] = block.nil? ? '' : yield
  locals['content'] = locals['yield']
  @engine.render(locals)
end

- (Object) initialize_engine



22
23
24
# File 'lib/tilt/liquid.rb', line 22

def initialize_engine
  require_template_library 'liquid'
end

- (Object) prepare



26
27
28
# File 'lib/tilt/liquid.rb', line 26

def prepare
  @engine = ::Liquid::Template.parse(data)
end