pdf2htmlEX/pdf2htmlEX.1.in

.TH pdf2htmlEX 1 "pdf2htmlEX @PDF2HTMLEX_VERSION@"
.SH NAME
.PP
.nf
  pdf2htmlEX \- converts PDF to HTML without losing text and format.
.fi

.SH USAGE
.PP
.nf
  pdf2htmlEX [options] <input\-filename> [<output\-filename>]
.fi

.SH DESCRIPTION
.PP
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 (Type 3 fonts are not supported). Text in the converted HTML file is usually selectable and copyable. 

Other objects are rendered as images and also embedded.

.SH OPTIONS

.SS Pages

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

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

.SS Dimensions

.TP
.B --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.

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

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


.SS Output 

.B --embed <string>
.br
.B --embed-css <0|1> (Default: 1)
.br
.B --embed-font <0|1> (Default: 1)
.br
.B --embed-image <0|1> (Default: 1)
.br
.B --embed-javascript <0|1> (Default: 1)
.br
.B --embed-outline <0|1> (Default: 1)
.RS
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.
.RE
.TP
.B --split-pages <0|1> (Default: 0)
If turned on, the content of each page is stored in a separated file.

--page-filename may be used to specify the format for the filenames for individual pages. A %d placeholder may be included 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 --page-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.

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

.B Examples

.B pdf2htmlEX --split-pages 1 foo.pdf

  Yields page files foo1.page, foo2.page, etc.

.B pdf2htmlEX --split-pages 1 foo.pdf bar.baz

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

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

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

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

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

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

.TP
.B --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.

.TP
.B --page-filename <filename> (Default: <none>)
Specify the filename template for pages. This is only useful when --split-pages is 1

If it's empty, a default one will be used, see description of --split-pages

.TP
.B --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.

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

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

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

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

.SS Fonts

.TP
.B --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 metrics.

.TP
.B --font-suffix <suffix> (Default: .ttf)
Specify the suffix of fonts extracted from the PDF file.

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

.TP
.B --remove-unused-glyph <0|1> (Default: 0)
If set to 1, remove unused glyphs in embedded fonts in order to reduce the file size.

Currently this option is experimental, turning it on may cause segmentation fault or debris-like fonts.

.TP
.B --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.

.TP
.B --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-suffix.

.TP
.B --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

.TP
.B --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.

.SS Text

.TP
.B --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 distance.

.TP
.B --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.

.TP
.B --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.

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

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

.TP
.B --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 & paste.

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

.TP
.B --optimize-text <0|1> (Deafult: 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.

.SS PDF Protection

.TP
.B -o, --owner-password <password>
Specify owner password

.TP
.B -u, --user-password <password>
Specify user password

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

.SS Misc.

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

.TP
.B --data-dir <dir> (Default: @CMAKE_INSTALL_PREFIX@/share/pdf2htmlEX)
Specify the folder holding the manifest and other files (see below for the manifest file)`

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

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

.SS Meta

.TP
.B -v, --version
Print copyright and version info

.TP
.B --help
Print usage information

.SH MANIFEST and DATA-DIR
When split-pages is 0, the manifest file describes how the final html page should be generated.

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. 

When single-html is 1, all files referred by the manifest must be located in the data-dir.

.SH EXAMPLE
.TP
.B pdf2htmlEX /path/to/file.pdf
Convert file.pdf into file.html
.TP
.B pdf2htmlEX --clean-tmp 0 --debug 1 /path/to/file.pdf
Convert file.pdf and leave all intermediate files.
.TP
.B pdf2htmlEX --dest-dir out --single-html 0 /path/to/file.pdf
Convert file.pdf into out/file.html and leave font/image files separated.

.SH COPYRIGHT
.PP
Copyright 2012,2013 Lu Wang <coolwanglu@gmail.com>

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

.SH AUTHOR
.PP
pdf2htmlEX is written by Lu Wang <coolwanglu@gmail.com>

.SH SEE ALSO
.TP
Home page
https://github.com/coolwanglu/pdf2htmlEX
.TP
pdf2htmlEX Wiki
https://github.com/coolwanglu/pdf2htmlEX/wiki