prawn-html 0.2.0 → 0.4.2

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 319cd3772829ddae0d52b3228b8544cb3906c32c58725082ce95da675bdb841f
-  data.tar.gz: e4cc3ec1cdbbe8ad655ef236d44a2c179178cf913d83f7bb307b2fe529927ae1
+  metadata.gz: 3eec6595a60748790725f32e92e7b749d92086e5331d8a572d287a3a90f9d83a
+  data.tar.gz: 89bcbe740f84c4ecdea2877e96d0f677a25bf424325b41fa40caf3d1351fba96
 SHA512:
-  metadata.gz: 58b388050c3f8c94075bab09353ca3974956b9eebb3fa1a7fdfff488ced919dc8182d744c620d2c2268b4fd26b76bbeaacfcb58717fdeee7c16862665176e66c
-  data.tar.gz: 386d529584f5cc8b9b6c326500270761c3a53f859243714980cb188d9496f820158ed83e1d399dc361e368b0a63b2eeaa585843719d83ca2fa75729b6ebffef4
+  metadata.gz: 9b34f31b07aaac30910fd1bcb2118b9cbe92bbdaf4ac80850520887e7c3803a6bb1217764551baeeb1a88d695d7b26c4885a4d3065bbd1f20527d37a5723c7bf
+  data.tar.gz: 6ed594bd070e4e4cf20519c28094f7d57eeb779f60c4867f380aab22946d20401bac307e17db47c0560b2cf1cdc591d80e07c3ff54999db92bd3040e19cc18d7

data/README.md

