prawn-html 0.1.0

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA256:
+  metadata.gz: a5a671ae12f6a66358c10f739404ab709f3fdcaacb059b9943433a7535a539a5
+  data.tar.gz: 274afa7a2d6cbb2a75e1ca03e2b82ee38985bf279f41ecd3878166ce9eabf15a
+SHA512:
+  metadata.gz: a67e743e2c77c1b0e9caecefd9b6f1fc2d33243d0b86b37548f5bbed7e8e569ea11562d849c82fbdfd8ca7eeb5bdf2921cf789464868f0e90de4b631dcf89a10
+  data.tar.gz: dd06b9b0410cceb28eaf68ab6eaeb6007086047478f3ec1ba2ffd37a0a38de38264f56fae3232b4025a5d6f45b776fe2d79bb23eb76926a8a87139e82294e14d

data/LICENSE.txt

@@ -0,0 +1,20 @@
+Copyright (c) 2021 Mattia Roccoberton
+
+Permission is hereby granted, free of charge, to any person obtaining
+a copy of this software and associated documentation files (the
+"Software"), to deal in the Software without restriction, including
+without limitation the rights to use, copy, modify, merge, publish,
+distribute, sublicense, and/or sell copies of the Software, and to
+permit persons to whom the Software is furnished to do so, subject to
+the following conditions:
+
+The above copyright notice and this permission notice shall be
+included in all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
+EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
+MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
+NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE
+LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION
+OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION
+WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.

data/README.md

