Module: Plezi::Renderer

Defined in:
lib/plezi/render/render.rb

Class Method Summary collapse

Class Method Details

.register(extention, handler = nil, &block) ⇒ Object

Registers a rendering extention.

Slim, Markdown, ERB and SASS are registered by default.

extention

a Symbol or String representing the extention of the file to be rendered. i.e. ‘slim’, ‘md’, ‘erb’, etc’

handler

a Proc or other object that answers to call(filename, context, &block) and returnes the rendered string. The block accepted by the handler is for chaining rendered actions (allowing for ‘yield` within templates) and the context is the object within which the rendering should be performed (if `binding` handling is supported by the engine). `filename` might not point to an existing or valid file.

If a block is passed to the ‘register_hook` method with no handler defined, it will act as the handler.



20
21
22
23
24
25
 
# File 'lib/plezi/render/render.rb', line 20

def register(extention, handler = nil, &block)
   handler ||= block
   raise 'Handler or block required.' unless handler
   @render_library[extention.to_s] = handler
   handler
end

.remove(extention) ⇒ Object

Removes a registered render extention



28
29
30
 
# File 'lib/plezi/render/render.rb', line 28

def remove(extention)
   @render_library.delete extention.to_s
end

.render(base_filename, context = (Object.new.instance_eval { binding }), &block) ⇒ Object

Attempts to render the requested file (i.e. ‘’index.html’‘) using all known rendering handlers.



33
34
35
36
37
 
# File 'lib/plezi/render/render.rb', line 33

def render(base_filename, context = (Object.new.instance_eval { binding }), &block)
   ret = nil
   @render_library.each { |ext, handler| ret = handler.call("#{base_filename}.#{ext}".freeze, context, &block); return ret if ret; }
   ret
end