module Webgen::Tag::IncludeFile

Includes a file verbatim and optionally escapes all special HTML characters and/or processes webgen tags in it.

Public Class Methods

call(tag, _body, context) click to toggle source

Include the specified file verbatim in the output, optionally escaping special HTML characters and/or processing tags in it.

# File lib/webgen/tag/include_file.rb, line 13
def self.call(tag, _body, context)
  filename = context[:config]['tag.include_file.filename']
  filename = File.join(context.website.directory, filename) unless filename =~ /^(\/|\w:)/
  if !File.exist?(filename)
    raise Webgen::RenderError.new("File '#{filename}' cannot be included because it does not exist",
                                  "tag.#{tag}", context.dest_node, context.ref_node)
  end

  content = File.read(filename)
  content = CGI::escapeHTML(content) if context[:config]['tag.include_file.escape_html']
  context.website.ext.item_tracker.add(context.dest_node, :file, filename)

  [content, context[:config]['tag.include_file.process_output']]
end