@@ -0,0 +1,84 @@
+# Prawn HTML
+[![linters](https://github.com/blocknotes/prawn-html/actions/workflows/linters.yml/badge.svg)](https://github.com/blocknotes/prawn-html/actions/workflows/linters.yml)
+[![specs](https://github.com/blocknotes/prawn-html/actions/workflows/specs.yml/badge.svg)](https://github.com/blocknotes/prawn-html/actions/workflows/specs.yml)
+
+HTML to PDF renderer using [Prawn PDF](https://github.com/prawnpdf/prawn).
+
+> Still in beta. [prawn-styled-text](https://github.com/blocknotes/prawn-styled-text) rewritten from scratch
+
+**Notice**: render HTML documents properly is not an easy task, this gem support only some HTML tags and a small set of CSS attributes. If you need more rendering accuracy take a look at other projects like WickedPDF.
+
+Please :star: if you like it.
+
+## Install
+
+- Add to your Gemfile: `gem 'prawn-html', git: 'https://github.com/blocknotes/prawn-html.git'` (and execute `bundle`)
+- Use the class `HtmlHandler` on a `Prawn::Document` instance
+
+## Examples
+
+```rb
+require 'prawn-html'
+pdf = Prawn::Document.new(page_size: 'A4')
+PrawnHtml::HtmlHandler.new(pdf).process('<h1 style="text-align: center">Just a test</h1>')
+pdf.render_file('test.pdf')
+```
+
+## Supported tags & attributes
+
+HTML tags:
+
+- **a**: link
+- **b**: bold
+- **br**: new line
+- **del**: strike-through
+- **div**: block element
+- **em**: italic
+- **h1** - **h6**: headings
+- **hr**: horizontal line
+- **i**: italic
+- **ins**: underline
+- **img**: image
+- **li**: list item
+- **mark**: highlight
+- **p**: block element
+- **s**: strike-through
+- **small**: smaller text
+- **span**: inline element
+- **strong**: bold
+- **u**: underline
+- **ul**: list
+
+CSS attributes (dimensional units are ignored and considered in pixel):
+
+- **background**: for *mark* tag, only 3 or 6 hex digits format, ex. `style="background: #FECD08"`
+- **color**: only 3 or 6 hex digits format - ex. `style="color: #FB1"`
+- **font-family**: font must be registered, quotes are optional, ex. `style="font-family: Courier"`
+- **font-size**: ex. `style="font-size: 20px"`
+- **font-style**: values: *:italic*, ex. `style="font-style: italic"`
+- **font-weight**: values: *:bold*, ex. `style="font-weight: bold"`
+- **height**: for *img* tag, ex. `<img src="image.jpg" style="height: 200px"/>`
+- **href**: for *a* tag, ex. `<a href="http://www.google.com/">Google</a>`
+- **letter-spacing**: ex. `style="letter-spacing: 1.5"`
+- **line-height**: ex. `style="line-height: 10px"`
+- **margin-bottom**: ex. `style="margin-bottom: 10px"`
+- **margin-left**: ex. `style="margin-left: 15px"`
+- **margin-top**: ex. `style="margin-top: 20px"`
+- **src**: for *img* tag, ex. `<img src="image.jpg"/>`
+- **text-align**: `left` | `center` | `right` | `justify`, ex. `style="text-align: center"`
+- **text-decoration**: `underline`, ex. `style="text-decoration: underline"`
+- **width**: for *img* tag, support also percentage, ex. `<img src="image.jpg" style="width: 50%; height: 200px"/>`
+
+## Do you like it? Star it!
+
+If you use this component just star it. A developer is more motivated to improve a project when there is some interest.
+
+Or consider offering me a coffee, it's a small thing but it is greatly appreciated: [about me](https://www.blocknot.es/about-me).
+
+## Contributors
+
+- [Mattia Roccoberton](https://www.blocknot.es): author
+
+## License
+
+The gem is available as open-source under the terms of the [MIT](LICENSE.txt).

data/lib/prawn-html.rb

@@ -0,0 +1,17 @@
+# frozen_string_literal: true
+
+require 'prawn'
+
+require 'prawn_html/tags/base'
+Dir["#{__dir__}/prawn_html/tags/*.rb"].sort.each { |f| require f }
+
+Dir["#{__dir__}/prawn_html/callbacks/*.rb"].sort.each { |f| require f }
+
+require 'prawn_html/attributes'
+require 'prawn_html/context'
+require 'prawn_html/document_renderer'
+require 'prawn_html/html_handler'
+
+module PrawnHtml
+  PX = 0.66 # conversion costant for pixel sixes
+end

data/lib/prawn_html/attributes.rb

@@ -0,0 +1,157 @@
+# frozen_string_literal: true
+
+require 'ostruct'
+
+module PrawnHtml
+  class Attributes
+    attr_reader :hash, :options, :post_styles, :pre_styles, :styles
+
+    STYLES_LIST = {
+      # styles
+      'background' => { key: :background, set: :convert_color, dest: :styles },
+      'color' => { key: :color, set: :convert_color, dest: :styles },
+      'font-family' => { key: :font, set: :unquote, dest: :styles },
+      'font-size' => { key: :size, set: :convert_size, dest: :styles },
+      'font-style' => { key: :styles, set: :append_symbol, dest: :styles },
+      'font-weight' => { key: :styles, set: :append_symbol, dest: :styles },
+      'letter-spacing' => { key: :character_spacing, set: :convert_float, dest: :styles },
+      # pre styles
+      'margin-top' => { key: :margin_top, set: :convert_size, dest: :pre_styles },
+      # post styles
+      'margin-bottom' => { key: :margin_bottom, set: :convert_size, dest: :post_styles },
+      'padding-bottom' => { key: :padding_bottom, set: :convert_size, dest: :post_styles },
+      # options
+      'line-height' => { key: :leading, set: :convert_size, dest: :options },
+      'margin-left' => { key: :margin_left, set: :convert_size, dest: :options },
+      'padding-left' => { key: :padding_left, set: :convert_size, dest: :options },
+      'padding-top' => { key: :padding_top, set: :convert_size, dest: :options },
+      'text-align' => { key: :align, set: :convert_symbol, dest: :options },
+      'text-decoration' => { key: :styles, set: :append_symbol, dest: :styles }
+    }.freeze
+
+    STYLES_MERGE = %i[margin_left padding_left].freeze
+
+    # Init the Attributes
+    #
+    # @param attributes [Hash] hash of attributes to parse
+    def initialize(attributes)
+      @hash = ::OpenStruct.new(attributes)
+      @options = {}
+      @post_styles = {}
+      @pre_styles = {}
+      @styles = {} # result styles
+      parsed_styles = Attributes.parse_styles(hash.style)
+      process_styles(parsed_styles)
+    end
+
+    # Processes the styles attributes
+    #
+    # @param attributes [Hash] hash of styles attributes
+    def process_styles(styles)
+      styles.each do |key, value|
+        rule = STYLES_LIST[key]
+        next unless rule
+
+        apply_rule(rule, value)
+      end
+    end
+
+    class << self
+      # Converts a color string
+      #
+      # @param value [String] HTML string color
+      #
+      # @return [String] adjusted string color
+      def convert_color(value)
+        val = value&.downcase || +''
+        val.gsub!(/[^a-f0-9]/, '')
+        return val unless val.size == 3
+
+        a, b, c = val.chars
+        a * 2 + b * 2 + c * 2
+      end
+
+      # Converts a decimal number string
+      #
+      # @param value [String] string decimal
+      #
+      # @return [Float] converted and rounded float number
+      def convert_float(value)
+        val = value&.gsub(/[^0-9.]/, '') || ''
+        val.to_f.round(4)
+      end
+
+      # Converts a size string
+      #
+      # @param value [String] size string
+      # @param container_size [Numeric] container size
+      #
+      # @return [Float] converted and rounded size
+      def convert_size(value, container_size = nil)
+        val = value&.gsub(/[^0-9.]/, '') || ''
+        val =
+          if container_size && value.include?('%')
+            val.to_f * container_size * 0.01
+          else
+            val.to_f * PX
+          end
+        # pdf.bounds.height
+        val.round(4)
+      end
+
+      # Converts a string to symbol
+      #
+      # @param value [String] string
+      #
+      # @return [Symbol] symbol
+      def convert_symbol(value)
+        value.to_sym if value && !value.match?(/\A\s*\Z/)
+      end
+
+      # Merges attributes
+      #
+      # @param hash [Hash] target attributes hash
+      # @param key [Symbol] key
+      # @param value
+      #
+      # @return [Hash] the updated hash of attributes
+      def merge_attr!(hash, key, value)
+        return unless key
+        return (hash[key] = value) unless Attributes::STYLES_MERGE.include?(key)
+
+        hash[key] ||= 0
+        hash[key] += value
+      end
+
+      # Parses a string of styles
+      #
+      # @param styles [String] styles to parse
+      #
+      # @return [Hash] hash of styles
+      def parse_styles(styles)
+        (styles || '').scan(/\s*([^:;]+)\s*:\s*([^;]+)\s*/).to_h
+      end
+
+      # Unquotes a string
+      #
+      # @param value [String] string
+      #
+      # @return [String] string without quotes at the beginning/ending
+      def unquote(value)
+        (value&.strip || +'').tap do |val|
+          val.gsub!(/\A['"]|["']\Z/, '')
+        end
+      end
+    end
+
+    private
+
+    def apply_rule(rule, value)
+      if rule[:set] == :append_symbol
+        (send(rule[:dest])[rule[:key]] ||= []) << Attributes.convert_symbol(value)
+      else
+        send(rule[:dest])[rule[:key]] = Attributes.send(rule[:set], value)
+      end
+    end
+  end
+end

data/lib/prawn_html/callbacks/highlight.rb

@@ -0,0 +1,21 @@
+# frozen_string_literal: true
+
+module PrawnHtml
+  module Callbacks
+    class Highlight
+      DEF_HIGHLIGHT = 'ffff00'
+
+      def initialize(pdf, item)
+        @pdf = pdf
+        @color = item.delete(:background) || DEF_HIGHLIGHT
+      end
+
+      def render_behind(fragment)
+        original_color = @pdf.fill_color
+        @pdf.fill_color = @color
+        @pdf.fill_rectangle(fragment.top_left, fragment.width, fragment.height)
+        @pdf.fill_color = original_color
+      end
+    end
+  end
+end

data/lib/prawn_html/callbacks/strike_through.rb

@@ -0,0 +1,18 @@
+# frozen_string_literal: true
+
+module PrawnHtml
+  module Callbacks
+    class StrikeThrough
+      def initialize(pdf, _item)
+        @pdf = pdf
+      end
+
+      def render_in_front(fragment)
+        y = (fragment.top_left[1] + fragment.bottom_left[1]) / 2
+        @pdf.stroke do
+          @pdf.line [fragment.top_left[0], y], [fragment.top_right[0], y]
+        end
+      end
+    end
+  end
+end

data/lib/prawn_html/context.rb

@@ -0,0 +1,61 @@
+# frozen_string_literal: true
+
+module PrawnHtml
+  class Context < Array
+    DEF_FONT_SIZE = 10.3
+
+    attr_accessor :last_margin, :last_text_node
+
+    # Init the Context
+    def initialize(*_args)
+      super
+      @last_margin = 0
+    end
+
+    def before_content
+      return '' if empty?
+
+      last.options[:before_content].to_s
+    end
+
+    # Merges the context options
+    #
+    # @return [Hash] the hash of merged options
+    def merge_options
+      each_with_object({}) do |element, res|
+        element.options.each do |key, value|
+          Attributes.merge_attr!(res, key, value)
+        end
+      end
+    end
+
+    # Merge the context styles
+    #
+    # @return [Hash] the hash of merged styles
+    def merge_styles
+      context_styles = each_with_object({}) do |element, res|
+        evaluate_element_styles(element, res)
+        element.update_styles(res) if element.respond_to?(:update_styles)
+      end
+      base_styles.merge(context_styles)
+    end
+
+    private
+
+    def base_styles
+      {
+        size: DEF_FONT_SIZE
+      }
+    end
+
+    def evaluate_element_styles(element, res)
+      element.styles.each do |key, val|
+        if res.include?(key) && res[key].is_a?(Array)
+          res[key] += val
+        else
+          res[key] = val
+        end
+      end
+    end
+  end
+end

data/lib/prawn_html/document_renderer.rb

@@ -0,0 +1,134 @@
+# frozen_string_literal: true
+
+module PrawnHtml
+  class DocumentRenderer
+    NEW_LINE = { text: "\n" }.freeze
+    SPACE = { text: ' ' }.freeze
+    TAG_CLASSES = [Tags::A, Tags::B, Tags::Body, Tags::Br, Tags::Del, Tags::Div, Tags::H, Tags::Hr, Tags::I, Tags::Img, Tags::Li, Tags::Mark, Tags::P, Tags::Small, Tags::Span, Tags::U, Tags::Ul].freeze
+
+    # Init the DocumentRenderer
+    #
+    # @param pdf [Prawn::Document] target Prawn PDF document
+    def initialize(pdf)
+      @buffer = []
+      @context = Context.new
+      @doc_styles = {}
+      @pdf = pdf
+    end
+
+    # Assigns the document styles
+    #
+    # @param styles [Hash] styles hash with CSS selectors as keys and rules as values
+    def assign_document_styles(styles)
+      @doc_styles = styles.transform_values do |style_rules|
+        Attributes.new(style: style_rules).styles
+      end
+    end
+
+    # On tag close callback
+    #
+    # @param element [Tags::Base] closing element wrapper
+    def on_tag_close(element)
+      render_if_needed(element)
+      apply_post_styles(element&.post_styles)
+      context.last_text_node = false
+      context.pop
+    end
+
+    # On tag open callback
+    #
+    # @param tag [String] the tag name of the opening element
+    # @param attributes [Hash] an hash of the element attributes
+    #
+    # @return [Tags::Base] the opening element wrapper
+    def on_tag_open(tag, attributes)
+      tag_class = tag_classes[tag]
+      return unless tag_class
+
+      tag_class.new(tag, attributes).tap do |element|
+        setup_element(element)
+      end
+    end
+
+    # On text node callback
+    #
+    # @param content [String] the text node content
+    #
+    # @return [NilClass] nil value (=> no element)
+    def on_text_node(content)
+      return if content.match?(/\A\s*\Z/)
+
+      text = content.gsub(/\A\s*\n\s*|\s*\n\s*\Z/, '').delete("\n").squeeze(' ')
+      buffer << context.merge_styles.merge(text: ::Oga::HTML::Entities.decode(context.before_content) + text)
+      context.last_text_node = true
+      nil
+    end
+
+    # Render the buffer content to the PDF document
+    def render
+      return if buffer.empty?
+
+      options = context.merge_options.slice(:align, :leading, :margin_left, :padding_left)
+      output_content(buffer.dup, options)
+      buffer.clear
+      context.last_margin = 0
+    end
+
+    alias_method :flush, :render
+
+    private
+
+    attr_reader :buffer, :context, :doc_styles, :pdf
+
+    def tag_classes
+      @tag_classes ||= TAG_CLASSES.each_with_object({}) do |klass, res|
+        res.merge!(klass.elements)
+      end
+    end
+
+    def setup_element(element)
+      add_space_if_needed unless render_if_needed(element)
+      apply_pre_styles(element)
+      element.apply_doc_styles(doc_styles)
+      context.push(element)
+      element.custom_render(pdf, context) if element.respond_to?(:custom_render)
+    end
+
+    def add_space_if_needed
+      buffer << SPACE if buffer.any? && !context.last_text_node && ![NEW_LINE, SPACE].include?(buffer.last)
+    end
+
+    def render_if_needed(element)
+      render_needed = element&.block? && buffer.any? && buffer.last != NEW_LINE
+      return false unless render_needed
+
+      render
+      true
+    end
+
+    def apply_post_styles(styles)
+      context.last_margin = styles[:margin_bottom].to_f
+      return if !styles || styles.empty?
+
+      pdf.move_down(context.last_margin.round(4)) if context.last_margin > 0
+      pdf.move_down(styles[:padding_bottom].round(4)) if styles[:padding_bottom].to_f > 0
+    end
+
+    def apply_pre_styles(element)
+      pdf.move_down(element.options[:padding_top].round(4)) if element.options.include?(:padding_top)
+      return if !element.pre_styles || element.pre_styles.empty?
+
+      margin = (element.pre_styles[:margin_top] - context.last_margin).round(4)
+      pdf.move_down(margin) if margin > 0
+    end
+
+    def output_content(buffer, options)
+      buffer.each { |item| item[:callback] = item[:callback].new(pdf, item) if item[:callback] }
+      if (left = options.delete(:margin_left).to_f + options.delete(:padding_left).to_f) > 0
+        pdf.indent(left) { pdf.formatted_text(buffer, options) }
+      else
+        pdf.formatted_text(buffer, options)
+      end
+    end
+  end
+end

data/lib/prawn_html/html_handler.rb

@@ -0,0 +1,68 @@
+# frozen_string_literal: true
+
+require 'oga'
+
+module PrawnHtml
+  class HtmlHandler
+    # Init the HtmlHandler
+    #
+    # @param pdf [Prawn::Document] Target Prawn PDF document
+    def initialize(pdf)
+      @processing = false
+      @renderer = DocumentRenderer.new(pdf)
+    end
+
+    # Processes HTML and renders it on the PDF document
+    #
+    # @param html [String] The HTML content to process
+    def process(html)
+      @processing = !html.include?('<body')
+      doc = Oga.parse_html(html)
+      traverse_nodes(doc.children)
+      renderer.flush
+    end
+
+    private
+
+    attr_reader :processing, :renderer
+
+    def traverse_nodes(nodes)
+      nodes.each do |node|
+        element = node_open(node)
+        traverse_nodes(node.children) if node.children.any?
+        node_close(element) if element
+      end
+    end
+
+    def node_open(node)
+      tag = node.is_a?(Oga::XML::Element) && init_element(node)
+      return unless processing
+      return renderer.on_text_node(node.text) unless tag
+
+      attributes = prepare_attributes(node)
+      renderer.on_tag_open(tag, attributes)
+    end
+
+    def init_element(node)
+      node.name.downcase.to_sym.tap do |tag_name|
+        @processing = true if tag_name == :body
+        renderer.assign_document_styles(extract_styles(node.text)) if tag_name == :style && !@processing
+      end
+    end
+
+    def extract_styles(text)
+      text.scan(/\s*([^{\s]+)\s*{\s*([^}]*?)\s*}/m).to_h
+    end
+
+    def prepare_attributes(node)
+      node.attributes.each_with_object({}) do |attr, res|
+        res[attr.name] = attr.value
+      end
+    end
+
+    def node_close(element)
+      renderer.on_tag_close(element) if @processing
+      @processing = false if element.tag == :body
+    end
+  end
+end

data/lib/prawn_html/tags/a.rb

@@ -0,0 +1,17 @@
+# frozen_string_literal: true
+
+require_relative 'base'
+
+module PrawnHtml
+  module Tags
+    class A < Base
+      ELEMENTS = [:a].freeze
+
+      def styles
+        super.merge(
+          link: attrs.hash.href
+        )
+      end
+    end
+  end
+end

data/lib/prawn_html/tags/b.rb

@@ -0,0 +1,17 @@
+# frozen_string_literal: true
+
+require_relative 'base'
+
+module PrawnHtml
+  module Tags
+    class B < Base
+      ELEMENTS = [:b, :strong].freeze
+
+      def extra_attrs
+        {
+          'font-weight' => 'bold'
+        }
+      end
+    end
+  end
+end

data/lib/prawn_html/tags/base.rb

@@ -0,0 +1,54 @@
+# frozen_string_literal: true
+
+module PrawnHtml
+  module Tags
+    class Base
+      attr_reader :attrs, :styles, :tag
+
+      def initialize(tag, attributes = {})
+        @attrs = Attributes.new(attributes)
+        @styles = attrs.styles
+        @tag = tag
+        attrs.process_styles(extra_attrs) unless extra_attrs.empty?
+      end
+
+      def apply_doc_styles(document_styles)
+        selectors = [
+          tag.to_s,
+          attrs.hash['class'] ? ".#{attrs.hash['class']}" : nil,
+          attrs.hash['id'] ? "##{attrs.hash['id']}" : nil
+        ].compact!
+        merged_styles = document_styles.each_with_object({}) do |(sel, attributes), res|
+          res.merge!(attributes) if selectors.include?(sel)
+        end
+        styles.merge!(merged_styles)
+      end
+
+      def block?
+        false
+      end
+
+      def extra_attrs
+        {}
+      end
+
+      def options
+        attrs.options
+      end
+
+      def post_styles
+        attrs.post_styles
+      end
+
+      def pre_styles
+        attrs.pre_styles
+      end
+
+      class << self
+        def elements
+          self::ELEMENTS.each_with_object({}) { |el, list| list[el] = self }
+        end
+      end
+    end
+  end
+end

data/lib/prawn_html/tags/body.rb

@@ -0,0 +1,11 @@
+# frozen_string_literal: true
+
+require_relative 'base'
+
+module PrawnHtml
+  module Tags
+    class Body < Base
+      ELEMENTS = [:body].freeze
+    end
+  end
+end

data/lib/prawn_html/tags/br.rb

@@ -0,0 +1,24 @@
+# frozen_string_literal: true
+
+require_relative 'base'
+
+module PrawnHtml
+  module Tags
+    class Br < Base
+      ELEMENTS = [:br].freeze
+
+      BR_SPACING = 12
+
+      def block?
+        true
+      end
+
+      def custom_render(pdf, context)
+        return if context.last_text_node
+
+        @spacing ||= Attributes.convert_size(BR_SPACING.to_s)
+        pdf.move_down(@spacing)
+      end
+    end
+  end
+end

data/lib/prawn_html/tags/del.rb

@@ -0,0 +1,17 @@
+# frozen_string_literal: true
+
+require_relative 'base'
+
+module PrawnHtml
+  module Tags
+    class Del < Base
+      ELEMENTS = [:del, :s].freeze
+
+      def styles
+        super.merge(
+          callback: Callbacks::StrikeThrough
+        )
+      end
+    end
+  end
+end

data/lib/prawn_html/tags/div.rb

@@ -0,0 +1,15 @@
+# frozen_string_literal: true
+
+require_relative 'base'
+
+module PrawnHtml
+  module Tags
+    class Div < Base
+      ELEMENTS = [:div].freeze
+
+      def block?
+        true
+      end
+    end
+  end
+end

data/lib/prawn_html/tags/h.rb

@@ -0,0 +1,51 @@
+# frozen_string_literal: true
+
+require_relative 'base'
+
+module PrawnHtml
+  module Tags
+    class H < Base
+      ELEMENTS = [:h1, :h2, :h3, :h4, :h5, :h6].freeze
+
+      MARGINS_TOP = {
+        h1: 25.5,
+        h2: 20.5,
+        h3: 19,
+        h4: 20,
+        h5: 21.2,
+        h6: 23.5
+      }.freeze
+
+      MARGINS_BOTTOM = {
+        h1: 18.2,
+        h2: 17.5,
+        h3: 17.5,
+        h4: 22,
+        h5: 22,
+        h6: 26.5
+      }.freeze
+
+      SIZES = {
+        h1: 31,
+        h2: 23.5,
+        h3: 18.2,
+        h4: 16,
+        h5: 13,
+        h6: 10.5
+      }.freeze
+
+      def block?
+        true
+      end
+
+      def extra_attrs
+        @extra_attrs ||= {
+          'font-size' => SIZES[tag].to_s,
+          'font-weight' => 'bold',
+          'margin-bottom' => MARGINS_BOTTOM[tag].to_s,
+          'margin-top' => MARGINS_TOP[tag].to_s
+        }
+      end
+    end
+  end
+end

data/lib/prawn_html/tags/hr.rb

@@ -0,0 +1,29 @@
+# frozen_string_literal: true
+
+require_relative 'base'
+
+module PrawnHtml
+  module Tags
+    class Hr < Base
+      ELEMENTS = [:hr].freeze
+
+      MARGIN_BOTTOM = 12
+      MARGIN_TOP = 6
+
+      def block?
+        true
+      end
+
+      def custom_render(pdf, _context)
+        pdf.stroke_horizontal_rule
+      end
+
+      def extra_attrs
+        @extra_attrs ||= {
+          'margin-bottom' => MARGIN_BOTTOM.to_s,
+          'margin-top' => MARGIN_TOP.to_s,
+        }
+      end
+    end
+  end
+end

data/lib/prawn_html/tags/i.rb

@@ -0,0 +1,17 @@
+# frozen_string_literal: true
+
+require_relative 'base'
+
+module PrawnHtml
+  module Tags
+    class I < Base
+      ELEMENTS = [:i, :em].freeze
+
+      def extra_attrs
+        {
+          'font-style' => 'italic'
+        }
+      end
+    end
+  end
+end

data/lib/prawn_html/tags/img.rb

@@ -0,0 +1,32 @@
+# frozen_string_literal: true
+
+require_relative 'base'
+
+module PrawnHtml
+  module Tags
+    class Img < Base
+      ELEMENTS = [:img].freeze
+
+      def block?
+        true
+      end
+
+      def custom_render(pdf, context)
+        styles = Attributes.parse_styles(attrs.hash.style)
+        context_options = context.merge_options
+        options = evaluate_styles(pdf, context_options.merge(styles))
+        pdf.image(@attrs.hash.src, options)
+      end
+
+      private
+
+      def evaluate_styles(pdf, styles)
+        options = {}
+        options[:width] = Attributes.convert_size(styles['width'], pdf.bounds.width) if styles.include?('width')
+        options[:height] = Attributes.convert_size(styles['height'], pdf.bounds.height) if styles.include?('height')
+        options[:position] = styles[:align] if %i[left center right].include?(styles[:align])
+        options
+      end
+    end
+  end
+end

data/lib/prawn_html/tags/li.rb

@@ -0,0 +1,21 @@
+# frozen_string_literal: true
+
+require_relative 'base'
+
+module PrawnHtml
+  module Tags
+    class Li < Base
+      ELEMENTS = [:li].freeze
+
+      def block?
+        true
+      end
+
+      def options
+        super.merge(
+          before_content: '&bullet;  '
+        )
+      end
+    end
+  end
+end

data/lib/prawn_html/tags/mark.rb

@@ -0,0 +1,17 @@
+# frozen_string_literal: true
+
+require_relative 'base'
+
+module PrawnHtml
+  module Tags
+    class Mark < Base
+      ELEMENTS = [:mark].freeze
+
+      def styles
+        super.merge(
+          callback: Callbacks::Highlight
+        )
+      end
+    end
+  end
+end

data/lib/prawn_html/tags/p.rb

@@ -0,0 +1,25 @@
+# frozen_string_literal: true
+
+require_relative 'base'
+
+module PrawnHtml
+  module Tags
+    class P < Base
+      ELEMENTS = [:p].freeze
+
+      MARGIN_BOTTOM = 6
+      MARGIN_TOP = 6
+
+      def block?
+        true
+      end
+
+      def extra_attrs
+        @extra_attrs ||= {
+          'margin-bottom' => MARGIN_BOTTOM.to_s,
+          'margin-top' => MARGIN_TOP.to_s
+        }
+      end
+    end
+  end
+end

data/lib/prawn_html/tags/small.rb

@@ -0,0 +1,16 @@
+# frozen_string_literal: true
+
+require_relative 'base'
+
+module PrawnHtml
+  module Tags
+    class Small < Base
+      ELEMENTS = [:small].freeze
+
+      def update_styles(styles)
+        size = (styles[:size] || Context::DEF_FONT_SIZE) * 0.85
+        styles[:size] = size
+      end
+    end
+  end
+end

data/lib/prawn_html/tags/span.rb

@@ -0,0 +1,11 @@
+# frozen_string_literal: true
+
+require_relative 'base'
+
+module PrawnHtml
+  module Tags
+    class Span < Base
+      ELEMENTS = [:span].freeze
+    end
+  end
+end

data/lib/prawn_html/tags/u.rb

@@ -0,0 +1,15 @@
+# frozen_string_literal: true
+
+module PrawnHtml
+  module Tags
+    class U < Base
+      ELEMENTS = [:ins, :u].freeze
+
+      def extra_attrs
+        {
+          'text-decoration' => 'underline'
+        }
+      end
+    end
+  end
+end

data/lib/prawn_html/tags/ul.rb

@@ -0,0 +1,23 @@
+# frozen_string_literal: true
+
+require_relative 'base'
+
+module PrawnHtml
+  module Tags
+    class Ul < Base
+      ELEMENTS = [:ul].freeze
+
+      MARGIN_LEFT = 25
+
+      def block?
+        true
+      end
+
+      def extra_attrs
+        @extra_attrs ||= {
+          'margin-left' => MARGIN_LEFT.to_s,
+        }
+      end
+    end
+  end
+end

data/lib/prawn_html/version.rb

@@ -0,0 +1,5 @@
+# frozen_string_literal: true
+
+module PrawnHtml # :nodoc:
+  VERSION = '0.1.0'
+end

metadata

@@ -0,0 +1,98 @@
+--- !ruby/object:Gem::Specification
+name: prawn-html
+version: !ruby/object:Gem::Version
+  version: 0.1.0
+platform: ruby
+authors:
+- Mattia Roccoberton
+autorequire:
+bindir: bin
+cert_chain: []
+date: 2021-08-10 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: oga
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '3.3'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '3.3'
+- !ruby/object:Gem::Dependency
+  name: prawn
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '2.4'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '2.4'
+description: HTML to PDF with Prawn PDF
+email: mat@blocknot.es
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- LICENSE.txt
+- README.md
+- lib/prawn-html.rb
+- lib/prawn_html/attributes.rb
+- lib/prawn_html/callbacks/highlight.rb
+- lib/prawn_html/callbacks/strike_through.rb
+- lib/prawn_html/context.rb
+- lib/prawn_html/document_renderer.rb
+- lib/prawn_html/html_handler.rb
+- lib/prawn_html/tags/a.rb
+- lib/prawn_html/tags/b.rb
+- lib/prawn_html/tags/base.rb
+- lib/prawn_html/tags/body.rb
+- lib/prawn_html/tags/br.rb
+- lib/prawn_html/tags/del.rb
+- lib/prawn_html/tags/div.rb
+- lib/prawn_html/tags/h.rb
+- lib/prawn_html/tags/hr.rb
+- lib/prawn_html/tags/i.rb
+- lib/prawn_html/tags/img.rb
+- lib/prawn_html/tags/li.rb
+- lib/prawn_html/tags/mark.rb
+- lib/prawn_html/tags/p.rb
+- lib/prawn_html/tags/small.rb
+- lib/prawn_html/tags/span.rb
+- lib/prawn_html/tags/u.rb
+- lib/prawn_html/tags/ul.rb
+- lib/prawn_html/version.rb
+homepage: https://github.com/blocknotes/prawn-html
+licenses:
+- MIT
+metadata: {}
+post_install_message:
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: 2.5.0
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubygems_version: 3.1.4
+signing_key:
+specification_version: 4
+summary: Prawn PDF - HTML renderer
+test_files: []