Class: Coradoc::Html::Converters::Term

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

Overview

Converter for CoreModel::InlineElement (term) elements

Terms are used in definition lists and can have types like “acronym”, “symbol”, “preferred”, etc.

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 = {}) ⇒ Object

Convert HTML to CoreModel::InlineElement (term)



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

def self.to_coradoc(node, _state = {})
  attrs = extract_node_attributes(node)

  term_text = node.text.strip
  term_type = attrs[:'data-term-type'] || attrs[:class]&.split&.find do |c|
    c.start_with?('term-')
  end&.sub('term-', '')

  Coradoc::CoreModel::InlineElement.new(
    format_type: 'term',
    content: term_text,
    target: term_type || 'term',
    metadata: {
      lang: attrs[:lang] || 'en',
      render_text: attrs[:'data-render-text']
    }
  )
end

.to_html(term, _state = {}) ⇒ Object

Convert CoreModel::InlineElement (term) to HTML



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/term.rb', line 33

def self.to_html(term, _state = {})
  term_text = term.content || ''
  term_type = term.target || 'term'
  render_text = term.metadata&.dig(:render_text)

  # Use render_text if available, otherwise use term
  display_text = render_text&.strip&.empty? ? false : render_text
  display_text ||= term_text

  # Build class attribute
  classes = ['term', "term-#{escape_attribute(term_type)}"]
  class_attr = classes.join(' ')

  # Build data attributes
  data_attrs = []
  data_attrs << %( data-term-ref="#{escape_attribute(term_text)}")
  lang = term.metadata&.dig(:lang)
  data_attrs << %( lang="#{escape_attribute(lang)}") if lang && lang != 'en'

  # Render as a styled span with term reference
  %(<span class="#{class_attr}"#{data_attrs.join}>#{escape_html(display_text)}</span>)
end