module SDoc::Templatable
def eval_template(templatefile, context)
## specified +context+ (a Binding object) and return output
## Load and render the erb template in the given +templatefile+ within the
def eval_template(templatefile, context) template_src = templatefile.read template = if ERB.instance_method(:initialize).parameters.assoc(:key) # Ruby 2.6+ ERB.new( template_src, trim_mode: '<>' ) else ERB.new( template_src, nil, '<>' ) end template.filename = templatefile.to_s begin template.result( context ) rescue NoMethodError => err raise RDoc::Error, "Error while evaluating %s: %s (at %p)" % [ templatefile.to_s, err.message, eval( "_erbout[-50,50]", context ) ], err.backtrace end end
def include_template(template_name, local_assigns = {})
## Load and render the erb template with the given +template_name+ within
def include_template(template_name, local_assigns = {}) source = local_assigns.keys.map { |key| "#{key} = local_assigns[:#{key}];" }.join templatefile = templatefile = @template_dir + template_name eval("#{source};eval_template(templatefile, binding)") end
def render_template( templatefile, context, outfile )
## specified +context+ (a Binding object) and write it out to +outfile+.
## Load and render the erb template in the given +templatefile+ within the
def render_template( templatefile, context, outfile ) output = eval_template(templatefile, context) # TODO delete this dirty hack when documentation for example for GeneratorMethods will not be cutted off by <script> tag begin if output.respond_to? :force_encoding encoding = output.encoding output = output.force_encoding('ASCII-8BIT').gsub('<script>', '<script;>').force_encoding(encoding) else output = output.gsub('<script>', '<script>') end rescue Exception end unless $dryrun outfile.dirname.mkpath outfile.open( 'w', 0644 ) do |file| file.print( output ) end else debug_msg " would have written %d bytes to %s" % [ output.length, outfile ] end end