pdf_paradise 0.3.20

data/lib/pdf_paradise/commandline/menu.rb

@@ -0,0 +1,173 @@
+#!/usr/bin/ruby -w
+# Encoding: UTF-8
+# frozen_string_literal: true
+# =========================================================================== #
+# require 'pdf_paradise/commandline/menu.rb'
+# =========================================================================== #
+module PdfParadise
+
+  require 'pdf_paradise/set_pdf_title.rb'
+  require 'pdf_paradise/toplevel_methods/e.rb'
+  require 'pdf_paradise/toplevel_methods/reduce_size_of_this_pdf_file.rb'
+  require 'pdf_paradise/toplevel_methods/opened_pdf_files.rb'
+  require 'pdf_paradise/commandline/commandline.rb'
+  require 'pdf_paradise/commandline/help.rb'
+
+  # ========================================================================= #
+  # === PdfParadise.menu                                           (menu tag)
+  # ========================================================================= #
+  def self.menu(i)
+    if i.is_a? Array
+      i.each {|entry| menu(entry) }
+    else
+      case i # case tag
+      # ===================================================================== #
+      # === pdfpa --mega-checker
+      #
+      # Invocation examples:
+      #
+      #   pdf_paradise --mega-checker
+      #   pdf_paradise --super-check
+      #   pdf_paradise --check-every-pdf-file
+      #
+      # ===================================================================== #
+      when /^-?-?mega(-|_)?checker$/i,
+           /^-?-?super(-|_)?check$/i,
+           /^-?-?check(-|_)?every(-|_)?pdf(-|_)?file$/i
+        mega_check_every_pdf_file_in_the_current_directory
+      # ===================================================================== #
+      # === pdfpa --jruby
+      #
+      # Invocation example:
+      #
+      #   jruby /usr/bin/pdf_paradise --jruby1
+      #
+      # ===================================================================== #
+      when /^-?-?jruby1?$/
+        require 'pdf_paradise/gui/jruby/delete_the_first_or_the_last_page_of_this_pdf_file/delete_the_first_or_the_last_page_of_this_pdf_file.rb'
+        start_the_jruby_interface_for_deleting_pages_in_a_pdf_file
+      # ===================================================================== #
+      # === pdfpa --libui1
+      # ===================================================================== #
+      when /^-?-?libui1$/
+        require 'pdf_paradise/gui/libui/remove_the_first_page_of_this_pdf_file/remove_the_first_page_of_this_pdf_file.rb'
+        PdfParadise::GUI::LibUI::RemoveTheFirstPageOfThisPdfFile.new      
+      # ===================================================================== #
+      # === pdfpa --libui
+      #
+      # This entry point will always refer to the most important 
+      # libui widget.
+      # ===================================================================== #
+      when /^-?-?libui$/
+        start_the_most_important_libui_wrapper(commandline_arguments?)
+      # ===================================================================== #
+      # === pdfpa --open-pdf-files
+      # ===================================================================== #
+      when /^-?-?open(-|_)?pdf(-|_)?files$/
+        open_the_default_pdf_files
+      # ===================================================================== #
+      # === pdfparadise --controller
+      # ===================================================================== #
+      when /^-?-?controller$/
+        require 'pdf_paradise/gui/gtk3/controller/controller.rb'
+        PdfParadise::GUI::Gtk::Controller.run
+      # ===================================================================== #
+      # === --use-this-pdf-file=DONE_Life_History_Evolution_WS_17_4.pdf
+      # ===================================================================== #
+      when /^-?-?use(-|_)?this(-|_)?pdf(-|_)?file=(.+)$/, # === $4
+           /^-?-?set(-|_)?pdf(-|_)?title=(.+)$/,          # === $3
+           /^-?-?use(-|_)?this(-|_)?title=(.+)$/          # === $4
+        i = $3 # <- This is for the second line ^^^.
+        i = $4 if $4 # <- And this is for the first line.
+        set_use_this_pdf_file(i)
+      # ===================================================================== #
+      # === pdf_paradise --sinatra
+      # ===================================================================== #
+      when /^-?-?sinatra$/i,
+           /^-?-?www$/i # === pdf_paradise --www
+        require 'pdf_paradise/www/sinatra/app.rb'
+        PdfParadise.start_sinatra_interface
+      # ===================================================================== #
+      # === pdf_paradise --autoconvert
+      # ===================================================================== #
+      when /^-?-?autoconvert$/i
+        autoconvert_pdf_files_in_the_main_directory
+      # ===================================================================== #
+      # === pdf_paradise --gui
+      # === pdf_paradise --gtk
+      # ===================================================================== #
+      when /^-?-?gui$/,
+           /^-?-?gtk$/
+        require 'pdf_paradise/gui/gtk2/split_pdf_file/split_pdf_file.rb'
+        PdfParadise.start_gtk_gui
+      # ===================================================================== #
+      # === pdf_paradise --show_last_opened_pdf_files
+      # ===================================================================== #
+      when /^-?-?show(-|_)?last(-|_)?opened(-|_)?pdf(-|_)?files$/i,
+           /^-?-?pdf(-|_)?file(-|_)?content$/i, # pdfparadise --pdf-file-content
+           /^-?-?last(-|_)?open(-|_)?pdf\??$/i,
+           /^-?-?last-pdf$/i,
+           /^-?-?last\??$/i,
+           /^-?-?pdf\??$/i # pdfparadise --pdf?
+        PdfParadise.show_last_opened_pdf_files
+      # ===================================================================== #
+      # === pdfparadise --store-open-pdf-files
+      # ===================================================================== #
+      when /^-?-?store(-|_| )?open(-|_| )?pdf(-|_| )?files$/,
+           /^-?-?store(-|_| )?open(-|_| )?pdfs?$/,
+           /^-?-?store(-|_| )?pdf(-|_| )?files$/,
+           /^-?-?store(-|_| )?pdfs$/
+        PdfParadise.store_all_currently_open_pdf_files
+      # ===================================================================== #
+      # === pdf_paradise --array-all-currently-opened-pdf-files
+      # ===================================================================== #
+      when /^-?-?array(-|_| )?all(-|_| )?currently(-|_| )?opened(-|_| )?pdf(-|_| )?files$/i,
+           /^-?-?show(-|_| )?currently(-|_| )?open(-|_| )?pdf(-|_| )?files$/i
+        PdfParadise.return_array_of_all_currently_opened_pdf_files(:do_not_run_locate).each {|entry|
+          e entry
+        }
+      # ===================================================================== #
+      # === pdfparadise --open-last-pdf-files
+      # ===================================================================== #
+      when /^-?-?open(-|_| )?last(-|_| )?pdf(-|_| )?files$/,
+           /^-?-?open(-|_| )?last(-|_| )?opened(-|_| )?pdf(-|_| )?files$/,
+           /^-?-?open(-|_| )?last(-|_| )?pdfs$/,
+           /^-?-?main$/, # <- This is the main task (main tag)
+           /^-?-?restore$/
+        PdfParadise.open_last_opened_pdf_files
+      # ===================================================================== #
+      # === pdf_paradise --shrink-pdf-size-of=foobar.pdf
+      # ===================================================================== #
+      when /^-?-?shrink(-|_)?pdf(-|_)?size(-|_)?of=(.+)/i,
+           /^-?-?shrink=(.+)/i
+        this_file = $1.to_s.dup
+        this_file = $4.to_s.dup if $4
+        reduce_size_of_this_pdf_file(this_file)
+      # ===================================================================== #
+      # === pdf_paradise --help
+      # ===================================================================== #
+      when /^-?-?help/
+        show_help
+      # ===================================================================== #
+      # === --set_title="Hello world!"
+      # ===================================================================== #
+      when /^--set(-|_)?title=(.+)$/,
+           /^--title=(.+)$/
+        # =================================================================== #
+        # @use_this_pdf_file has to have been set properly before calling
+        # this method.
+        # =================================================================== #
+        i = $1
+        i = $2 if $2
+        PdfParadise.set_title_of_this_pdf_file(@use_this_pdf_file, i)
+      else
+        e "Unknown command: #{i}" unless File.exist?(i)
+      end
+    end
+  end
+
+end
+
+if __FILE__ == $PROGRAM_NAME
+  PdfParadise.menu(ARGV)
+end

