class RDoc::Markup::ToHtml

Outputs RDoc markup as HTML.

Public Class Methods

new(options, markup = nil) click to toggle source

Creates a new formatter that will output HTML

Calls superclass method RDoc::Markup::Formatter::new
# File rdoc/markup/to_html.rb, line 45
def initialize options, markup = nil
  super

  @code_object = nil
  @from_path = ''
  @in_list_entry = nil
  @list = nil
  @th = nil
  @hard_break = "<br>\n"

  init_regexp_handlings

  init_tags
end

Regexp Handling

↑ top

Constants

URL_CHARACTERS_REGEXP_STR

Public Instance Methods

handle_regexp_HARD_BREAK(target) click to toggle source

target is a <br>

# File rdoc/markup/to_html.rb, line 109
def handle_regexp_HARD_BREAK target
  '<br>'
end
init_regexp_handlings() click to toggle source

Adds regexp handlings.

# File rdoc/markup/to_html.rb, line 69
def init_regexp_handlings
  # external links
  @markup.add_regexp_handling(/(?:link:|https?:|mailto:|ftp:|irc:|www\.)#{URL_CHARACTERS_REGEXP_STR}+\w/,
                              :HYPERLINK)
  init_link_notation_regexp_handlings
end

Utilities

↑ top

Constants

LIST_TYPE_TO_HTML

Maps RDoc::Markup::Parser::LIST_TOKENS types to HTML tags

Attributes

code_object[RW]

The RDoc::CodeObject HTML is being generated for. This is used to generate namespaced URI fragments

from_path[RW]

Path to this document for relative links

Public Instance Methods

convert_string(text) click to toggle source

CGI-escapes text

# File rdoc/markup/to_html.rb, line 349
def convert_string(text)
  CGI.escapeHTML text
end
gen_url(url, text) click to toggle source

Generate a link to url with content text. Handles the special cases for img: and link: described under handle_regexp_HYPERLINK

