Class: RDoc::Markup::ToHtmlCrossref

# File 'lib/rdoc/markup/to_html_crossref.rb', line 22

attr_accessor :show_hash

# File 'lib/rdoc/markup/to_html_crossref.rb', line 62

def cross_reference(name, text = nil, code = true, rdoc_ref: false)
  # Strip '#' for link display text (e.g. #method shows as "method" in links)
  display = !@show_hash && name.start_with?('#') ? name[1..] : name

  if !display.end_with?('+@', '-@') && match = display.match(/(.*[^#:])?@(.*)/)
    context_name = match[1]
    label = convert_string(RDoc::Text.decode_legacy_label(match[2]))
    text ||= "#{label} at <code>#{convert_string(context_name)}</code>" if context_name
    text ||= label
    code = false
  else
    text ||= convert_string(display)
  end

  link(name, text, code, rdoc_ref: rdoc_ref)
end

# File 'lib/rdoc/markup/to_html_crossref.rb', line 143

def gen_url(url, text)
  if url =~ /\Ardoc-ref:/
    name = $'
    cross_reference(name, text, name == text, rdoc_ref: true) || text
  else
    super
  end
end

# File 'lib/rdoc/markup/to_html_crossref.rb', line 86

def handle_regexp_CROSSREF(name)
  return convert_string(name) if in_tidylink_label?
  return name if @autolink_excluded_words&.include?(name)

  return name if name =~ /@[\w-]+\.[\w-]/ # labels that look like emails

  unless @hyperlink_all then
    # This ensures that words entirely consisting of lowercase letters will
    # not have cross-references generated (to suppress lots of erroneous
    # cross-references to "new" in text, for instance)
    return name if name =~ /\A[a-z]*\z/
  end
  cross_reference(name, rdoc_ref: false) || convert_string(name)
end

# File 'lib/rdoc/markup/to_html_crossref.rb', line 105

def handle_regexp_HYPERLINK(url)
  return convert_string(url) if in_tidylink_label?

  case url
  when /\Ardoc-ref:/
    ref = $'
    cross_reference(ref, rdoc_ref: true) || convert_string(ref)
  else
    super
  end
end

# File 'lib/rdoc/markup/to_html_crossref.rb', line 125

def handle_regexp_RDOCLINK(url)
  case url
  when /\Ardoc-ref:/
    if in_tidylink_label?
      convert_string(url)
    else
      ref = $'
      cross_reference(ref, rdoc_ref: true) || convert_string(ref)
    end
  else
    super
  end
end

# File 'lib/rdoc/markup/to_html_crossref.rb', line 223

def handle_TT(code)
  emit_inline(tt_cross_reference(code) || "<code>#{convert_string(code)}</code>")
end

# File 'lib/rdoc/markup/to_html_crossref.rb', line 48

def init_link_notation_regexp_handlings
  add_regexp_handling_RDOCLINK

  # The crossref must be linked before tidylink because Klass.method[:sym]
  # will be processed as a tidylink first and will be broken.
  crossref_re = @hyperlink_all ? ALL_CROSSREF_REGEXP : CROSSREF_REGEXP
  @markup.add_regexp_handling crossref_re, :CROSSREF
end

# File 'lib/rdoc/markup/to_html_crossref.rb', line 157

def link(name, html_string, code = true, rdoc_ref: false)
  if !(name.end_with?('+@', '-@')) and name =~ /(.*[^#:])?@/
    name = $1
    label = $'
  end

  ref = @cross_reference.resolve name if name

  # Non-text source files (C, Ruby, etc.) don't get HTML pages generated,
  # so don't auto-link to them. Explicit rdoc-ref: links are still allowed.
  if !rdoc_ref && RDoc::TopLevel === ref && !ref.text?
    return
  end

  if ref
    path = ref.as_href(@from_path)

    if code and RDoc::CodeObject === ref and !(RDoc::TopLevel === ref)
      html_string = "<code>#{html_string}</code>"
    end
  elsif name
    if rdoc_ref && @warn_missing_rdoc_ref
      puts "#{@from_path}: `rdoc-ref:#{name}` can't be resolved for `#{html_string}`"
    end
    return
  else
    # A bare label reference like @foo still produces a valid anchor link
    return unless label
    path = +""
  end

  if label
    # Decode legacy labels (e.g., "What-27s+Here" -> "What's Here")
    # then convert to GitHub-style anchor format
    decoded_label = RDoc::Text.decode_legacy_label(label)
    formatted_label = RDoc::Text.to_anchor(decoded_label)

    # Case 1: Path already has an anchor (e.g., method link)
    #   Input:  C1#method@label -> path="C1.html#method-i-m"
    #   Output: C1.html#method-i-m-label
    if path =~ /#/
      path << "-#{formatted_label}"

    # Case 2: Label matches a section title
    #   Input:  C1@Section -> path="C1.html", section "Section" exists
    #   Output: C1.html#section (uses section.aref for GitHub-style)
    elsif (section = ref&.sections&.find { |s| decoded_label == s.title })
      path << "##{section.aref}"

    # Case 3: Ref has an aref (class/module context)
    #   Input:  C1@heading -> path="C1.html", ref=C1 class
    #   Output: C1.html#class-c1-heading
    elsif ref.respond_to?(:aref)
      path << "##{ref.aref}-#{formatted_label}"

    # Case 4: No context, just the label (e.g., TopLevel/file)
    #   Input:  README@section -> path="README_md.html"
    #   Output: README_md.html#section
    else
      path << "##{formatted_label}"
    end
  end

  "<a href=\"#{path}\">#{html_string}</a>"
end

# File 'lib/rdoc/markup/to_html_crossref.rb', line 240

def tt_cross_reference(code)
  return if in_tidylink_label?

  crossref_regexp = @hyperlink_all ? ALL_CROSSREF_REGEXP : CROSSREF_REGEXP
  # REGEXP sometimes matches a string that starts with a backslash but is not a
  # suppressed cross-reference (for example, `\+`), so the backslash-removed
  # part needs to be checked against crossref_regexp.
  match = crossref_regexp.match(code.delete_prefix('\\'))
  return unless match && match.begin(1).zero?
  return unless match.post_match.match?(/\A[[:punct:]\s]*\z/)

  # cross_reference(file_page) may return a link without code tag.
  # We need to check it because this method shouldn't return an html text without code tag.
  if code.start_with?('\\')
    # Remove leading backslash if crossref exists
    "<code>#{convert_string(code[1..])}</code>" if cross_reference(code[1..])&.include?('<code>')
  else
    html = cross_reference(code)
    html if html&.include?('<code>')
  end
end