data/lib/pdf_paradise/compress/compress_this_pdf_file.rb

@@ -0,0 +1,108 @@
+#!/usr/bin/ruby -w
+# Encoding: UTF-8
+# frozen_string_literal: true
+# =========================================================================== #
+# === PdfParadise::CompressThisPdfFile
+#
+# This class can be used to compress a .pdf file.
+#
+# Usage example:
+#
+#   PdfParadise::CompressThisPdfFile.new(ARGV)
+#
+# =========================================================================== #
+require 'pdf_paradise/base/base.rb'
+
+module PdfParadise
+
+class CompressThisPdfFile < ::PdfParadise::Base # === PdfParadise::CompressThisPdfFile
+
+  include FileUtils::Verbose
+
+  # ========================================================================= #
+  # === initialize
+  # ========================================================================= #
+  def initialize(
+      i           = ARGV,
+      run_already = true
+    )
+    reset
+    set_commandline_arguments(i)
+    run if run_already
+  end
+
+  # ========================================================================= #
+  # === reset                                                     (reset tag)
+  # ========================================================================= #
+  def reset
+    super()
+    infer_the_namespace
+    # ======================================================================= #
+    # === @use_this_compatibility_level
+    #
+    # Note that -dCompatibilityLevel will be overridden by what is
+    # chosen in -dPDFSETTINGS.
+    #
+    # Note that this refers to the PDF standard; 1.7 is fairly recent.
+    # ======================================================================= #
+    @use_this_compatibility_level = '1.7'
+    # ======================================================================= #
+    # === @d_pdf_settings_value
+    # ======================================================================= #
+    @d_pdf_settings_value = :screen # Or :prepress
+  end
+
+  # ========================================================================= #
+  # === set_work_on_these_files
+  # ========================================================================= #
+  def set_work_on_these_files(i)
+    @work_on_these_files = [i].flatten.compact
+  end
+
+  # ========================================================================= #
+  # === do_work_on_all_files
+  # ========================================================================= #
+  def do_work_on_all_files(
+      i = @work_on_these_files
+    )
+    i.each {|this_file|
+      store_into_this_file = 'compressed_PDF_file.pdf'
+      cmd = "gs -sDEVICE=pdfwrite "\
+            "-dCompatibilityLevel=#{@use_this_compatibility_level} "\
+            "-dPDFSETTINGS=/#{@d_pdf_settings_value} "\
+            "-dNOPAUSE -dQUIET -dBATCH "\
+            "-sOutputFile=#{store_into_this_file} #{this_file}"
+      e
+      e "#{rev}The compressed .pdf file will be stored "\
+        "here: #{sfile(store_into_this_file)}"
+      e
+      esystem cmd
+      e
+    } 
+  end
+
+  # ========================================================================= #
+  # === run                                                         (run tag)
+  #
+  # Note that using /ebook rather than /prepress would reduce the file
+  # size even further.
+  # ========================================================================= #
+  def run
+    set_work_on_these_files(commandline_arguments?)
+    do_work_on_all_files
+  end
+
+end
+
+# =========================================================================== #
+# === PdfParadise.compress_this_pdf_file
+# =========================================================================== #
+def self.compress_this_pdf_file(i = ARGV)
+  PdfParadise::CompressThisPdfFile.new(i)
+end
+
+end
+
+if __FILE__ == $PROGRAM_NAME
+  PdfParadise::CompressThisPdfFile.new(ARGV)
+end # compressthispdffile