# File rdoc/markup/to_html.rb, line 357
def gen_url url, text
  scheme, url, id = parse_url url

  if %w[http https link].include?(scheme) and
     url =~ /\.(gif|png|jpg|jpeg|bmp)$/ then
    "<img src=\"#{url}\" />"
  else
    if scheme != 'link' and %r%\A((?!https?:)(?:[^/#]*/)*+)([^/#]+)\.(rb|rdoc|md)(?=\z|#)%i =~ url
      url = "#$1#{$2.tr('.', '_')}_#$3.html#$'"
    end

    text = text.sub %r%^#{scheme}:/*%i, ''
    text = text.sub %r%^[*\^](\d+)$%,   '\1'

    link = "<a#{id} href=\"#{url}\">#{text}</a>"

    link = "<sup>#{link}</sup>" if /"foot/ =~ id

    link
  end
end
html_list_name(list_type, open_tag) click to toggle source

Determines the HTML list element for list_type and open_tag

# File rdoc/markup/to_html.rb, line 382
def html_list_name(list_type, open_tag)
  tags = LIST_TYPE_TO_HTML[list_type]
  raise RDoc::Error, "Invalid list type: #{list_type.inspect}" unless tags
  tags[open_tag ? 0 : 1]
end
init_tags() click to toggle source

Maps attributes to HTML tags

# File rdoc/markup/to_html.rb, line 391
def init_tags
  add_tag :BOLD, "<strong>", "</strong>"
  add_tag :TT,   "<code>",   "</code>"
  add_tag :EM,   "<em>",     "</em>"
end
list_end_for(list_type) click to toggle source

Returns the HTML end-tag for list_type

# File rdoc/markup/to_html.rb, line 417
def list_end_for(list_type)
  case list_type
  when :BULLET, :LALPHA, :NUMBER, :UALPHA then
    "</li>"
  when :LABEL, :NOTE then
    "</dd>"
  else
    raise RDoc::Error, "Invalid list type: #{list_type.inspect}"
  end
end
list_item_start(list_item, list_type) click to toggle source

Returns the HTML tag for list_type, possible using a label from list_item

# File rdoc/markup/to_html.rb, line 401
def list_item_start(list_item, list_type)
  case list_type
  when :BULLET, :LALPHA, :NUMBER, :UALPHA then
    "<li>"
  when :LABEL, :NOTE then
    Array(list_item.label).map do |label|
      "<dt>#{to_html label}\n"
    end.join << "<dd>"
  else
    raise RDoc::Error, "Invalid list type: #{list_type.inspect}"
  end
end
parseable?(text) click to toggle source

Returns true if text is valid ruby syntax

# File rdoc/markup/to_html.rb, line 431
def parseable? text
  verbose, $VERBOSE = $VERBOSE, nil
  catch(:valid) do
    eval("BEGIN { throw :valid, true }\n#{text}")
  end
rescue SyntaxError
  false
ensure
  $VERBOSE = verbose
end
to_html(item) click to toggle source

Converts item to HTML using RDoc::Text#to_html

Calls superclass method RDoc::Text#to_html
# File rdoc/markup/to_html.rb, line 445
def to_html item
  super convert_flow @am.flow item
end

Visitor

↑ top

Public Instance Methods

accept_blank_line(blank_line) click to toggle source

Adds blank_line to the output

# File rdoc/markup/to_html.rb, line 288
def accept_blank_line(blank_line)
  # @res << annotate("<p />") << "\n"
end
accept_block_quote(block_quote) click to toggle source

Adds block_quote to the output

# File rdoc/markup/to_html.rb, line 189
def accept_block_quote block_quote
  @res << "\n<blockquote>"

  block_quote.parts.each do |part|
    part.accept self
  end

  @res << "</blockquote>\n"
end
accept_heading(heading) click to toggle source

Adds heading to the output. The headings greater than 6 are trimmed to level 6.

# File rdoc/markup/to_html.rb, line 296
def accept_heading heading
  level = [6, heading.level].min

  label = heading.label @code_object

  @res << if @options.output_decoration
            "\n<h#{level} id=\"#{label}\">"
          else
            "\n<h#{level}>"
          end
  @res << to_html(heading.text)
  unless @options.pipe then
    @res << "<span><a href=\"##{label}\">&para;</a>"
    @res << " <a href=\"#top\">&uarr;</a></span>"
  end
  @res << "</h#{level}>\n"
end
accept_list_end(list) click to toggle source

Finishes consumption of list

# File rdoc/markup/to_html.rb, line 259
def accept_list_end(list)
  @list.pop
  if tag = @in_list_entry.pop
    @res << tag
  end
  @res << html_list_name(list.type, false) << "\n"
end
accept_list_item_end(list_item) click to toggle source

Finishes consumption of list_item

# File rdoc/markup/to_html.rb, line 281
def accept_list_item_end(list_item)
  @in_list_entry[-1] = list_end_for(@list.last)
end
accept_list_item_start(list_item) click to toggle source

Prepares the visitor for consuming list_item

# File rdoc/markup/to_html.rb, line 270
def accept_list_item_start(list_item)
  if tag = @in_list_entry.last
    @res << tag
  end

  @res << list_item_start(list_item, @list.last)
end
accept_list_start(list) click to toggle source

Prepares the visitor for consuming list

# File rdoc/markup/to_html.rb, line 250
def accept_list_start(list)
  @list << list.type
  @res << html_list_name(list.type, true)
  @in_list_entry.push false
end
accept_paragraph(paragraph) click to toggle source

Adds paragraph to the output

# File rdoc/markup/to_html.rb, line 202
def accept_paragraph paragraph
  @res << "\n<p>"
  text = paragraph.text @hard_break
  text = text.gsub(/\r?\n/, ' ')
  @res << to_html(text)
  @res << "</p>\n"
end
accept_raw(raw) click to toggle source

Adds raw to the output

# File rdoc/markup/to_html.rb, line 317
def accept_raw raw
  @res << raw.parts.join("\n")
end
accept_rule(rule) click to toggle source

Adds rule to the output

# File rdoc/markup/to_html.rb, line 243
def accept_rule rule
  @res << "<hr>\n"
end
accept_table(header, body, aligns) click to toggle source

Adds table to the output

# File rdoc/markup/to_html.rb, line 324
def accept_table header, body, aligns
  @res << "\n<table role=\"table\">\n<thead>\n<tr>\n"
  header.zip(aligns) do |text, align|
    @res << '<th'
    @res << ' align="' << align << '"' if align
    @res << '>' << to_html(text) << "</th>\n"
  end
  @res << "</tr>\n</thead>\n<tbody>\n"
  body.each do |row|
    @res << "<tr>\n"
    row.zip(aligns) do |text, align|
      @res << '<td'
      @res << ' align="' << align << '"' if align
      @res << '>' << to_html(text) << "</td>\n"
    end
    @res << "</tr>\n"
  end
  @res << "</tbody>\n</table>\n"
end
accept_verbatim(verbatim) click to toggle source

Adds verbatim to the output

# File rdoc/markup/to_html.rb, line 213
def accept_verbatim verbatim
  text = verbatim.text.rstrip

  klass = nil

  content = if verbatim.ruby? or parseable? text then
              begin
                tokens = RDoc::Parser::RipperStateLex.parse text
                klass  = ' class="ruby"'

                result = RDoc::TokenStream.to_html tokens
                result = result + "\n" unless "\n" == result[-1]
                result
              rescue
                CGI.escapeHTML text
              end
            else
              CGI.escapeHTML text
            end

  if @options.pipe then
    @res << "\n<pre><code>#{CGI.escapeHTML text}\n</code></pre>\n"
  else
    @res << "\n<pre#{klass}>#{content}</pre>\n"
  end
end
end_accepting() click to toggle source

Returns the generated output

# File rdoc/markup/to_html.rb, line 182
def end_accepting
  @res.join
end
start_accepting() click to toggle source

Prepares the visitor for HTML generation

# File rdoc/markup/to_html.rb, line 173
def start_accepting
  @res = []
  @in_list_entry = []
  @list = []
end