def require(file, options = {})
      document = generate_output(file)

      document.attributes.merge!(options[:attributes] || {})
      content = options[:inline] ? document.to_html : document.to_html_document
      store_in_file(File.basename(file, ".mkd"), content, options[:output])

      content
    end
def require(file, options = {})
      document = generate_output(file)

      document.attributes.merge!(options[:attributes] || {})
      content = options[:inline] ? document.to_html : document.to_html_document
      store_in_file(File.basename(file, ".mkd"), content, options[:output])

      content
    end
<tt>file</tt> has to have a <tt>.mkd</tt> extension. The
 <tt>LOAD_PATH</tt> will be used to find the file. It will be simply
 executed. If called with <tt>:output => dir</tt>, html generated from the
 markdown document will be stored in the given directory. The resulting
 file name will include the basename of <tt>file</tt> and the
 <tt>.html</tt> file extension.

 Additionally default values, that influence the code generation and
 execution may be set.

   LiterateMaruku.require("file.mkd", :output => ".",
                                      :attributes => {:execute => true})

 will enable execution for all code block per default, for example. Other
 options are <tt>:attach_output</tt> and <tt>:hide</tt>.