data/lib/pdf_paradise/compress/compress_via_hexapdf.rb

@@ -0,0 +1,27 @@
+#!/usr/bin/ruby -w
+# Encoding: UTF-8
+# frozen_string_literal: true
+# =========================================================================== #
+# require 'pdf_paradise/compress/compress_via_hexapdf.rb'
+# PdfParadise.compress_via_pdf(ARGV)
+# =========================================================================== #
+module PdfParadise
+
+  # ========================================================================= #
+  # === PdfParadise.compress_via_pdf
+  # ========================================================================= #
+  def self.compress_via_pdf(
+      this_file = 'foobar.pdf'
+    )
+    if this_file.is_a? Array
+      this_file = this_file.first
+    end
+    require 'pdf_paradise/hexapdf/hexapdf.rb'
+    HexaPDF.optimize_this_pdf_file(this_file)
+  end; self.instance_eval { alias compress_via_hexapdf compress_via_pdf } # === PdfParadise.compress_via_hexapdf
+
+end
+
+if __FILE__ == $PROGRAM_NAME
+  PdfParadise.compress_via_pdf(ARGV)
+end # rb $RUBY_SRC/pdf_paradise/lib/pdf_paradise/compress/compress_via_hexapdf.rb ack.pdf

data/lib/pdf_paradise/compress/compress_via_qpdf.rb

