Class: RDoc::Markup::ToHtml

# File 'lib/rdoc/markup/to_html.rb', line 38

attr_accessor :from_path

# File 'lib/rdoc/markup/to_html.rb', line 26

attr_reader :in_list_entry # :nodoc:

# File 'lib/rdoc/markup/to_html.rb', line 27

attr_reader :list # :nodoc:

# File 'lib/rdoc/markup/to_html.rb', line 25

attr_reader :res # :nodoc:

# File 'lib/rdoc/markup/to_html.rb', line 190

def accept_block_quote block_quote
  @res << "\n<blockquote>"

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

  @res << "</blockquote>\n"
end

# File 'lib/rdoc/markup/to_html.rb', line 299

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

# File 'lib/rdoc/markup/to_html.rb', line 262

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

# File 'lib/rdoc/markup/to_html.rb', line 284

def accept_list_item_end(list_item)
  @in_list_entry[-1] = list_end_for(@list.last)
end

# File 'lib/rdoc/markup/to_html.rb', line 273

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

# File 'lib/rdoc/markup/to_html.rb', line 253

def accept_list_start(list)
  @list << list.type
  @res << html_list_name(list.type, true)
  @in_list_entry.push false
end

# File 'lib/rdoc/markup/to_html.rb', line 203

def accept_paragraph paragraph
  @res << "\n<p>"
  text = paragraph.text @hard_break
  text = text.gsub(/(#{SPACE_SEPARATED_LETTER_CLASS})?\K\r?\n(?=(?(1)(#{SPACE_SEPARATED_LETTER_CLASS})?))/o) {
    defined?($2) && ' '
  }
  @res << to_html(text)
  @res << "</p>\n"
end

# File 'lib/rdoc/markup/to_html.rb', line 320

def accept_raw raw
  @res << raw.parts.join("\n")
end

# File 'lib/rdoc/markup/to_html.rb', line 246

def accept_rule rule
  @res << "<hr>\n"
end

# File 'lib/rdoc/markup/to_html.rb', line 327

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

# File 'lib/rdoc/markup/to_html.rb', line 216

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

# File 'lib/rdoc/markup/to_html.rb', line 352

def convert_string(text)
  CGI.escapeHTML text
end

# File 'lib/rdoc/markup/to_html.rb', line 183

def end_accepting
  @res.join
end

# File 'lib/rdoc/markup/to_html.rb', line 360

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

# File 'lib/rdoc/markup/to_html.rb', line 85

def handle_RDOCLINK url # :nodoc:
  case url
  when /^rdoc-ref:/
    CGI.escapeHTML($')
  when /^rdoc-label:/
    text = $'

    text = case text
           when /\Alabel-/    then $'
           when /\Afootmark-/ then $'
           when /\Afoottext-/ then $'
           else                    text
           end

    gen_url CGI.escapeHTML(url), CGI.escapeHTML(text)
  when /^rdoc-image:/
    %[<img src=\"#{CGI.escapeHTML($')}\">]
  when /\Ardoc-[a-z]+:/
    CGI.escapeHTML($')
  end
end

# File 'lib/rdoc/markup/to_html.rb', line 110

def handle_regexp_HARD_BREAK target
  '<br>'
end

# File 'lib/rdoc/markup/to_html.rb', line 126

def handle_regexp_HYPERLINK(target)
  url = CGI.escapeHTML(target.text)

  gen_url url, url
end

# File 'lib/rdoc/markup/to_html.rb', line 141

def handle_regexp_RDOCLINK target
  handle_RDOCLINK target.text
end

# File 'lib/rdoc/markup/to_html.rb', line 149

def handle_regexp_TIDYLINK(target)
  text = target.text

  return text unless
    text =~ /^\{(.*)\}\[(.*?)\]$/ or text =~ /^(\S+)\[(.*?)\]$/

  label = $1
  url   = CGI.escapeHTML($2)

  if /^rdoc-image:/ =~ label
    label = handle_RDOCLINK(label)
  else
    label = CGI.escapeHTML(label)
  end

  gen_url url, label
end

# File 'lib/rdoc/markup/to_html.rb', line 385

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

# File 'lib/rdoc/markup/to_html.rb', line 80

def init_link_notation_regexp_handlings
  add_regexp_handling_RDOCLINK
  add_regexp_handling_TIDYLINK
end

# File 'lib/rdoc/markup/to_html.rb', line 70

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

# File 'lib/rdoc/markup/to_html.rb', line 394

def init_tags
  add_tag :BOLD, "<strong>", "</strong>"
  add_tag :TT,   "<code>",   "</code>"
  add_tag :EM,   "<em>",     "</em>"
end

# File 'lib/rdoc/markup/to_html.rb', line 420

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

# File 'lib/rdoc/markup/to_html.rb', line 404

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

# File 'lib/rdoc/markup/to_html.rb', line 434

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

# File 'lib/rdoc/markup/to_html.rb', line 174

def start_accepting
  @res = []
  @in_list_entry = []
  @list = []
end

# File 'lib/rdoc/markup/to_html.rb', line 448

def to_html item
  super convert_flow @am.flow item
end