Contents

module Webgen

  class Context

    # Render the named block and return the result.
    #
    # call-seq:
    #   context.render_block(block_name)<br />
    #   context.render_block(:name => block_name, :option => value, ...)
    #
    # This method uses the functionality of the content processor +blocks+ for doing the actual
    # work, so you may also want to look at Webgen::ContentProcessor::Blocks#render_block. You can
    # call this method in two ways:
    #
    # [<tt>#render_block(block_name)</tt>]
    #   Renders the block named +block_name+ of the next node in the current node chain. This is the
    #   version that most want to use since it is equivalent to the use of <tt><webgen:block
    #   name="block_name" /></tt>. It is equivalent to <tt>#render_block(:name =>
    #   block_name)</tt>.
    #
    # [<tt>#render_block(opts_hash)</tt>]
    #   This version allows the same level of control over the output as the blocks content
    #   processor. For a list of valid options have a look at the documentation of the
    #   Webgen::ContentProcessor::Blocks#render_block method!
    def render_block(name_or_hash)
      name_or_hash = {:name => name_or_hash} if name_or_hash.kind_of?(String)
      website.cache.instance('Webgen::ContentProcessor::Blocks').render_block(self, name_or_hash)
    end

  end

end

Version data entries

10 entries across 10 versions & 2 rubygems

Version	Path
gettalong-webgen-0.5.9.20090620	lib/webgen/context/render.rb
gettalong-webgen-0.5.9.20090626	lib/webgen/context/render.rb
webgen-0.5.17	lib/webgen/context/render.rb
webgen-0.5.15	lib/webgen/context/render.rb
webgen-0.5.14	lib/webgen/context/render.rb
webgen-0.5.13	lib/webgen/context/render.rb
webgen-0.5.12	lib/webgen/context/render.rb
webgen-0.5.11	lib/webgen/context/render.rb
webgen-0.5.10	lib/webgen/context/render.rb
webgen-0.5.9	lib/webgen/context/render.rb