Class: Coradoc::Html::ConverterBase Abstract

Inherits:
Object
  • Object
show all
Defined in:
lib/coradoc/html/converter_base.rb

Overview

This class is abstract.

Subclass and implement #convert to create a custom converter

Abstract base class for HTML output converters

This class defines the interface that all HTML output converters must implement. It provides common functionality for document validation, configuration building, and HTML output generation.

Examples:

Creating a custom converter

class MyConverter < Coradoc::Html::ConverterBase
  def convert
    # Generate HTML from document
  end
end

Direct Known Subclasses

Spa, Static

Defined Under Namespace

Classes: ConfigurationBase, UnsupportedDocumentError, ValidationError

Instance Attribute Summary collapse

Class Method Summary collapse

Instance Method Summary collapse

Constructor Details

#initialize(document, config = {}) ⇒ ConverterBase

Initialize a new converter instance

Parameters:

  • document (Coradoc::CoreModel::StructuralElement) —

    The document to convert

  • config (Hash, Configuration) (defaults to: {}) —

    Converter configuration

Raises:



48
49
50
51
 
# File 'lib/coradoc/html/converter_base.rb', line 48

def initialize(document, config = {})
  @document = validate_input(document)
  @config = build_config(config)
end

Instance Attribute Details

#config ⇒ Object (readonly)

Returns the value of attribute config.



41
42
43
 
# File 'lib/coradoc/html/converter_base.rb', line 41

def config
  @config
end

#document ⇒ Object (readonly)

Returns the value of attribute document.



41
42
43
 
# File 'lib/coradoc/html/converter_base.rb', line 41

def document
  @document
end

Class Method Details

.convert(document, config = {}) ⇒ String

Class method to convert a document

Parameters:

  • document (Coradoc::CoreModel::StructuralElement) —

    The document to convert

  • config (Hash) (defaults to: {}) —

    Converter configuration

Returns:

  • (String) —

    HTML output



84
85
86
 
# File 'lib/coradoc/html/converter_base.rb', line 84

def self.convert(document, config = {})
  new(document, config).convert
end

.to_file(document, output_path, config = {}) ⇒ String

Class method to convert and write to file

Parameters:

  • document (Coradoc::CoreModel::StructuralElement) —

    The document to convert

  • output_path (String) —

    Path to write the output file

  • config (Hash) (defaults to: {}) —

    Converter configuration

Returns:

  • (String) —

    The output path



94
95
96
 
# File 'lib/coradoc/html/converter_base.rb', line 94

def self.to_file(document, output_path, config = {})
  new(document, config).to_file(output_path)
end

Instance Method Details

#convert ⇒ String

This method is abstract.

Subclasses must implement this method

Convert the document to HTML

Returns:

  • (String) —

    HTML output

Raises:

  • (NotImplementedError) —

    if not implemented by subclass



58
59
60
61
 
# File 'lib/coradoc/html/converter_base.rb', line 58

def convert
  raise NotImplementedError,
        "#{self.class.name} must implement #convert method"
end

#to_file(output_path) ⇒ String

Convert and write to file

Parameters:

  • output_path (String) —

    Path to write the output file

Returns:

  • (String) —

    The output path



67
68
69
70
71
72
73
74
75
76
77
 
# File 'lib/coradoc/html/converter_base.rb', line 67

def to_file(output_path)
  html = convert

  # Ensure parent directory exists
  output_dir = File.dirname(output_path)
  FileUtils.mkdir_p(output_dir) unless output_dir == '.'

  File.write(output_path, html)

  output_path
end