Class: Coradoc::Html::Converters::Quote

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

Overview

Converter for CoreModel::Block (quote) to HTML <blockquote>

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

.build_attributes(quote) ⇒ Object 



53
54
55
56
57
58
59
60
 
# File 'lib/coradoc/html/converters/quote.rb', line 53

def self.build_attributes(quote)
  attrs = []

  # Add ID if present
  attrs << %( id="#{escape_attribute(quote.id)}") if quote.id

  attrs.join
end

.build_attribution(quote) ⇒ Object 



84
85
86
87
88
89
90
91
92
93
 
# File 'lib/coradoc/html/converters/quote.rb', line 84

def self.build_attribution(quote)
  # Check metadata for attribution
  attribution_text = quote.metadata&.dig(:attribution)
  return nil unless attribution_text

  attribution_text = attribution_text.to_s.strip
  return nil if attribution_text.empty?

  %(<footer>#{escape_html(attribution_text)}</footer>)
end

.convert_item(item) ⇒ Object 



74
75
76
77
78
79
80
81
82
 
# File 'lib/coradoc/html/converters/quote.rb', line 74

def self.convert_item(item)
  case item
  when String
    "<p>#{escape_html(item)}</p>"
  else
    # Use centralized content conversion
    convert_content_to_html(item)
  end
end

.extract_content(nodes) ⇒ Object 



95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
 
# File 'lib/coradoc/html/converters/quote.rb', line 95

def self.extract_content(nodes)
  # Extract and convert content nodes
  nodes.map do |node|
    if node.text? && !node.text.strip.empty?
      node.text.strip
    elsif node.element?
      case node.name
      when 'p'
        Paragraph.to_coradoc(node)
      else
        node.text.strip
      end
    end
  end.compact
end

.process_content(content) ⇒ Object 



62
63
64
65
66
67
68
69
70
71
72
 
# File 'lib/coradoc/html/converters/quote.rb', line 62

def self.process_content(content)
  return '' if content.nil?

  if content.is_a?(Array)
    content.map { |item| convert_item(item) }.join("\n")
  elsif content.is_a?(String)
    "<p>#{escape_html(content)}</p>"
  else
    convert_item(content)
  end
end

.to_coradoc(element, _options = {}) ⇒ Object

Convert HTML <blockquote> to CoreModel::Block (quote)



29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
 
# File 'lib/coradoc/html/converters/quote.rb', line 29

def self.to_coradoc(element, _options = {})
  return nil unless element.name == 'blockquote'

  # Extract content - all children except cite/footer
  content_nodes = element.children.reject do |node|
    %w[cite footer].include?(node.name)
  end

  content = extract_content(content_nodes)

  # Extract attribution from <cite> or <footer>
  cite_elem = element.at_css('cite, footer')
  attribution = cite_elem&.text&.strip

  # Extract ID if present
  id = element['id']

  Coradoc::CoreModel::QuoteBlock.new(
    content: content,
    id: id,
    attribution: attribution
  )
end

.to_html(quote, _options = {}) ⇒ Object

Convert CoreModel::Block (quote) to HTML <blockquote>



9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
 
# File 'lib/coradoc/html/converters/quote.rb', line 9

def self.to_html(quote, _options = {})
  return '' unless quote

  # Build blockquote attributes
  attrs = build_attributes(quote)

  # Process quote content
  content = process_content(quote.content)

  # Build attribution if present
  attribution = build_attribution(quote)

  # Combine content and attribution
  quote_html = content
  quote_html += "\n#{attribution}" if attribution

  "<blockquote#{attrs}>\n#{quote_html}\n</blockquote>"
end