Base class for RDoc markup formatters

Formatters use a visitor pattern to convert content into output.

If you'd like to write your own Formatter use RDoc::Markup::FormatterTestCase. If you're writing a text-output formatter use RDoc::Markup::TextFormatterTestCase which provides extra test cases.

Methods
A
C
I
N
O
T
Constants
InlineTag = Struct.new(:bit, :on, :off)
 

Tag for inline markup containing a bit for the bitmask and the on and off triggers.
Class Public methods
new(markup = nil)

Creates a new Formatter

Source: show | on GitHub 

# File ../ruby/lib/rdoc/markup/formatter.rb, line 23
def initialize markup = nil
  @markup = markup || RDoc::Markup.new
  @am     = @markup.attribute_manager

  @attr_tags = []

  @in_tt = 0
  @tt_bit = RDoc::Markup::Attribute.bitmap_for :TT
end
Instance Public methods
accept_document(document)

Adds document to the output

Source: show | on GitHub 

# File ../ruby/lib/rdoc/markup/formatter.rb, line 36
def accept_document document
  document.parts.each do |item|
    item.accept self
  end
end
add_tag(name, start, stop)

Add a new set of tags for an attribute. We allow separate start and end tags for flexibility

Source: show | on GitHub 

# File ../ruby/lib/rdoc/markup/formatter.rb, line 46
def add_tag(name, start, stop)
  attr = RDoc::Markup::Attribute.bitmap_for name
  @attr_tags << InlineTag.new(attr, start, stop)
end
annotate(tag)

Allows tag to be decorated with additional information.

Source: show | on GitHub 

# File ../ruby/lib/rdoc/markup/formatter.rb, line 54
def annotate(tag)
  tag
end
convert(content)

Marks up content

Source: show | on GitHub 

# File ../ruby/lib/rdoc/markup/formatter.rb, line 61
def convert(content)
  @markup.convert content, self
end
convert_flow(flow)

Converts flow items flow

Source: show | on GitHub 

# File ../ruby/lib/rdoc/markup/formatter.rb, line 68
def convert_flow(flow)
  res = []

  flow.each do |item|
    case item
    when String then
      res << convert_string(item)
    when RDoc::Markup::AttrChanger then
      off_tags res, item
      on_tags res, item
    when RDoc::Markup::Special then
      res << convert_special(item)
    else
      raise "Unknown flow element: #{item.inspect}"
    end
  end

  res.join
end
convert_special(special)

Converts added specials. See RDoc::Markup#add_special

Source: show | on GitHub 

# File ../ruby/lib/rdoc/markup/formatter.rb, line 91
def convert_special special
  return special.text if in_tt?

  handled = false

  RDoc::Markup::Attribute.each_name_of special.type do |name|
    method_name = "handle_special_#{name}"

    if respond_to? method_name then
      special.text = send method_name, special
      handled = true
    end
  end

  raise "Unhandled special: #{special}" unless handled

  special.text
end
convert_string(string)

Converts a string to be fancier if desired

Source: show | on GitHub 

# File ../ruby/lib/rdoc/markup/formatter.rb, line 113
def convert_string string
  string
end
in_tt?()

Are we currently inside tt tags?

Source: show | on GitHub 

# File ../ruby/lib/rdoc/markup/formatter.rb, line 120
def in_tt?
  @in_tt > 0
end
off_tags(res, item)

Turns off tags for item on res

Source: show | on GitHub 

# File ../ruby/lib/rdoc/markup/formatter.rb, line 142
def off_tags res, item
  attr_mask = item.turn_off
  return if attr_mask.zero?

  @attr_tags.reverse_each do |tag|
    if attr_mask & tag.bit != 0 then
      @in_tt -= 1 if tt? tag
      res << annotate(tag.off)
    end
  end
end
on_tags(res, item)

Turns on tags for item on res

Source: show | on GitHub 

# File ../ruby/lib/rdoc/markup/formatter.rb, line 127
def on_tags res, item
  attr_mask = item.turn_on
  return if attr_mask.zero?

  @attr_tags.each do |tag|
    if attr_mask & tag.bit != 0 then
      res << annotate(tag.on)
      @in_tt += 1 if tt? tag
    end
  end
end
tt?(tag)

Is tag a tt tag?

Source: show | on GitHub 

# File ../ruby/lib/rdoc/markup/formatter.rb, line 157
def tt? tag
  tag.bit == @tt_bit
end