@@ -11,7 +11,7 @@ Features:
 - custom [data attributes](#data-attributes) for Prawn PDF features;
 - no extra settings: it just parses an input HTML and outputs to a Prawn PDF document.
 
-**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.
+**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* or *PDFKit*.
 
 > [prawn-styled-text](https://github.com/blocknotes/prawn-styled-text) rewritten from scratch, finally!
 
@@ -39,7 +39,9 @@ HTML tags:
 
 - **a**: link
 - **b**: bold
+- **blockquote**: block quotation element
 - **br**: new line
+- **code**: inline code element
 - **del**: strike-through
 - **div**: block element
 - **em**: italic
@@ -50,34 +52,50 @@ HTML tags:
 - **img**: image
 - **li**: list item
 - **mark**: highlight
+- **ol**: ordered list
 - **p**: block element
+- **pre**: preformatted text element
 - **s**: strike-through
 - **small**: smaller text
 - **span**: inline element
 - **strong**: bold
+- **sub**: subscript element
+- **sup**: superscript element
 - **u**: underline
-- **ul**: list
+- **ul**: unordered 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"`
+- **background**: for *mark* tag (3/6 hex digits or RGB or color name), ex. `style="background: #FECD08"`
+- **break-after**: go to a new page after some elements, ex. `style="break-after: auto"`
+- **break-before**: go to a new page before some elements, ex. `style="break-before: auto"`
+- **color**: (3/6 hex digits or RGB or color name) 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>`
+- **left**: see *position (absolute)*
 - **letter-spacing**: ex. `style="letter-spacing: 1.5"`
 - **line-height**: ex. `style="line-height: 10px"`
+- **list-style-type**: for *ul*, a string, ex. `style="list-style-type: '- '"`
 - **margin-bottom**: ex. `style="margin-bottom: 10px"`
 - **margin-left**: ex. `style="margin-left: 15px"`
 - **margin-top**: ex. `style="margin-top: 20px"`
+- **position**: `absolute`, ex. `style="position: absolute; left: 20px; top: 100px"`
 - **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"`
+- **top**: see *position (absolute)*
 - **width**: for *img* tag, support also percentage, ex. `<img src="image.jpg" style="width: 50%; height: 200px"/>`
 
+For colors, the supported formats are:
+- 3 hex digits, ex. `color: #FB1`;
+- 6 hex digits, ex. `color: #abcdef`;
+- RGB, ex. `color: RGB(64, 0, 128)`;
+- color name, ex. `color: yellow`.
+
 ## Data attributes
 
 Some custom data attributes are used to pass options:
@@ -87,8 +105,7 @@ Some custom data attributes are used to pass options:
 
 ## Document styles
 
-[Experimental feature] You can define document CSS rules inside an _head_ tag, but with a limited support for now.
-Only single CSS selectors and basic ones are supported. Example:
+You can define document CSS rules inside an _head_ tag. Example:
 
 ```html
 <!DOCTYPE html>
@@ -113,6 +130,28 @@ Only single CSS selectors and basic ones are supported. Example:
 </html>
 ```
 
+## Additional notes
+
+### Rails: generate PDF on the fly
+
+Sample controller's action to create a PDF from Rails:
+
+```rb
+class SomeController < ApplicationController
+  def sample_action
+    respond_to do |format|
+      format.pdf do
+        pdf = Prawn::Document.new
+        PrawnHtml.append_html(pdf, '<h1 style="text-align: center">Just a test</h1>')
+        send_data(pdf.render, filename: 'sample.pdf', type: 'application/pdf')
+      end
+    end
+  end
+end
+```
+
+More details in this blogpost: [generate PDF from HTML](https://www.blocknot.es/2021-08-20-rails-generate-pdf-from-html/)
+
 ## 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.

data/lib/prawn-html.rb

@@ -1,25 +1,180 @@
 # frozen_string_literal: true
 
-require 'oga'
-require 'prawn'
-
-require 'prawn_html/tag'
-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 constant for pixel sixes
 
+  COLORS = {
+    'aliceblue' => 'f0f8ff',
+    'antiquewhite' => 'faebd7',
+    'aqua' => '00ffff',
+    'aquamarine' => '7fffd4',
+    'azure' => 'f0ffff',
+    'beige' => 'f5f5dc',
+    'bisque' => 'ffe4c4',
+    'black' => '000000',
+    'blanchedalmond' => 'ffebcd',
+    'blue' => '0000ff',
+    'blueviolet' => '8a2be2',
+    'brown' => 'a52a2a',
+    'burlywood' => 'deb887',
+    'cadetblue' => '5f9ea0',
+    'chartreuse' => '7fff00',
+    'chocolate' => 'd2691e',
+    'coral' => 'ff7f50',
+    'cornflowerblue' => '6495ed',
+    'cornsilk' => 'fff8dc',
+    'crimson' => 'dc143c',
+    'cyan' => '00ffff',
+    'darkblue' => '00008b',
+    'darkcyan' => '008b8b',
+    'darkgoldenrod' => 'b8860b',
+    'darkgray' => 'a9a9a9',
+    'darkgreen' => '006400',
+    'darkgrey' => 'a9a9a9',
+    'darkkhaki' => 'bdb76b',
+    'darkmagenta' => '8b008b',
+    'darkolivegreen' => '556b2f',
+    'darkorange' => 'ff8c00',
+    'darkorchid' => '9932cc',
+    'darkred' => '8b0000',
+    'darksalmon' => 'e9967a',
+    'darkseagreen' => '8fbc8f',
+    'darkslateblue' => '483d8b',
+    'darkslategray' => '2f4f4f',
+    'darkslategrey' => '2f4f4f',
+    'darkturquoise' => '00ced1',
+    'darkviolet' => '9400d3',
+    'deeppink' => 'ff1493',
+    'deepskyblue' => '00bfff',
+    'dimgray' => '696969',
+    'dimgrey' => '696969',
+    'dodgerblue' => '1e90ff',
+    'firebrick' => 'b22222',
+    'floralwhite' => 'fffaf0',
+    'forestgreen' => '228b22',
+    'fuchsia' => 'ff00ff',
+    'gainsboro' => 'dcdcdc',
+    'ghostwhite' => 'f8f8ff',
+    'gold' => 'ffd700',
+    'goldenrod' => 'daa520',
+    'gray' => '808080',
+    'green' => '008000',
+    'greenyellow' => 'adff2f',
+    'grey' => '808080',
+    'honeydew' => 'f0fff0',
+    'hotpink' => 'ff69b4',
+    'indianred' => 'cd5c5c',
+    'indigo' => '4b0082',
+    'ivory' => 'fffff0',
+    'khaki' => 'f0e68c',
+    'lavender' => 'e6e6fa',
+    'lavenderblush' => 'fff0f5',
+    'lawngreen' => '7cfc00',
+    'lemonchiffon' => 'fffacd',
+    'lightblue' => 'add8e6',
+    'lightcoral' => 'f08080',
+    'lightcyan' => 'e0ffff',
+    'lightgoldenrodyellow' => 'fafad2',
+    'lightgray' => 'd3d3d3',
+    'lightgreen' => '90ee90',
+    'lightgrey' => 'd3d3d3',
+    'lightpink' => 'ffb6c1',
+    'lightsalmon' => 'ffa07a',
+    'lightseagreen' => '20b2aa',
+    'lightskyblue' => '87cefa',
+    'lightslategray' => '778899',
+    'lightslategrey' => '778899',
+    'lightsteelblue' => 'b0c4de',
+    'lightyellow' => 'ffffe0',
+    'lime' => '00ff00',
+    'limegreen' => '32cd32',
+    'linen' => 'faf0e6',
+    'magenta' => 'ff00ff',
+    'maroon' => '800000',
+    'mediumaquamarine' => '66cdaa',
+    'mediumblue' => '0000cd',
+    'mediumorchid' => 'ba55d3',
+    'mediumpurple' => '9370db',
+    'mediumseagreen' => '3cb371',
+    'mediumslateblue' => '7b68ee',
+    'mediumspringgreen' => '00fa9a',
+    'mediumturquoise' => '48d1cc',
+    'mediumvioletred' => 'c71585',
+    'midnightblue' => '191970',
+    'mintcream' => 'f5fffa',
+    'mistyrose' => 'ffe4e1',
+    'moccasin' => 'ffe4b5',
+    'navajowhite' => 'ffdead',
+    'navy' => '000080',
+    'oldlace' => 'fdf5e6',
+    'olive' => '808000',
+    'olivedrab' => '6b8e23',
+    'orange' => 'ffa500',
+    'orangered' => 'ff4500',
+    'orchid' => 'da70d6',
+    'palegoldenrod' => 'eee8aa',
+    'palegreen' => '98fb98',
+    'paleturquoise' => 'afeeee',
+    'palevioletred' => 'db7093',
+    'papayawhip' => 'ffefd5',
+    'peachpuff' => 'ffdab9',
+    'peru' => 'cd853f',
+    'pink' => 'ffc0cb',
+    'plum' => 'dda0dd',
+    'powderblue' => 'b0e0e6',
+    'purple' => '800080',
+    'rebeccapurple' => '663399',
+    'red' => 'ff0000',
+    'rosybrown' => 'bc8f8f',
+    'royalblue' => '4169e1',
+    'saddlebrown' => '8b4513',
+    'salmon' => 'fa8072',
+    'sandybrown' => 'f4a460',
+    'seagreen' => '2e8b57',
+    'seashell' => 'fff5ee',
+    'sienna' => 'a0522d',
+    'silver' => 'c0c0c0',
+    'skyblue' => '87ceeb',
+    'slateblue' => '6a5acd',
+    'slategray' => '708090',
+    'slategrey' => '708090',
+    'snow' => 'fffafa',
+    'springgreen' => '00ff7f',
+    'steelblue' => '4682b4',
+    'tan' => 'd2b48c',
+    'teal' => '008080',
+    'thistle' => 'd8bfd8',
+    'tomato' => 'ff6347',
+    'turquoise' => '40e0d0',
+    'violet' => 'ee82ee',
+    'wheat' => 'f5deb3',
+    'white' => 'ffffff',
+    'whitesmoke' => 'f5f5f5',
+    'yellow' => 'ffff00',
+    'yellowgreen' => '9acd32'
+  }.freeze
+
   def append_html(pdf, html)
-    handler = PrawnHtml::HtmlHandler.new(pdf)
-    handler.process(html)
+    pdf_wrapper = PdfWrapper.new(pdf)
+    renderer = DocumentRenderer.new(pdf_wrapper)
+    html_parser = PrawnHtml::HtmlParser.new(renderer)
+    html_parser.process(html)
   end
 
   module_function :append_html
 end
+
+require 'prawn'
+
+require 'prawn_html/utils'
+
+Dir["#{__dir__}/prawn_html/callbacks/*.rb"].sort.each { |f| require f }
+
+require 'prawn_html/tag'
+Dir["#{__dir__}/prawn_html/tags/*.rb"].sort.each { |f| require f }
+
+require 'prawn_html/attributes'
+require 'prawn_html/context'
+require 'prawn_html/pdf_wrapper'
+require 'prawn_html/document_renderer'
+require 'prawn_html/html_parser'

data/lib/prawn_html/attributes.rb

@@ -7,35 +7,43 @@ module PrawnHtml
     attr_reader :styles
 
     STYLES_APPLY = {
-      block: %i[align leading margin_left padding_left],
-      tag_close: %i[margin_bottom padding_bottom],
-      tag_open: %i[margin_top padding_top],
-      text_node: %i[background callback character_spacing color font link size styles]
+      block: %i[align leading left margin_left padding_left position top],
+      tag_close: %i[margin_bottom padding_bottom break_after],
+      tag_open: %i[margin_top padding_top break_before],
+      text_node: %i[background callback character_spacing color font link list_style_type size styles white_space]
     }.freeze
 
     STYLES_LIST = {
       # text node styles
       'background' => { key: :background, set: :convert_color },
-      'callback' => { key: :callback, set: :copy },
+      'callback' => { key: :callback, set: :copy_value },
       'color' => { key: :color, set: :convert_color },
       'font-family' => { key: :font, set: :unquote },
       'font-size' => { key: :size, set: :convert_size },
-      'font-style' => { key: :styles, set: :append_symbol },
-      'font-weight' => { key: :styles, set: :append_symbol },
-      'href' => { key: :link, set: :copy },
+      'font-style' => { key: :styles, set: :append_styles },
+      'font-weight' => { key: :styles, set: :append_styles },
+      'href' => { key: :link, set: :copy_value },
       'letter-spacing' => { key: :character_spacing, set: :convert_float },
-      'text-decoration' => { key: :styles, set: :append_symbol },
+      'list-style-type' => { key: :list_style_type, set: :unquote },
+      'text-decoration' => { key: :styles, set: :append_styles },
+      'vertical-align' => { key: :styles, set: :append_styles },
+      'white-space' => { key: :white_space, set: :convert_symbol },
       # tag opening styles
+      'break-before' => { key: :break_before, set: :convert_symbol },
       'margin-top' => { key: :margin_top, set: :convert_size },
       'padding-top' => { key: :padding_top, set: :convert_size },
       # tag closing styles
+      'break-after' => { key: :break_after, set: :convert_symbol },
       'margin-bottom' => { key: :margin_bottom, set: :convert_size },
       'padding-bottom' => { key: :padding_bottom, set: :convert_size },
       # block styles
+      'left' => { key: :left, set: :convert_size },
       'line-height' => { key: :leading, set: :convert_size },
       'margin-left' => { key: :margin_left, set: :convert_size },
       'padding-left' => { key: :padding_left, set: :convert_size },
-      'text-align' => { key: :align, set: :convert_symbol }
+      'position' => { key: :position, set: :convert_symbol },
+      'text-align' => { key: :align, set: :convert_symbol },
+      'top' => { key: :top, set: :convert_size }
     }.freeze
 
     STYLES_MERGE = %i[margin_left padding_left].freeze
@@ -44,10 +52,6 @@ module PrawnHtml
     def initialize(attributes = {})
       super
       @styles = {} # result styles
-      return unless style
-
-      styles_hash = Attributes.parse_styles(style)
-      process_styles(styles_hash)
     end
 
     # Processes the data attributes
@@ -60,83 +64,15 @@ module PrawnHtml
       end
     end
 
-    # Merge already parsed styles
+    # Merge text styles
     #
-    # @param parsed_styles [Hash] hash of parsed styles
-    def merge_styles!(parsed_styles)
-      @styles.merge!(parsed_styles)
-    end
-
-    # Processes the styles attributes
-    #
-    # @param styles_hash [Hash] hash of styles attributes
-    def process_styles(styles_hash)
-      styles_hash.each do |key, value|
-        apply_rule!(@styles, STYLES_LIST[key], value)
-      end
-      @styles
+    # @param text_styles [String] styles to parse and process
+    def merge_text_styles!(text_styles)
+      hash_styles = Attributes.parse_styles(text_styles)
+      process_styles(hash_styles) unless hash_styles.empty?
     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
-        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
-
-      # Copy a value without conversion
-      #
-      # @param value
-      #
-      # @return value
-      def copy(value)
-        value
-      end
-
       # Merges attributes
       #
       # @param attributes [Hash] target attributes hash
@@ -160,17 +96,6 @@ module PrawnHtml
       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
@@ -178,11 +103,18 @@ module PrawnHtml
     def apply_rule!(result, rule, value)
       return unless rule
 
-      if rule[:set] == :append_symbol
-        (result[rule[:key]] ||= []) << Attributes.convert_symbol(value)
+      if rule[:set] == :append_styles
+        (result[rule[:key]] ||= []) << Utils.normalize_style(value)
       else
-        result[rule[:key]] = Attributes.send(rule[:set], value)
+        result[rule[:key]] = Utils.send(rule[:set], value)
       end
     end
+
+    def process_styles(hash_styles)
+      hash_styles.each do |key, value|
+        apply_rule!(@styles, STYLES_LIST[key], value)
+      end
+      @styles
+    end
   end
 end