@@ -0,0 +1,32 @@
+#!/usr/bin/ruby -w
+# Encoding: UTF-8
+# frozen_string_literal: true
+# =========================================================================== #
+# require 'pdf_paradise/compress/compress_via_qpdf.rb'
+# PdfParadise.compress_via_qpdf(ARGV)
+# =========================================================================== #
+module PdfParadise
+
+  require 'pdf_paradise/toplevel_methods/esystem.rb'
+
+  # ========================================================================= #
+  # === PdfParadise.compress_via_qpdf
+  # ========================================================================= #
+  def self.compress_via_qpdf(
+      this_file = 'foobar.pdf'
+    )
+    if this_file.is_a? Array
+      this_file = this_file.first
+    end
+    e
+    esystem 'qpdf --compress-streams=y --object-streams=generate '\
+            '--recompress-flate --optimize-images --compression-level=9 '+
+            this_file+' compressed_output_'+File.basename(this_file)
+    e
+  end
+
+end
+
+if __FILE__ == $PROGRAM_NAME
+  PdfParadise.compress_via_qpdf(ARGV)
+end # compress_via_qpdf 

data/lib/pdf_paradise/constants/constants.rb

@@ -0,0 +1,76 @@
+#!/usr/bin/ruby -w
+# Encoding: UTF-8
+# frozen_string_literal: true
+# =========================================================================== #
+# require 'pdf_paradise/constants/constants.rb'
+# =========================================================================== #
+module PdfParadise
+
+  # ========================================================================= #
+  # === HOME_DIRECTORY_OF_USER_X
+  # ========================================================================= #
+  if ENV['USERS']
+    HOME_DIRECTORY_OF_USER_X = ENV['USERS'].to_s+'/x/'
+  else
+    HOME_DIRECTORY_OF_USER_X = '/home/x/'
+  end
+
+  # ========================================================================= #
+  # === MAIN_PDF_YAML_FILE
+  # ========================================================================= #
+  MAIN_PDF_YAML_FILE =
+    "#{HOME_DIRECTORY_OF_USER_X}programming/ruby/src/roebe/lib/roebe/yaml/"\
+    "main_pdf.yml"
+
+  # ========================================================================= #
+  # === FILE_ALL_CURRENTLY_OPENED_PDF_FILES
+  # ========================================================================= #
+  FILE_ALL_CURRENTLY_OPENED_PDF_FILES = 
+    '/home/Temp/all_currently_opened_pdf_files.md'
+
+  # ========================================================================= #
+  # === AUTOCONVERT_PDF_FILES_RESIDING_IN_THIS_DIRECTORY
+  # ========================================================================= #
+  AUTOCONVERT_PDF_FILES_RESIDING_IN_THIS_DIRECTORY = '/ingrid/pdf/'
+
+  # ========================================================================= #
+  # === PdfParadise.main_directory?
+  # ========================================================================= #
+  def self.main_directory?
+    AUTOCONVERT_PDF_FILES_RESIDING_IN_THIS_DIRECTORY
+  end
+
+  # ========================================================================= #
+  # === PdfParadise.file_main_pdf_yaml_file?
+  #
+  # This method will return a String such as
+  # '/home/x/programming/ruby/src/roebe/lib/roebe/yaml/main_pdf.yml'.
+  # ========================================================================= #
+  def self.file_main_pdf_yaml_file?
+    MAIN_PDF_YAML_FILE
+  end; self.instance_eval { alias file_pdf_viewer? file_main_pdf_yaml_file? } # === PdfParadise.file_pdf_viewer?
+
+  # ========================================================================= #
+  # === PdfParadise.file_working_on_these_pdf_files
+  #
+  # This method will return a String such as
+  # '/usr/lib/ruby/site_ruby/3.1.0/pdf_paradise/yaml/working_on_these_pdf_files.yml'.
+  # ========================================================================= #
+  def self.file_working_on_these_pdf_files
+    unless ::PdfParadise.respond_to?(:project_base_directory?)
+      require 'pdf_paradise/project/project.rb'
+    end
+    project_base_directory?+
+    'yaml/working_on_these_pdf_files.yml'
+  end
+
+  # ========================================================================= #
+  # === PdfParadise.pdf_viewer?
+  #
+  # Use the default and registered .pdf viewer.
+  # ========================================================================= #
+  def self.pdf_viewer?(i = file_main_pdf_yaml_file?)
+    YAML.load_file(i)
+  end
+
+end

