Class: RDoc::Markup::Formatter
Relationships & Source Files | |
Namespace Children | |
Classes:
| |
Extension / Inclusion / Inheritance Descendants | |
Subclasses:
|
|
Inherits: | Object |
Defined in: | lib/rdoc/markup/formatter.rb |
Overview
Base class for ::RDoc::RDoc
markup formatters
Formatters are a visitor that converts an ::RDoc::Markup
tree (from a comment) into some kind of output. ::RDoc::RDoc
ships with formatters for converting back to rdoc, ANSI text, HTML, a Table
of Contents and other formats.
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.
Class Method Summary
-
.gen_relative_url(path, target)
Converts a target url to one that is relative to a given path.
-
.new(options, markup = nil) ⇒ Formatter
constructor
Creates a new
Formatter
.
Instance Attribute Summary
-
#in_tt? ⇒ Boolean
readonly
Are we currently inside tt tags?
Instance Method Summary
-
#accept_document(document)
Adds
document
to the output. -
#add_regexp_handling_RDOCLINK
Adds a regexp handling for links of the form rdoc-…:
-
#add_regexp_handling_TIDYLINK
Adds a regexp handling for links of the form
<text>
and <word>. -
#add_tag(name, start, stop)
Add a new set of tags for an attribute.
-
#annotate(tag)
Allows
tag
to be decorated with additional information. -
#convert(content)
Marks up
content
-
#convert_flow(flow)
Converts flow items
flow
-
#convert_regexp_handling(target)
Converts added regexp handlings.
-
#convert_string(string)
Converts a string to be fancier if desired.
-
#ignore(*node)
(also: #accept_raw, #accept_rule, #accept_block_quote, #accept_heading, #accept_list_end, #accept_list_item_end, #accept_list_item_start, #accept_list_start, #accept_raw, #accept_rule, #accept_verbatim, #accept_table, #accept_block_quote, #accept_raw, #accept_rule, #accept_blank_line, #accept_paragraph, #accept_verbatim, #accept_list_end, #accept_list_item_start, #accept_list_item_end, #accept_list_end_bullet, #accept_list_start, #accept_table)
Use ignore in your subclass to ignore the content of a node.
-
#off_tags(res, item)
Turns off tags for
item
onres
-
#on_tags(res, item)
Turns on tags for
item
onres
-
#parse_url(url)
Extracts and a scheme, url and an anchor id from
url
and returns them. -
#tt?(tag) ⇒ Boolean
Is
tag
a tt tag?
Constructor Details
.new(options, markup = nil) ⇒ Formatter
Creates a new Formatter
# File 'lib/rdoc/markup/formatter.rb', line 48
def initialize , markup = nil @options = @markup = markup || RDoc::Markup.new @am = @markup.attribute_manager @am.add_regexp_handling(/<br>/, :HARD_BREAK) @attributes = @am.attributes @attr_tags = [] @in_tt = 0 @tt_bit = @attributes.bitmap_for :TT @hard_break = '' @from_path = '.' end
Class Method Details
.gen_relative_url(path, target)
Converts a target url to one that is relative to a given path
# File 'lib/rdoc/markup/formatter.rb', line 24
def self.gen_relative_url path, target from = File.dirname path to, to_file = File.split target from = from.split "/" to = to.split "/" from.delete '.' to.delete '.' while from.size > 0 and to.size > 0 and from[0] == to[0] do from.shift to.shift end from.fill ".." from.concat to from << to_file File.join(*from) end
Instance Attribute Details
#in_tt? ⇒ Boolean
(readonly)
Are we currently inside tt tags?
# File 'lib/rdoc/markup/formatter.rb', line 194
def in_tt? @in_tt > 0 end
Instance Method Details
#accept_document(document)
Adds document
to the output
#add_regexp_handling_RDOCLINK
Adds a regexp handling for links of the form rdoc-…:
# File 'lib/rdoc/markup/formatter.rb', line 83
def add_regexp_handling_RDOCLINK @markup.add_regexp_handling(/rdoc-[a-z]:[^\s\]]/, :RDOCLINK) end
#add_regexp_handling_TIDYLINK
Adds a regexp handling for links of the form <text>
and <word>
# File 'lib/rdoc/markup/formatter.rb', line 91
def add_regexp_handling_TIDYLINK @markup.add_regexp_handling(/(?: \{[^{}]*\} | # multi-word label \b[^\s{}]+? # single-word label ) \[\S+?\] # link target /x, :TIDYLINK) end
#add_tag(name, start, stop)
Add a new set of tags for an attribute. We allow separate start and end tags for flexibility
#annotate(tag)
Allows tag
to be decorated with additional information.
# File 'lib/rdoc/markup/formatter.rb', line 113
def annotate(tag) tag end
#convert(content)
Marks up content
# File 'lib/rdoc/markup/formatter.rb', line 120
def convert content @markup.convert content, self end
#convert_flow(flow)
Converts flow items flow
# File 'lib/rdoc/markup/formatter.rb', line 127
def convert_flow(flow) res = [] flow.each do |item| case item when String then res << convert_string(item) when RDoc::Markup::AttrChanger then res, item res, item when RDoc::Markup::RegexpHandling then res << convert_regexp_handling(item) else raise "Unknown flow element: #{item.inspect}" end end res.join end
#convert_regexp_handling(target)
Converts added regexp handlings. See RDoc::Markup#add_regexp_handling
# File 'lib/rdoc/markup/formatter.rb', line 150
def convert_regexp_handling target return target.text if in_tt? handled = false @attributes.each_name_of target.type do |name| method_name = "handle_regexp_#{name}" if respond_to? method_name then target.text = public_send method_name, target handled = true end end unless handled then target_name = @attributes.as_string target.type raise RDoc::Error, "Unhandled regexp handling #{target_name}: #{target}" end target.text end
#convert_string(string)
Converts a string to be fancier if desired
# File 'lib/rdoc/markup/formatter.rb', line 176
def convert_string string string end
#ignore(*node) Also known as: #accept_raw, #accept_rule, #accept_block_quote, #accept_heading, #accept_list_end, #accept_list_item_end, #accept_list_item_start, #accept_list_start, #accept_raw, #accept_rule, #accept_verbatim, #accept_table, #accept_block_quote, #accept_raw, #accept_rule, #accept_blank_line, #accept_paragraph, #accept_verbatim, #accept_list_end, #accept_list_item_start, #accept_list_item_end, #accept_list_end_bullet, #accept_list_start, #accept_table
Use ignore in your subclass to ignore the content of a node.
##
# We don't support raw nodes in ToNoRaw
alias accept_raw ignore
# File 'lib/rdoc/markup/formatter.rb', line 188
def ignore *node end
#off_tags(res, item)
Turns off tags for item
on res
#on_tags(res, item)
Turns on tags for item
on res
#parse_url(url)
Extracts and a scheme, url and an anchor id from url
and returns them.
# File 'lib/rdoc/markup/formatter.rb', line 231
def parse_url url case url when /^rdoc-label:([^:]*)(?::(.*))?/ then scheme = 'link' path = "##{$1}" id = " id=\"#{$2}\"" if $2 when /([A-Za-z]+):(.*)/ then scheme = $1.downcase path = $2 when /^#/ then else scheme = 'http' path = url url = url end if scheme == 'link' then url = if path[0, 1] == '#' then # is this meaningful? path else self.class.gen_relative_url @from_path, path end end [scheme, url, id] end
#tt?(tag) ⇒ Boolean
Is tag
a tt tag?
# File 'lib/rdoc/markup/formatter.rb', line 261
def tt? tag tag.bit == @tt_bit end