Class: Coradoc::Html::Converters::Sidebar

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

Overview

Converter for CoreModel::Block (sidebar) to HTML <aside>

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(sidebar) ⇒ Object 



56
57
58
59
60
61
62
63
 
# File 'lib/coradoc/html/converters/sidebar.rb', line 56

def self.build_attributes(sidebar)
  attrs = [%( class="sidebar")]

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

  attrs.join
end

.build_title(sidebar) ⇒ Object 



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

def self.build_title(sidebar)
  return nil unless sidebar.title

  title_text = sidebar.title.to_s
  return nil if title_text.empty?

  %(<div class="sidebar-title">#{escape_html(title_text)}</div>)
end

.convert_item(item) ⇒ Object 



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

def self.convert_item(item)
  case item
  when String
    "<p>#{escape_html(item)}</p>"
  else
    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/sidebar.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 



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

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 <aside> to CoreModel::Block (sidebar)



30
31
32
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/sidebar.rb', line 30

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

  # Extract title if present
  title_elem = element.at_css('.sidebar-title, h1, h2, h3, h4, h5, h6')
  title = title_elem&.text&.strip

  # Extract content - all children except title
  content_nodes = if title_elem
                    element.children.reject { |node| node == title_elem }
                  else
                    element.children
                  end

  content = extract_content(content_nodes)

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

  Coradoc::CoreModel::SidebarBlock.new(
    content: content,
    title: title,
    id: id
  )
end

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

Convert CoreModel::Block (sidebar) to HTML <aside>



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

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

  # Build aside attributes
  attrs = build_attributes(sidebar)

  # Build title if present
  title_html = build_title(sidebar)

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

  # Combine title and content
  sidebar_html = ''
  sidebar_html += "#{title_html}\n" if title_html
  sidebar_html += content

  %(<aside#{attrs}>\n#{sidebar_html}\n</aside>)
end