data/lib/pdf_paradise/convert_text_to_pdf.rb

@@ -0,0 +1,94 @@
+#!/usr/bin/ruby -w
+# Encoding: UTF-8
+# frozen_string_literal: true
+# =========================================================================== #
+# === PdfParadise::ConvertTextToPdf
+#
+# Use this class to convert a text file to a .pdf file.
+#
+# Usage examples:
+#   PdfParadise::ConvertTextToPdf.new
+# ============================================================================ #
+require 'pdf_paradise/requires/colours.rb'
+
+module PdfParadise
+
+class ConvertTextToPdf # require 'convert_text_to_pdf'; ConvertTextToPdf.new
+
+  include Colours
+
+  # ========================================================================= #
+  # === FONT_FAMILY
+  # ========================================================================= #
+  FONT_FAMILY = 'Courier'
+
+  # ========================================================================= #
+  # === initialize
+  # ========================================================================= #
+  def initialize(
+      i = nil,
+      run_already = true
+    )
+    set_input(i)
+    reset
+    run if run_already
+  end
+
+  # ========================================================================= #
+  # === reset
+  # ========================================================================= #
+  def reset # reset tag
+    @font_family = FONT_FAMILY
+  end
+
+  # ========================================================================= #
+  # === set_input
+  # ========================================================================= #
+  def set_input(i = '')
+    i = i.first if i.is_a? Array
+    i = i.to_s.dup
+    @input = i
+  end
+
+  # ========================================================================= #
+  # === convert_this_text_file
+  #
+  # Use enscript to created a .ps file, and then ps2pdf
+  # (or ps2pdfwr) to convert to .pdf
+  #
+  # The following script creates a .pdf file with 10 pt
+  # left and right margins, and uses a courier font that
+  # is 7.3 pts wide and 10 pts high, so a 132 col printout
+  # fits on an 8 1/2 X 11 page. Use enscript to setup your
+  # page, fonts, etc.
+  # ========================================================================= #
+  def convert_this_text_file(i = @input)
+    if File.exist? i
+      _ 'enscript -B --margins=10:10: -o outputfile.ps -f '+
+        @font_family+'@7.3/10 '+i 
+      _ 'ps2pdfwr outputfile.ps x.pdf'
+    else
+      e 'Sorry, there is no file at '+i+'.'
+    end
+  end
+
+  # ========================================================================= #
+  # === _
+  # ========================================================================= #
+  def _(i)
+    e i
+    system i
+  end
+
+  # ========================================================================= #
+  # === run
+  # ========================================================================= #
+  def run # (run tag)
+    convert_this_text_file
+  end
+
+end; end
+
+if __FILE__ == $PROGRAM_NAME
+  PdfParadise::ConvertTextToPdf.new(ARGV)
+end # text_to_pdf

data/lib/pdf_paradise/css/project.css

@@ -0,0 +1,17 @@
+button {
+  border: 2px solid black;
+}
+
+.BG_yellow {
+  background-color: yellow;
+}
+
+.BG_floralwhite {
+  background-color: floralwhite;
+}
+
+scrolledwindow {
+  border: 1px solid black;
+  padding: 4px;
+  margin:  4px;
+}

