Files

Jekyll::Convertible

Public Instance Methods

converter() click to toggle source

Determine which converter to use based on this convertible's extension.

Returns the Converter instance.

# File lib/jekyll/convertible.rb, line 61
def converter
  @converter ||= self.site.converters.find { |c| c.matches(self.ext) }
end
do_layout(payload, layouts) click to toggle source

Add any necessary layouts to this convertible document.

payload - The site payload Hash. layouts - A Hash of {"name" => "layout"}.

Returns nothing.

# File lib/jekyll/convertible.rb, line 71
def do_layout(payload, layouts)
  info = { :filters => [Jekyll::Filters], :registers => { :site => self.site } }

  # render and transform content (this becomes the final content of the object)
  payload["pygments_prefix"] = converter.pygments_prefix
  payload["pygments_suffix"] = converter.pygments_suffix

  begin
    self.content = Liquid::Template.parse(self.content).render(payload, info)
  rescue => e
    puts "Liquid Exception: #{e.message} in #{self.name}"
  end

  self.transform

  # output keeps track of what will finally be written
  self.output = self.content

  # recursively render layouts
  layout = layouts[self.data["layout"]]
  used = Set.new([layout])

  while layout
    payload = payload.deep_merge({"content" => self.output, "page" => layout.data})

    begin
      self.output = Liquid::Template.parse(layout.content).render(payload, info)
    rescue => e
      puts "Liquid Exception: #{e.message} in #{self.data["layout"]}"
    end

    if layout = layouts[layout.data["layout"]]
      if used.include?(layout)
        layout = nil # avoid recursive chain
      else
        used << layout
      end
    end
  end
end
output_ext() click to toggle source

Determine the extension depending on content_type.

Returns the String extension for the output file.

e.g. ".html" for an HTML output file.
# File lib/jekyll/convertible.rb, line 53
def output_ext
  converter.output_ext(self.ext)
end
read_yaml(base, name) click to toggle source

Read the YAML frontmatter.

base - The String path to the dir containing the file. name - The String filename of the file.

Returns nothing.

# File lib/jekyll/convertible.rb, line 26
def read_yaml(base, name)
  self.content = File.read(File.join(base, name))

  if self.content =~ /^(---\s*\n.*?\n?)^(---\s*$\n?)/
    self.content = $POSTMATCH

    begin
      self.data = YAML.load($1)
    rescue => e
      puts "YAML Exception reading #{name}: #{e.message}"
    end
  end

  self.data ||= {}
end
to_s() click to toggle source

Returns the contents as a String.

# File lib/jekyll/convertible.rb, line 16
def to_s
  self.content || ''
end
transform() click to toggle source

Transform the contents based on the content type.

Returns nothing.

# File lib/jekyll/convertible.rb, line 45
def transform
  self.content = converter.convert(self.content)
end

[Validate]

Generated with the Darkfish Rdoc Generator 2.