pdf2htmlex 0.1.0

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA256:
+  metadata.gz: b41b15ee0a9766fab2d08d3f77ccfe92c10b811c883347e57964b9b6e79c9b09
+  data.tar.gz: f846a1c3abbf90d5cc01d4f05960af3da32d9d2c8566a37fa52d96996c4f7ee9
+SHA512:
+  metadata.gz: 38cde8a2d5ba49fdb2fec7ab39843a62bfe3c3f96eb7c85dc71fe962f7832fac276c66daa514b74301169d4eb44674f752940203f1992fe5fe05fb5b01f96a54
+  data.tar.gz: 7c23bf805cebc8c9241ca1030bdcd025eed22909b0cf94438bae40a850fafa2bd362fdc31f67a281e28724794d61e29940f63eef93fd0d711c0417143efca338

data/.gitignore

@@ -0,0 +1,9 @@
+/.bundle/
+/.yardoc
+/_yardoc/
+/coverage/
+/doc/
+/pkg/
+/spec/reports/
+/tmp/
+

data/.rspec

@@ -0,0 +1 @@
+--require spec_helper

data/Gemfile

@@ -0,0 +1,8 @@
+# frozen_string_literal: true
+
+source 'https://rubygems.org'
+
+# Specify your gem's dependencies in pdf2htmlex.gemspec
+gemspec
+
+gem 'rake', '~> 12.0'

data/Gemfile.lock

@@ -0,0 +1,34 @@
+PATH
+  remote: .
+  specs:
+    pdf2htmlex (0.1.0)
+
+GEM
+  remote: https://rubygems.org/
+  specs:
+    diff-lcs (1.4.4)
+    rake (12.3.3)
+    rspec (3.10.0)
+      rspec-core (~> 3.10.0)
+      rspec-expectations (~> 3.10.0)
+      rspec-mocks (~> 3.10.0)
+    rspec-core (3.10.1)
+      rspec-support (~> 3.10.0)
+    rspec-expectations (3.10.1)
+      diff-lcs (>= 1.2.0, < 2.0)
+      rspec-support (~> 3.10.0)
+    rspec-mocks (3.10.2)
+      diff-lcs (>= 1.2.0, < 2.0)
+      rspec-support (~> 3.10.0)
+    rspec-support (3.10.2)
+
+PLATFORMS
+  ruby
+
+DEPENDENCIES
+  pdf2htmlex!
+  rake (~> 12.0)
+  rspec (~> 3.2)
+
+BUNDLED WITH
+   2.1.4

data/LICENSE.txt