data/lib/pdf_paradise/fpdf/README.md

@@ -0,0 +1,2 @@
+This is a fork of fpdf. The code may not work, though - I mostly added it
+to have this work a bit like an archive.

data/lib/pdf_paradise/fpdf/bookmark.rb

@@ -0,0 +1,129 @@
+#!/usr/bin/ruby -w
+# Encoding: UTF-8
+# frozen_string_literal: true
+# =========================================================================== #
+# Translation of the bookmark class from the PHP FPDF script from Olivier
+# Plathey.
+#
+# Translated by Sylvain Lafleur and ?? with the help of Brian Ollenberger
+#
+# First added in 1.53b
+#
+# Usage is as follows:
+#
+#   require 'fpdf'
+#   require 'bookmark'
+#   pdf = FPDF.new
+#   pdf.extend(PDF_Bookmark)
+#
+# This allows it to be combined with other extensions, such as the Chinese
+# module.
+# =========================================================================== #
+module PDF_Bookmark
+
+  # ========================================================================= #
+  # === PDF_Bookmark.extend_object
+  # ========================================================================= #
+  def self.extend_object(i)
+    i.instance_eval('@outlines,@OutlineRoot=[],0')
+    super(i)
+  end
+
+  # ========================================================================= #
+  # === bookmark
+  # ========================================================================= #
+  def bookmark(txt, level = 0, y = 0)
+    y = self.GetY if y == -1
+    @outlines.push(
+      {
+        't' => txt,
+        'l' => level,
+        'y' => y,
+        'p' => self.PageNo
+      }
+    )
+  end; alias Bookmark bookmark # === Bookmark
+
+  # ========================================================================= #
+  # === putbookmarks
+  # ========================================================================= #
+  def putbookmarks
+    @nb = @outlines.size
+    return if @nb == 0
+    lru=[]
+    level=0
+    @outlines.each_index { |i|
+      o = @outlines[i]
+      if o['l']>0
+        parent=lru[o['l']-1]
+        # Set parent and last pointers
+        @outlines[i]['parent']=parent
+        @outlines[parent]['last']=i
+        if o['l']>level
+          # Level increasing: set first pointer
+          @outlines[parent]['first']=i
+        end
+      else
+        @outlines[i]['parent']=@nb
+      end
+      if o['l']<=level and i>0
+        # Set prev and next pointers
+        prev=lru[o['l']]
+        @outlines[prev]['next']=i
+        @outlines[i]['prev']=prev
+      end
+      lru[o['l']]=i
+      level = o['l']
+    }
+    # Outline items
+    n=@n+1
+    @outlines.each_index do |i|
+      o=@outlines[i]
+      newobj
+      out('<</Title '+(textstring(o['t'])))
+      out('/Parent '+(n+o['parent']).to_s+' 0 R')
+      if o['prev']
+        out('/Prev '+(n+o['prev']).to_s+' 0 R')
+      end
+      if o['next']
+        out('/Next '+(n+o['next']).to_s+' 0 R')
+      end
+      if o['first']
+        out('/First '+(n+o['first']).to_s+' 0 R')
+      end
+      if o['last']
+        out('/Last '+(n+o['last']).to_s+' 0 R')
+      end
+      out(sprintf('/Dest [%d 0 R /XYZ 0 %.2f
+null]',1+2*o['p'],(@h-o['y'])*@k))
+      out('/Count 0>>')
+      out('endobj')
+    end
+    # Outline root
+    newobj
+    @OutlineRoot=@n
+    out('<</Type /Outlines /First '+n.to_s+' 0 R')
+    out('/Last '+(n+lru[0]).to_s+' 0 R>>')
+    out('endobj')
+  end
+
+  # ========================================================================= #
+  # === putresources
+  # ========================================================================= #
+  def putresources
+    super
+    putbookmarks
+  end
+
+  # ========================================================================= #
+  # === putcatalog
+  # ========================================================================= #
+  def putcatalog
+    super
+    if not @outlines.empty?
+      out('/Outlines '+@OutlineRoot.to_s+' 0 R')
+      out('/PageMode /UseOutlines')
+    end
+  end
+
+end