[[PageOutline(2-5,Contents,pullout)]]

= A plugin for exporting Wiki pages as PDFs =

== Description ==

This plugin uses the new content conversion API in Trac's trunk to export Wiki pages to a PDF. The link appears in the '''Download in other formats''' list at the bottom of Wiki pages.

This plugin uses [http://www.htmldoc.org/ htmldoc] to perform the conversion.

'''''Note: The `IContentConverter` API is subject to change until [t:milestone:0.10 0.10] ships.'''''

'''''Note2: The plugin requires at least Trac [t:milestone:0.10 0.10].'''''

See also: CombineWikiPlugin, TracWikiToPdfPlugin.

== Configuration ==

Initial rendering to HTML uses the `default_charset` entry under `[trac]`. This must be set correctly (the default is usually sufficient).

PageToPdfPlugin has relatively sane defaults. However, these can be overridden by the `[pagetopdf]` section of [TracIni trac.ini]. For example, if you are using a recent version of htmldoc you may need to specify the character set manually (see [http://www.htmldoc.org/htmldoc.html#9_2_12 htmldoc supported charset]).

{{{
#!ini
[pagetopdf]
size = A4
charset = iso-8859-15
}}}

All options are passed directly to htmldoc, so refer to its [http://www.htmldoc.org/htmldoc.html#9_2 documentation] for more information.

== Bugs/Feature Requests == 

Existing bugs and feature requests for PageToPdfPlugin are 
[report:9?COMPONENT=PageToPdfPlugin here].

If you have any issues, create a 
[http://trac-hacks.org/newticket?component=PageToPdfPlugin&owner=athomas new ticket].

== Download ==

Download the zipped source from [download:pagetopdfplugin here].

== Source ==

You can check out PageToPdfPlugin from [http://trac-hacks.org/svn/pagetopdfplugin here] using Subversion, or [source:pagetopdfplugin browse the source] with Trac.

== Recent Changes ==

[[ChangeLog(pagetopdfplugin, 3)]]

== Author/Contributors ==

'''Author:''' [wiki:athomas] [[BR]]
'''Maintainer:''' ''none'' [[BR]]
'''Contributors:''' [wiki:tonin]