@@ -0,0 +1,21 @@
+The MIT License (MIT)
+
+Copyright (c) 2021 Marcos G. Zimmermann
+
+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,125 @@
+# Ruby wrapper for pdf2htmlEX
+
+`pdf2htmlEX` converts PDF to HTML while retaining text, format and style as much as possible by making use of HTML5, JavaScript and modern CSS features. Even difficult content like PDFs with embedded fonts, multicolumn documents, scientific papers with complicated figures and mathematical formulas will mostly be represented correctly. Fallback mode generates HTML pages which do not require any JavaScript to view them correctly at the expense of a larger file size.
+
+## Installation
+
+You will need `pdf2htmlEX` installed. If you are using Mac OS X, I recommend installing pdf2htmlEX with Homebrew by running the following:
+
+    $ brew install pdf2htmlex
+
+If you are using Debian, you can install the pdf2htmlex package like so:
+
+    $ apt install pdf2htmlex
+
+If you've docker env setup, just install it via docker:
+
+    $ alias pdf2htmlex="docker run -ti --rm -v ~/pdf:/tmp/pdf iapain/pdf2htmlex pdf2htmlEX"
+
+After that just add this line to your application's Gemfile:
+
+```ruby
+gem 'pdf2htmlex'
+```
+
+And then execute:
+
+    $ bundle install
+
+Or install it yourself as:
+
+    $ gem install pdf2htmlex
+
+## Usage
+
+Configuration:
+
+```ruby
+require 'pdf2htmlex'
+
+Pdf2htmlex.config.executable = '/usr/local/bin/pdf2htmlEX' # Default value: 'pdf2htmlex'
+```
+
+To convert files use the `Pdf2htmlex::convert` method with the PDF file as the first argument, optional output filename as the second argument and list of options. Example:
+
+```ruby
+2.7.0 (main):0 > output = Pdf2htmlex.convert('./example/demo1.pdf')
+=> #<Pathname:/var/folders/rn/1xx0_xsd089fldtvtnq1tk7m0000gn/T/d20210409-96258-1pmrw5z/demo1.html>
+2.7.0 (main):0 > output = Pdf2htmlex.convert('./example/demo1.pdf', 'sample.html')
+=> #<Pathname:/var/folders/rn/1xx0_xsd089fldtvtnq1tk7m0000gn/T/d20210409-96258-14l7p6u/sample.html>
+2.7.0 (main):0 > output = Pdf2htmlex.convert('./example/demo1.pdf', 'demo.html', dest_dir: '/tmp')
+=> #<Pathname:/tmp/demo.html>
+```
+
+All options:
+```bash
+first_page: '--first-page',                           # first page to convert (default: 1)
+last_page: '--last-page',                             # last page to convert (default: 2147483647)
+zoom: '--zoom',                                       # zoom ratio
+fit_width: '--fit-width',                             # fit width to <fp> pixels
+fit_height: '--fit-height',                           # fit height to <fp> pixels
+use_cropbox: '--use-cropbox',                         # use CropBox instead of MediaBox (default: 1)
+hdpi: '--hdpi',                                       # horizontal resolution for graphics in DPI (default: 144)
+vdpi: '--vdpi',                                       # vertical resolution for graphics in DPI (default: 144)
+embed: '--embed',                                     # specify which elements should be embedded into output
+embed_css: '--embed-css',                             # embed CSS files into output (default: 1)
+embed_font: '--embed-font',                           # embed font files into output (default: 1)
+embed_image: '--embed-image',                         # embed image files into output (default: 1)
+embed_javascript: '--embed-javascript',               # embed JavaScript files into output (default: 1)
+embed_outline: '--embed-outline',                     # embed outlines into output (default: 1)
+split_pages: '--split-pages',                         # split pages into separate files (default: 0)
+dest_dir: '--dest-dir',                               # specify destination directory (default: ".")
+css_filename: '--css-filename',                       # filename of the generated css file (default: "")
+page_filename: '--page-filename',                     # filename template for split pages  (default: "")
+outline_filename: '--outline-filename',               # filename of the generated outline file (default: "")
+process_nontext: '--process-nontext',                 # render graphics in addition to text (default: 1)
+process_outline: '--process-outline',                 # show outline in HTML (default: 1)
+process_annotation: '--process-annotation',           # show annotation in HTML (default: 0)
+process_form: '--process-form',                       # include text fields and radio buttons (default: 0)
+printing: '--printing',                               # enable printing support (default: 1)
+fallback: '--fallback',                               # output in fallback mode (default: 0)
+tmp_file_size_limit: '--tmp-file-size-limit',         # Maximum size (in KB) used by temporary files, -1 for no limit. (default: -1)
+embed_external_font: '--embed-external-font',         # embed local match for external fonts (default: 1)
+font_format: '--font-format',                         # suffix for embedded font files (ttf,otf,woff,svg) (default: "woff")
+decompose_ligature: '--decompose-ligature',           # decompose ligatures, such as fi -> fi (default: 0)
+auto_hint: '--auto-hint',                             # use fontforge autohint on fonts without hints (default: 0)
+external_hint_tool: '--external-hint-tool',           # external tool for hinting fonts (overrides --auto-hint) (default: "")
+stretch_narrow_glyph: '--stretch-narrow-glyph',       # stretch narrow glyphs instead of padding them (default: 0)
+squeeze_wide_glyph: '--squeeze-wide-glyph',           # shrink wide glyphs instead of truncating them (default: 1)
+override_fstype: '--override-fstype',                 # clear the fstype bits in TTF/OTF fonts (default: 0)
+process_type3: '--process-type3',                     # convert Type 3 fonts for web (experimental) (default: 0)
+heps: '--heps',                                       # horizontal threshold for merging text, in pixels (default: 1)
+veps: '--veps',                                       # vertical threshold for merging text, in pixels (default: 1)
+space_threshold: '--space-threshold',                 # word break threshold (threshold * em) (default: 0.125)
+font_size_multiplier: '--font-size-multiplier',       # a value greater than 1 increases the rendering accuracy (default: 4)
+space_as_offset: '--space-as-offset',                 # treat space characters as offsets (default: 0)
+tounicode: '--tounicode',                             # how to handle ToUnicode CMaps (0=auto, 1=force, -1=ignore) (default: 0)
+optimize_text: '--optimize-text',                     # try to reduce the number of HTML elements used for text (default: 0)
+correct_text_visibility: '--correct-text-visibility', # try to detect texts covered by other graphics and properly arrange them (default: 0)
+bg_format: '--bg-format',                             # specify background image format (default: "png")
+svg_node_count_limit: '--svg-node-count-limit',       # if node count in a svg background image exceeds this limit, fall back this page to bitmap background; negative value means no limit. (default: -1)
+svg_embed_bitmap: '--svg-embed-bitmap',               # 1: embed bitmaps in svg background; 0: dump bitmaps to external files if possible. (default: 1)
+owner_password: '--owner-password',                   # owner password (for encrypted files)
+user_password: '--user-password',                     # user password (for encrypted files)
+no_drm: '--no-drm',                                   # override document DRM settings (default: 0)
+clean_tmp: '--clean-tmp',                             # remove temporary files after conversion (default: 1)
+tmp_dir: '--tmp-dir',                                 # specify the location of temporary directory. (default: "/var/folders/rn/1xx0_xsd089fldtvtnq1tk7m0000gn/T/")
+data_dir: '--data-dir',                               # specify data directory (default: "/usr/local/Cellar/pdf2htmlex/0.14.6_24/share/pdf2htmlEX")
+debug: '--debug',                                     # print debugging information (default: 0)
+proof: '--proof',                                     # texts are drawn on both text layer and background for proof. (default: 0)
+```
+
+## Development
+
+After checking out the repo, run `bin/setup` to install dependencies. You can also run `bin/console` for an interactive prompt that will allow you to experiment.
+
+To install this gem onto your local machine, run `bundle exec rake install`. To release a new version, update the version number in `version.rb`, and then run `bundle exec rake release`, which will create a git tag for the version, push git commits and tags, and push the `.gem` file to [rubygems.org](https://rubygems.org).
+
+## Contributing
+
+Bug reports and pull requests are welcome on GitHub at https://github.com/marcosgz/pdf2htmlex.
+
+
+## License
+
+The gem is available as open source under the terms of the [MIT License](https://opensource.org/licenses/MIT).

data/Rakefile

@@ -0,0 +1,4 @@
+# frozen_string_literal: true
+
+require 'bundler/gem_tasks'
+task default: :spec

data/bin/console

@@ -0,0 +1,15 @@
+#!/usr/bin/env ruby
+# frozen_string_literal: true
+
+require 'bundler/setup'
+require 'pdf2htmlex'
+
+# You can add fixtures and/or initialization code here to make experimenting
+# with your gem easier. You can also use a different console, if you like.
+
+# (If you use this, don't forget to add pry to your Gemfile!)
+# require "pry"
+# Pry.start
+
+require 'irb'
+IRB.start(__FILE__)

data/bin/setup

@@ -0,0 +1,8 @@
+#!/usr/bin/env bash
+set -euo pipefail
+IFS=$'\n\t'
+set -vx
+
+bundle install
+
+# Do any other automated setup that you need to do here

data/lib/pdf2htmlex.rb

@@ -0,0 +1,156 @@
+# frozen_string_literal: true
+
+# @see https://www.rubydoc.info/stdlib/open3/Open3.popen3
+require 'open3'
+# @see https://www.rubydoc.info/stdlib/pathname/Pathname
+require 'pathname'
+# @see https://ruby-doc.com/stdlib/libdoc/tmpdir/rdoc/Dir.html
+require 'tmpdir'
+
+require_relative 'pdf2htmlex/version'
+require_relative 'pdf2htmlex/config'
+
+# Ruby wrapper for the pdf2htmlEX tool
+#
+# `pdf2htmlEX` converts PDF to HTML while retaining text, format and style as much as
+# possible by making use of HTML5, JavaScript and modern CSS features. Even difficult
+# content like PDFs with embedded fonts, multicolumn documents, scientific papers with
+# complicated figures and mathematical formulas will mostly be represented correctly.
+# Fallback mode generates HTML pages which do not require any JavaScript to view them
+# correctly at the expense of a larger file size.
+#
+# @see https://github.com/coolwanglu/pdf2htmlEX
+module Pdf2htmlex
+  class Error < StandardError; end
+
+  extend self
+
+  # Convert input PDF file to HTML
+  #
+  # @param input_pdf [String, Pathname] The path of PDF file
+  # @param html_filename [String, Pathname, NilClass] The output HTML filename
+  # @param options [Hash] List of pdf2htmlex options
+  # @option [Integer] :first_page (default: 1) First page to convert
+  # @option [Integer] :last_page (default: 2147483647) Last page to convert
+  # @option [Float] :zoom Zoom ratio
+  # @option [Float] :fit_width Fit width to <fp> pixels
+  # @option [Float] :fit_height Fit height to <fp> pixels
+  # @option [Boolean, Integer] :use_cropbo (default: true) Use CropBox instead of MediaBox
+  # @option [Float] :hdpi (default: 144) Horizontal resolution for graphics in DPI
+  # @option [Float] :vdpi (default: 144) Vertical resolution for graphics in DPI
+  # @option [String] :embed Specify which elements should be embedded into output
+  # @option [Boolean, Integer] :embed_css (default: true) Embed CSS files into output
+  # @option [Boolean, Integer] :embed_font (default: true) Embed font files into output
+  # @option [Boolean, Integer] :embed_image (default: true) Embed image files into output
+  # @option [Boolean, Integer] :embed_javascript (default: true) Embed JavaScript files into output
+  # @option [Boolean, Integer] :embed_outline (default: true) Embed outlines into output
+  # @option [Boolean, Integer] :split_pages (default: false) Split pages into separate files
+  # @option [String] :dest_dir (default: ".") Specify destination directory
+  # @option [String] :css_filename (default: "") Filename of the generated css file
+  # @option [String] :page_filename (default: "") Filename template for split pages
+  # @option [String] :outline_filename (default: "") Filename of the generated outline file
+  # @option [Boolean, Integer] :process_nontext (default: true) Render graphics in addition to text
+  # @option [Boolean, Integer] :process_outline (default: true) Show outline in HTML
+  # @option [Boolean, Integer] :process_annotation (default: false) Show annotation in HTML
+  # @option [Boolean, Integer] :process_form (default: false) Include text fields and radio buttons
+  # @option [Boolean, Integer] :printing (default: true) Enable printing support
+  # @option [Boolean, Integer] :fallback (default: false) Output in fallback mode
+  # @option [Integer] :tmp_file_size_limit (default: -1) Maximum size (in KB) used by temporary files, -1 for no limit.
+  # @option [Boolean, Integer] :embed_external_font (default: true) Embed local match for external fonts
+  # @option [String] :font_format (default: "woff") Suffix for embedded font files (ttf,otf,woff,svg)
+  # @option [Boolean, Integer] :decompose_ligature (default: false) Decompose ligatures, such as fi -> fi
+  # @option [Boolean, Integer] :auto_hint (default: false) Use fontforge autohint on fonts without hints
+  # @option [String] :external_hint_tool (default: "") External tool for hinting fonts (overrides --auto-hint)
+  # @option [Boolean, Integer] :stretch_narrow_glyph (default: false) Stretch narrow glyphs instead of padding them
+  # @option [Boolean, Integer] :squeeze_wide_glyph (default: true) Shrink wide glyphs instead of truncating them
+  # @option [Boolean, Integer] :override_fstype (default: false) Clear the fstype bits in TTF/OTF fonts
+  # @option [Boolean, Integer] :process_type3 (default: false) Convert Type 3 fonts for web (experimental)
+  # @option [Float] :heps (default: 1) Horizontal threshold for merging text, in pixels
+  # @option [Float] :veps (default: 1) Vertical threshold for merging text, in pixels
+  # @option [Float] :space_threshold(default: 0.125)  Word break threshold (threshold * em)
+  # @option [Integer] :font_size_multiplier (default: 4) A value greater than 1 increases the rendering accuracy
+  # @option [Boolean, Integer] :space_as_offset (default: false) Treat space characters as offsets
+  # @option [Integer] :tounicode (default: 0) How to handle ToUnicode CMaps (0=auto, 1=force, -1=ignore)
+  # @option [Boolean, Integer] :optimize_text (default: false) Try to reduce the number of HTML elements used for text
+  # @option [Boolean, Integer] :correct_text_visibility (default: false) Try to detect texts covered by other graphics and properly arrange them
+  # @option [String] :bg_format (default: "png") Specify background image format
+  # @option [Integer] :svg_node_count_limit (default: -1) if node count in a svg background image exceeds this limit, fall back this page to bitmap background; negative value means no limit
+  # @option [Boolean, Integer] :svg_embed_bitmap (default: true) True: embed bitmaps in svg background; False: dump bitmaps to external files if possible.
+  # @option [String] :owner_password Owner password (for encrypted files)
+  # @option [String] :user_password User password (for encrypted files)
+  # @option [Boolean, Integer] :no_drm (default: false) Override document DRM settings
+  # @option [Boolean, Integer] :clean_tmp (default: true) Remove temporary files after conversion
+  # @option [String] :tmp_dir (default: "/var/folders/rn/1xx0_xsd089fldtvtnq1tk7m0000gn/T/") Specify the location of temporary directory
+  # @option [String] :data_dir (default: "/usr/local/Cellar/pdf2htmlex/0.14.6_24/share/pdf2htmlEX") Specify data directory
+  # @option [Boolean, Integer] :debug (default: false) Print debugging information
+  # @option [Boolean, Integer] :proof (default: false) Exts are drawn on both text layer and background for proof.
+  # @raise [Pdf2htmlex::Error] catch errors from pdf2htmlEX into Pdf2htmlex::Error exception
+  # @return [Pathname] The generated HTML file
+  def convert(input_pdf, html_filename = nil, **options)
+    options[:dest_dir] ||= make_tempdir
+
+    output = output_html(options[:dest_dir], html_filename || input_pdf)
+    command = normalize_options(options)
+    command << input_pdf
+    command << output.basename.to_s
+
+    run_command(command)
+
+    output
+  end
+
+  private
+
+  def make_tempdir
+    Dir.mktmpdir
+  end
+
+  # Generate a unique HTML filename within destination directory
+  # @param base_dir [String] The directory path
+  # @param target_filename [String] the
+  def output_html(base_dir, target_filename)
+    basename = File.basename(target_filename).sub(%r{\.(pdf|htm|html)$}i, '')
+    filename = File.join(base_dir, format('%<fname>s.html', fname: basename))
+    n = 0
+    while File.exist?(filename)
+      n += 1
+      filename = File.join(base_dir, format('%<fname>s.%<fnum>d.html', fname: basename, fnum: n))
+    end
+    Pathname.new(filename)
+  end
+
+  def normalize_options(opts)
+    [].tap do |arr|
+      opts.each do |k, v|
+        next if v.nil?
+        next unless CMD_OPTIONS.key?(k)
+
+        arr << CMD_OPTIONS[k] << cast_value(v)
+      end
+    end
+  end
+
+  def cast_value(value)
+    case value
+    when Proc then cast_value(value.call)
+    when TrueClass then '1'
+    when FalseClass then '0'
+    else
+      value
+    end
+  end
+
+  def run_command(command, input = nil)
+    opts = { binmode: true, stdin_data: input }
+
+    command.unshift config.executable
+
+    output, error, status = Open3.capture3(*command, opts)
+
+    if status.exitstatus != 0
+      raise Error, "pdf2htmlEX failed with: #{error}\nCommand: #{command.join(' ')}"
+    end
+
+    output
+  end
+end

data/lib/pdf2htmlex/config.rb

@@ -0,0 +1,66 @@
+# frizen_string_literal: true
+
+module Pdf2htmlex
+  CMD_OPTIONS = {
+    first_page: '--first-page',                           # first page to convert (default: 1)
+    last_page: '--last-page',                             # last page to convert (default: 2147483647)
+    zoom: '--zoom',                                       # zoom ratio
+    fit_width: '--fit-width',                             # fit width to <fp> pixels
+    fit_height: '--fit-height',                           # fit height to <fp> pixels
+    use_cropbox: '--use-cropbox',                         # use CropBox instead of MediaBox (default: 1)
+    hdpi: '--hdpi',                                       # horizontal resolution for graphics in DPI (default: 144)
+    vdpi: '--vdpi',                                       # vertical resolution for graphics in DPI (default: 144)
+    embed: '--embed',                                     # specify which elements should be embedded into output
+    embed_css: '--embed-css',                             # embed CSS files into output (default: 1)
+    embed_font: '--embed-font',                           # embed font files into output (default: 1)
+    embed_image: '--embed-image',                         # embed image files into output (default: 1)
+    embed_javascript: '--embed-javascript',               # embed JavaScript files into output (default: 1)
+    embed_outline: '--embed-outline',                     # embed outlines into output (default: 1)
+    split_pages: '--split-pages',                         # split pages into separate files (default: 0)
+    dest_dir: '--dest-dir',                               # specify destination directory (default: ".")
+    css_filename: '--css-filename',                       # filename of the generated css file (default: "")
+    page_filename: '--page-filename',                     # filename template for split pages  (default: "")
+    outline_filename: '--outline-filename',               # filename of the generated outline file (default: "")
+    process_nontext: '--process-nontext',                 # render graphics in addition to text (default: 1)
+    process_outline: '--process-outline',                 # show outline in HTML (default: 1)
+    process_annotation: '--process-annotation',           # show annotation in HTML (default: 0)
+    process_form: '--process-form',                       # include text fields and radio buttons (default: 0)
+    printing: '--printing',                               # enable printing support (default: 1)
+    fallback: '--fallback',                               # output in fallback mode (default: 0)
+    tmp_file_size_limit: '--tmp-file-size-limit',         # Maximum size (in KB) used by temporary files, -1 for no limit. (default: -1)
+    embed_external_font: '--embed-external-font',         # embed local match for external fonts (default: 1)
+    font_format: '--font-format',                         # suffix for embedded font files (ttf,otf,woff,svg) (default: "woff")
+    decompose_ligature: '--decompose-ligature',           # decompose ligatures, such as fi -> fi (default: 0)
+    auto_hint: '--auto-hint',                             # use fontforge autohint on fonts without hints (default: 0)
+    external_hint_tool: '--external-hint-tool',           # external tool for hinting fonts (overrides --auto-hint) (default: "")
+    stretch_narrow_glyph: '--stretch-narrow-glyph',       # stretch narrow glyphs instead of padding them (default: 0)
+    squeeze_wide_glyph: '--squeeze-wide-glyph',           # shrink wide glyphs instead of truncating them (default: 1)
+    override_fstype: '--override-fstype',                 # clear the fstype bits in TTF/OTF fonts (default: 0)
+    process_type3: '--process-type3',                     # convert Type 3 fonts for web (experimental) (default: 0)
+    heps: '--heps',                                       # horizontal threshold for merging text, in pixels (default: 1)
+    veps: '--veps',                                       # vertical threshold for merging text, in pixels (default: 1)
+    space_threshold: '--space-threshold',                 # word break threshold (threshold * em) (default: 0.125)
+    font_size_multiplier: '--font-size-multiplier',       # a value greater than 1 increases the rendering accuracy (default: 4)
+    space_as_offset: '--space-as-offset',                 # treat space characters as offsets (default: 0)
+    tounicode: '--tounicode',                             # how to handle ToUnicode CMaps (0=auto, 1=force, -1=ignore) (default: 0)
+    optimize_text: '--optimize-text',                     # try to reduce the number of HTML elements used for text (default: 0)
+    correct_text_visibility: '--correct-text-visibility', # try to detect texts covered by other graphics and properly arrange them (default: 0)
+    bg_format: '--bg-format',                             # specify background image format (default: "png")
+    svg_node_count_limit: '--svg-node-count-limit',       # if node count in a svg background image exceeds this limit, fall back this page to bitmap background; negative value means no limit. (default: -1)
+    svg_embed_bitmap: '--svg-embed-bitmap',               # 1: embed bitmaps in svg background; 0: dump bitmaps to external files if possible. (default: 1)
+    owner_password: '--owner-password',                   # owner password (for encrypted files)
+    user_password: '--user-password',                     # user password (for encrypted files)
+    no_drm: '--no-drm',                                   # override document DRM settings (default: 0)
+    clean_tmp: '--clean-tmp',                             # remove temporary files after conversion (default: 1)
+    tmp_dir: '--tmp-dir',                                 # specify the location of temporary directory. (default: "/var/folders/rn/1xx0_xsd089fldtvtnq1tk7m0000gn/T/")
+    data_dir: '--data-dir',                               # specify data directory (default: "/usr/local/Cellar/pdf2htmlex/0.14.6_24/share/pdf2htmlEX")
+    debug: '--debug',                                     # print debugging information (default: 0)
+    proof: '--proof',                                     # texts are drawn on both text layer and background for proof. (default: 0)
+  }
+
+  Config = Struct.new(:executable)
+
+  def config
+    @config ||= Config.new('pdf2htmlex')
+  end
+end

data/lib/pdf2htmlex/version.rb

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

data/pdf2htmlex.gemspec

@@ -0,0 +1,34 @@
+# frozen_string_literal: true
+
+require_relative 'lib/pdf2htmlex/version'
+
+Gem::Specification.new do |spec|
+  spec.name          = 'pdf2htmlex'
+  spec.version       = Pdf2htmlex::VERSION
+  spec.authors       = ['Marcos G. Zimmermann']
+  spec.email         = ['mgzmaster@gmail.com']
+
+  spec.summary       = 'Ruby wrapper for the pdf2htmlEX that convert PDF files to HTML'
+  spec.description   = 'pdf2htmlEX helps to convert PDF files into HTML. This simple library uses the pdf2htmlEX tool under the hood.'
+  spec.homepage      = 'https://github.com/marcosgz/pdf2htmlex'
+  spec.license       = 'MIT'
+  spec.required_ruby_version = Gem::Requirement.new('>= 2.3.0')
+
+  spec.metadata['allowed_push_host'] = 'https://rubygems.org'
+
+  spec.metadata['homepage_uri'] = spec.homepage
+  spec.metadata['source_code_uri'] = 'https://github.com/marcosgz/pdf2htmlex'
+  spec.metadata['changelog_uri'] = 'https://github.com/marcosgz/blob/main/pdf2htmlex'
+
+  # Specify which files should be added to the gem when it is released.
+  # The `git ls-files -z` loads the files in the RubyGem that have been added into git.
+  spec.files = Dir.chdir(File.expand_path(__dir__)) do
+    `git ls-files -z`.split("\x0").reject { |f| f.match(%r{^(test|spec|features)/}) }
+  end
+  spec.bindir        = 'exe'
+  spec.executables   = spec.files.grep(%r{^exe/}) { |f| File.basename(f) }
+  spec.require_paths = ['lib']
+  spec.requirements << 'pdf2htmlEX'
+
+  spec.add_development_dependency 'rspec', '~> 3.2'
+end

metadata

@@ -0,0 +1,78 @@
+--- !ruby/object:Gem::Specification
+name: pdf2htmlex
+version: !ruby/object:Gem::Version
+  version: 0.1.0
+platform: ruby
+authors:
+- Marcos G. Zimmermann
+autorequire: 
+bindir: exe
+cert_chain: []
+date: 2021-04-09 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: rspec
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '3.2'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '3.2'
+description: pdf2htmlEX helps to convert PDF files into HTML. This simple library
+  uses the pdf2htmlEX tool under the hood.
+email:
+- mgzmaster@gmail.com
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- ".gitignore"
+- ".rspec"
+- CHANGELOG.md
+- Gemfile
+- Gemfile.lock
+- LICENSE.txt
+- README.md
+- Rakefile
+- bin/console
+- bin/setup
+- example/demo1.pdf
+- lib/pdf2htmlex.rb
+- lib/pdf2htmlex/config.rb
+- lib/pdf2htmlex/version.rb
+- pdf2htmlex.gemspec
+homepage: https://github.com/marcosgz/pdf2htmlex
+licenses:
+- MIT
+metadata:
+  allowed_push_host: https://rubygems.org
+  homepage_uri: https://github.com/marcosgz/pdf2htmlex
+  source_code_uri: https://github.com/marcosgz/pdf2htmlex
+  changelog_uri: https://github.com/marcosgz/blob/main/pdf2htmlex
+post_install_message: 
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: 2.3.0
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements:
+- pdf2htmlEX
+rubygems_version: 3.1.2
+signing_key: 
+specification_version: 4
+summary: Ruby wrapper for the pdf2htmlEX that convert PDF files to HTML
+test_files: []