Provided by: pdf2htmlex_0.14.6+ds-2build1_amd64 bug


         pdf2htmlEX - converts PDF to HTML without losing text and format.


         pdf2htmlEX [options] <input-filename> [<output-filename>]


       pdf2htmlEX is a utility that converts PDF files to HTML files.

       pdf2htmlEX  tries  its  best  to  render the PDF precisely, maintain proper styling, while
       retaining text and optimizing for Web.

       Fonts are extracted form PDF and then embedded into HTML, text in the converted HTML  file
       is usually selectable and copyable.

       Other objects are rendered as images and also embedded.


       -f, --first-page <num> (Default: 1)
              Specify the first page to process

       -l, --last-page <num> (Default: last page)
              Specify the last page to process

       --zoom <ratio>, --fit-width <width>, --fit-height <height>
              --zoom specifies the zoom factor directly; --fit-width/height specifies the maximum
              width/height of a page, the values are in pixels.

              If multiple values are specified, the minimum one will be used.

              If none is specified, pages will be rendered as 72DPI.

       --use-cropbox <0|1> (Default: 1)
              Use CropBox instead of MediaBox for output.

       --hdpi <dpi>, --vdpi <dpi> (Default: 144)
              Specify the horizontal and vertical DPI for images

       --embed <string>
       --embed-css <0|1> (Default: 1)
       --embed-font <0|1> (Default: 1)
       --embed-image <0|1> (Default: 1)
       --embed-javascript <0|1> (Default: 1)
       --embed-outline <0|1> (Default: 1)
              Specify which elements should be embedded into the output HTML file.

              If switched off, separated files will be generated along with the HTML file for the
              corresponding elements.

              --embed  accepts  a  string  as  argument. Each letter of the string must be one of
              `cCfFiIjJoO`, which corresponds to one of  the  --embed-***  switches.  Lower  case
              letters  for  0 and upper case letters for 1. For example, `--embed cFIJo` means to
              embed everything but CSS files and outlines.

       --split-pages <0|1> (Default: 0)
              If turned on, the content of each page is stored in a separated file.

              This switch is useful if you want pages to be loaded separately & dynamically --  a
              supporting server might be necessary.

              Also see --page-filename.

       --dest-dir <dir> (Default: .)
              Specify destination folder.

       --css-filename <filename> (Default: <none>)
              Specify the filename of the generated css file, if not embedded.

              If it's empty, the file name will be determined automatically.

       --page-filename <filename> (Default: <none>)
              Specify the filename template for pages when --split-pages is 1

              A  %d  placeholder  may be included in `filename` to indicate where the page number
              should be placed. The placeholder supports a limited  subset  of  normal  numerical
              placeholders, including specified width and zero padding.

              If  `filename`  does not contain a placeholder for the page number, the page number
              will be inserted directly before the file extension. If the filename does not  have
              an extension, the page number will be placed at the end of the file name.

              If  --page-filename  is not specified, <input-filename> will be used for the output
              filename, replacing the extension with .page and adding the  page  number  directly
              before the extension.


              pdf2htmlEX --split-pages 1 foo.pdf

                Yields page files,, etc.

              pdf2htmlEX --split-pages 1 foo.pdf --page-filename bar.baz

                Yields page files bar1.baz, bar2.baz, etc.

              pdf2htmlEX --split-pages 1 foo.pdf --page-filename page%dbar.baz

                Yields page files page1bar.baz, page2bar.baz, etc.

              pdf2htmlEX --split-pages 1 foo.pdf --page-filename bar%03d.baz

                Yields page files bar001.baz, bar002.baz, etc.

       --outline-filename <filename> (Default: <none>)
              Specify the filename of the generated outline file, if not embedded.

              If it's empty, the file name will be determined automatically.

       --process-nontext <0|1> (Default: 1)
              Whether to process non-text objects (as images)

       --process-outline <0|1> (Default: 1)
              Whether to show outline in the generated HTML

       --process-annotation <0|1> (Default: 0)
              Whether to show annotation in the generated HTML

       --process-form <0|1> (Default: 0)
              Whether to include text fields and radio buttons in the generated HTML

       --printing <0|1> (Default: 1)
              Enable printing support. Disabling this option may reduce the size of CSS.

       --fallback <0|1> (Default: 0)
              Output  in  fallback  mode,  for better accuracy and browser compatibility, but the
              size becomes larger.

       --tmp-file-size-limit <limit> (Default: -1)
              This limits the total size (in KB) of the temporary files which will also limit the
              total  size of the output file.  This is an estimate and it will stop after a page,
              once the total temporary files size is greater than this number.

              -1 means no limit and is the default.

       --embed-external-font <0|1> (Default: 1)
              Specify whether the local matched fonts, for fonts not embedded in PDF,  should  be
              embedded into HTML.

              If  this switch is off, only font names are exported such that web browsers may try
              to find proper fonts themselves, and that might cause issues about  incorrect  font

       --font-format <format> (Default: woff)
              Specify the format of fonts extracted from the PDF file.

       --decompose-ligature <0|1> (Default: 0)
              Decompose ligatures. For example 'fi' -> 'f''i'.

       --auto-hint <0|1> (Default: 0)
              If set to 1, hints will be generated for the fonts using FontForge.

              This may be preceded by --external-hint-tool.

       --external-hint-tool <tool> (Default: <none>)
              If  specified, the tool will be called in order to enhanced hinting for fonts, this
              will precede --auto-hint.

              The tool will be called as '<tool> <in.suffix> <out.suffix>', where suffix will  be
              the same as specified for --font-format.

       --stretch-narrow-glyph <0|1> (Default: 0)
              If  set  to  1,  glyphs narrower than described in PDF will be stretched; otherwise
              space will be padded to the right of the glyphs

       --squeeze-wide-glyph <0|1> (Default: 1)
              If set to 1, glyphs wider than described in PDF will be squeezed; otherwise it will
              be truncated.

       --override-fstype <0|1> (Default: 0)
              Clear the fstype bits in TTF/OTF fonts.

              Turn  this on if Internet Explorer complains about 'Permission must be Installable'
              AND you have permission to do so.

       --process-type3 <0|1> (Default: 0)
              If turned on, pdf2htmlEX will try to convert Type 3 fonts such  that  text  can  be
              rendered  natively  in HTML.  Otherwise all text with Type 3 fonts will be rendered
              as image.

              This feature is highly experimental.

       --heps <len>, --veps <len> (Default: 1)
              Specify the maximum tolerable horizontal/vertical offset (in pixels).

              pdf2htmlEX would try to optimize the generated HTML file moving  Text  within  this

       --space-threshold <ratio> (Default: 0.125)
              pdf2htmlEX  would  insert  a  whitespace  character ' ' if the distance between two
              consecutive letters in the same line is wider than ratio * font_size.

       --font-size-multiplier <ratio> (Default: 4.0)
              Many web browsers limit the minimum font size, and many would round the given  font
              size, which results in incorrect rendering.

              Specify  a  ratio  greater than 1 would resolve this issue, however it might freeze
              some browsers.

              For some versions of Firefox, however, there will be a problem when the  font  size
              is too large, in which case a smaller value should be specified here.

       --space-as-offset <0|1> (Default: 0)
              If  set  to  1,  space characters will be treated as offsets, which allows a better

              For PDF files  with  bad  encodings,  turning  on  this  option  may  cause  losing

       --tounicode <-1|0|1> (Default: 0)
              A  ToUnicode map may be provided for each font in PDF which indicates the 'meaning'
              of the characters. However often there is  better  "ToUnicode"  info  in  Type  0/1
              fonts,  and sometimes the ToUnicode map provided is wrong.  If this value is set to
              1, the ToUnicode Map is always applied, if provided in PDF, and characters may  not
              render correctly in HTML if there are collisions.

              If  set to -1, a customized map is used such that rendering will be correct in HTML
              (visually the same), but you may not get correct characters  by  select  &  copy  &

              If set to 0, pdf2htmlEX would try its best to balance the two methods above.

       --optimize-text <0|1> (Default: 0)
              If  set  to  1,  pdf2htmlEX will try to reduce the number of HTML elements used for
              text. Turn it off if anything goes wrong.

       --correct-text-visibility <0|1> (Default: 0)
              If set to 1, pdf2htmlEX will try to detect texts  covered  by  other  graphics  and
              properly  arrange  them, i.e. covered texts are made transparent in text layer, and
              are drawn on background layer.

   Background Image
       --bg-format <format> (Default: png)
              Specify the background image format. Run `pdf2htmlEX -v`  to  check  all  supported

       --svg-node-count-limit <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.  This option is only useful  when
              '--bg-format  svg'  is  specified.  Note  that node count in svg is just calculated

       --svg-embed-bitmap <0|1> (Default: 1)
              Whether embed bitmaps in svg background image. 1: embed bitmaps in svg  background;
              0: dump bitmaps to external files if possible.

              This  option is only useful when '--bg-format svg' is specified and '--embed-image'
              is off.

              Currently, RGB or Gray JPEG bitmaps in a PDF can be dumped, while  those  in  other
              formats  or colorspaces are still embedded.  If bitmaps are not dumped as expected,
              try pre-processing your PDF by ghostscript or acrobat and make sure bitmaps  in  it
              are converted to RGB/Gray JPEG format. See the project wiki for more details.

   PDF Protection
       -o, --owner-password <password>
              Specify owner password

       -u, --user-password <password>
              Specify user password

       --no-drm <0|1> (Default: 0)
              Override document DRM settings

              Turn this on only when you have permission.

       --clean-tmp <0|1> (Default: 1)
              If switched off, intermediate files won't be cleaned in the end.

       --data-dir <dir> (Default: /usr/share/pdf2htmlEX)
              Specify the folder holding the manifest and other files (see below for the manifest

       --tmp-dir <dir> (Default: /tmp or $TMPDIR if set)
              Specify the temporary folder to use for temporary files

       --css-draw <0|1> (Default: 0)
              Experimental and unsupported CSS drawing

       --debug <0|1> (Default: 0)
              Print debug information.

       --proof <0|1|2> (Default: 0)
              Output a proof version. If a positive value is specified, texts are drawn  on  both
              text  layer  and  background  image  for  comparison.   If 2 is specified, texts on
              background are in different colors. If png/jpg background format is used, a  higher
              hdpi/vdpi (e.g. 288) is recommended for legibility.

       -v, --version
              Print copyright and version info

       --help Print usage information


       When  split-pages  is  0,  the  manifest  file describes how the final html page should be

       By default, pdf2htmlEX will use the manifest in the default data-dir (run `pdf2htmlEX  -v`
       to check), which gives a simple demo of its syntax.

       You  can  modify  the  default  one,  or  you can create a new one and specify the correct
       data-dir in the command line.

       All files referred by the manifest must be located in the data-dir.


       pdf2htmlEX /path/to/file.pdf
              Convert file.pdf into file.html

       pdf2htmlEX --clean-tmp 0 --debug 1 /path/to/file.pdf
              Convert file.pdf and leave all intermediate files.

       pdf2htmlEX --dest-dir out --embed fi /path/to/file.pdf
              Convert file.pdf into out/file.html and leave font/image files separated.


       Copyright 2012,2013 Lu Wang <>

       pdf2htmlEX is licensed under GPLv3 with additional terms, read LICENSE for details.


       pdf2htmlEX is written by Lu Wang <>


       Home page

       pdf2htmlEX Wiki

                                        pdf2htmlEX 0.14.6                           pdf2htmlEX(1)