GenPDFWebkitPlugin

This plugin generates PDF using the Webkit rendering engine.

Usage

Get a PDF by adding contenttype=application/pdf to the view url like this:

%SCRIPTURL{"view"}/%WEB%/%TOPIC%?contenttype=application/pdf

Here's the complete Foswiki documentation in PDF.

Installation

This extension comes with a static wkhtmltopdf binary version 0.9.1 for linux in your foswiki's tools directory. If you run on a different platform you will have to download it from http://code.google.com/p/wkhtmltopdf/.

You do not need to install anything in the browser to use this extension. The following instructions are for the administrator who installs the extension on the server.

Open configure, and open the "Extensions" section. Use "Find More Extensions" to get a list of available extensions. Select "Install".

If you have any problems, or if the extension isn't available in configure, then you can still install manually from the command-line. See http://foswiki.org/Support/ManuallyInstallingExtensions for more help.

Known issues

as of wkhtmltopdf-0.9.1

• anchors still don't work: acroread throws a security exception

as of wkhtmltopdf-0.8.3

• links don't work even local #anchors don't do it; they are only drawn viually; bug report
• the <base href="... /> html header must occur before any other js or css files in the html source; relative urls before are not resolved correctly (this is a general webkit problem – not a wkhtmltopdf issue)
• there's no way to provide a base url on the command-line if a <base ...> tag is missing in the html source
• a couple of important css3 features are not implemented yet, e.g. ::after, ::before, leader(), target-counter(), @page, string-set, title, chapter, hyphens

Plugin Info

Author:	Foswiki:Main.MichaelDaum
Copyright:	© 2009-2010, Michael Daum http://michaeldaumconsulting.com
License:	GPL (GNU General Public License)
Release:	1.00
Version:	5547 (2009-11-17)
Change History:
12 Feb 2010	upgraded to wkhtml-0.9.1
17 Nov 2009	fixed use of uninitialized value
09 Sep 2009	initial release
Home:	Foswiki:Extensions/GenPDFWebkitPlugin
Support:	Foswiki:Support/GenPDFWebkitPlugin