Class: Coradoc::Html::Converters::CrossReference

Inherits:
Base
  • Object
show all
Defined in:
lib/coradoc/html/converters/cross_reference.rb

Overview

Converter for CoreModel::InlineElement with format_type “xref”

Class Method Summary collapse

Methods inherited from Base

build_class_attribute, build_element, build_html_attributes, convert_content_to_html, convert_element_to_core, convert_node_to_core, escape_attribute, escape_html, extract_model_attributes, extract_node_attributes, extract_text_fallback, find_converter_class_by_name, find_converter_for_model, handle_unknown_content, render_core_abbreviation, render_core_annotation_block, render_core_bibliography, render_core_bibliography_entry, render_core_block, render_core_block_image, render_core_definition_item, render_core_definition_list, render_core_footnote, render_core_footnote_reference, render_core_inline_element, render_core_inline_image, render_core_list_block, render_core_list_item, render_core_span, render_core_structural_element, render_core_table_cell, render_core_table_row, render_core_term, render_core_toc, render_core_toc_entry, resolve_block_semantic_type, resolve_format_specific_semantic, transform_to_coremodel, treat_children

Class Method Details

.to_coradoc(node, _state = {}) ⇒ Coradoc::CoreModel::InlineElement

Convert HTML anchor to CoreModel::InlineElement (xref)

Parameters:

  • node (Nokogiri::XML::Node) —

    HTML anchor node

  • state (Hash) —

    Conversion state

Returns:

  • (Coradoc::CoreModel::InlineElement) —

    CrossReference model



33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
 
# File 'lib/coradoc/html/converters/cross_reference.rb', line 33

def to_coradoc(node, _state = {})
  href = node['href'].to_s
  text = node.text.strip

  # Only treat internal links as cross-references
  if href.start_with?('#')
    ref_id = href[1..] # Remove leading #
    content = text.empty? || text == ref_id ? nil : text
    Coradoc::CoreModel::InlineElement.new(
      format_type: 'xref',
      target: ref_id,
      content: content
    )
  else
    # External links become regular links
    Coradoc::CoreModel::InlineElement.new(
      format_type: 'link',
      target: href,
      content: text
    )
  end
end

.to_html(model, _state = {}) ⇒ String

Convert CoreModel::InlineElement (xref) to HTML

Parameters:

  • model (Coradoc::CoreModel::InlineElement) —

    CrossReference model

  • state (Hash) —

    Conversion state

Returns:

  • (String) —

    HTML anchor tag



13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
 
# File 'lib/coradoc/html/converters/cross_reference.rb', line 13

def to_html(model, _state = {})
  href = model.target.to_s
  # Create anchor link to internal reference
  # Format: <a href="#section-id">section-id</a> or with text from content
  text = if model.content&.to_s&.strip != ''
           model.content.to_s
         else
           href
         end

  # Ensure href starts with # for internal links
  link_href = href.start_with?('#') ? href : "##{href}"

  %(<a href="#{escape_attribute(link_href)}">#{escape_html(text)}</a>)
end