WKHTMLTOPDF(1)						      General Commands Manual						    WKHTMLTOPDF(1)

Name
       wkhtmltopdf - html to pdf converter

Synopsis
	 wkhtmltopdf [OPTIONS]... <input file> [More input files] <output file>

Description
       Converts one or more HTML pages into a PDF document, not using wkhtmltopdf patched qt.

General Options
	   --allow <path>
	      Allow the file or files from the specified folder to be loaded (repeatable)
	   --collate
	      Collate when printing multiple copies
	   --cookie <name> <value>
	      Set an additional cookie (repeatable)
	   --cookie-jar <path>
	      Read and write cookies from and to the supplied cookie jar file
	   --copies <number>
	      Number of copies to print into the pdf file
	   --custom-header <name> <value>
	      Set an additional HTTP header (repeatable)
	   --debug-javascript
	      Show javascript debugging output
       -n, --disable-javascript
	      Do not allow web pages to run javascript
	   --disallow-local-file-access
	      Do not allowed conversion of a local file to read in other local files, unless explecitily allowed with --allow
       -d, --dpi <dpi>
	      Change the dpi explicitly (this has no effect on X11 based systems)
	   --enable-plugins
	      Enable installed plugins (such as flash
	   --encoding <encoding>
	      Set the default text encoding, for input
	   --extended-help
	      Display more extensive help, detailing less common command switches
       -g, --grayscale
	      PDF will be generated in grayscale
       -h, --help
	      Display help
	   --htmldoc
	      Output program html help
	   --ignore-load-errors
	      Ignore pages that claimes to have encountered an error during loading
       -l, --lowquality
	      Generates lower quality pdf/ps. Useful to shrink the result document space
	   --manpage
	      Output program man page
       -B, --margin-bottom <unitreal>
	      Set the page bottom margin (default 10mm)
       -L, --margin-left <unitreal>
	      Set the page left margin (default 10mm)
       -R, --margin-right <unitreal>
	      Set the page right margin (default 10mm)
       -T, --margin-top <unitreal>
	      Set the page top margin (default 10mm)
	   --minimum-font-size <int>
	      Minimum font size
	   --no-background
	      Do not print background
       -O, --orientation <orientation>
	      Set orientation to Landscape or Portrait
	   --page-height <unitreal>
	      Page height (default unit millimeter)
       -s, --page-size <size>
	      Set paper size to: A4, Letter, etc.
	   --page-width <unitreal>
	      Page width  (default unit millimeter)
	   --password <password>
	      HTTP Authentication password
	   --post <name> <value>
	      Add an additional post field (repeatable)
	   --post-file <name> <path>
	      Post an additional file (repeatable)
       -p, --proxy <proxy>
	      Use a proxy
       -q, --quiet
	      Be less verbose
	   --read-args-from-stdin
	      Read command line arguments from stdin
	   --readme
	      Output program readme
	   --redirect-delay <msec>
	      Wait some milliseconds for js-redirects
	   --stop-slow-scripts
	      Stop slow running javascripts
	   --title <text>
	      The title of the generated pdf file (The title of the first document is used if not specified)
	   --user-style-sheet <url>
	      Specify a user style sheet, to load with every page
	   --username <username>
	      HTTP Authentication username
       -V, --version
	      Output version information an exit
	   --zoom <float>
	      Use this zoom factor

Reduced Functionality
       This version of wkhtmltopdf has been compiled against a version of QT without the wkhtmltopdf patches. Therefore some features are missing,
       if you need these features please use the static version.

       Currently the list of features only supported with patch QT includes:

	* Printing more then one HTML document into a PDF file.
	* Running without an X11 server.
	* Adding a document outline to the PDF file.
	* Adding headers and footers to the PDF file.
	* Generating a table of contents.
	* Adding links in the generated PDF file.
	* Printing using the screen media-type.
	* Disabling the smart shrink feature of webkit.

Page sizes
       The default page size of the rendered document is A4, but using this --page-size optionthis can be changed to almost  anything  else,  such
       as: A3, Letter and Legal.  For a full list of supported pages sizes please see <http://doc.trolltech.com/4.6/qprinter.html#PageSize-enum>.

       For a more fine grained control over the page size the --page-height and --page-width options may be used

Reading arguments from stdin
       If  you	need  to  convert  a  lot  of  pages  in  a batch, and you feel that wkhtmltopdf is a bit to slow to start up, then you should try
       --read-args-from-stdin,

       When --read-args-from-stdin each line of input sent to wkhtmltopdf on stdin will act as a separate  invocation  of  wkhtmltopdf,  with  the
       arguments specified on the given line combined with the arguments given to wkhtmltopdf

       For example one could do the following:

	 echo "http://doc.trolltech.com/4.5/qapplication.html qapplication.pdf" >> cmds
	 echo "--cover google.com http://en.wikipedia.org/wiki/Qt_(toolkit) qt.pdf" >> cmds
	 wkhtmltopdf --read-args-from-stdin --book < cmds

Page Breaking
       The  current  page  breaking algorithm of WebKit leaves much to be desired. Basically webkit will render everything into one long page, and
       then cut it up into pages. This means that if you have two columns of text where one is vertically shifted by half a line. Then webkit will
       cut a line into to pieces display the top half on one page. And the bottom half on another page. It will also break image in two and so on.
       If you are using the patched version of QT you can use the CSS page-break-inside property to remedy this somewhat. There is no  easy  solu-
       tion  to  this  problem, until this is solved try organising your HTML documents such that it contains many lines on which pages can be cut
       cleanly.

       See   also:   <http://code.google.com/p/wkhtmltopdf/issues/detail?id=9>,   <http://code.google.com/p/wkhtmltopdf/issues/detail?id=33>   and
       <http://code.google.com/p/wkhtmltopdf/issues/detail?id=57>.

Contact
       If  you	experience  bugs  or want to request new features please visit <http://code.google.com/p/wkhtmltopdf/issues/list>, if you have any
       problems or comments please feel free to contact me: see <http://www.madalgo.au.dk/~jakobt/#about>

Authors
       Written by Jakob Truelsen. Patches by Mario Silva, Benoit Garret and Emmanuel Bouthenot.

								 2009 February 23						    WKHTMLTOPDF(1)