wiki:TracWikiToPdfPlugin/Doc0.10

0.10 Manual

For now, only those users with WIKI_ADMIN permission can combine wiki pages on one single file. It's possible to define values to title, subtitle, file version and date that are used on the PDF file (the placeholders in the HTML file must be #TITLE#, #SUBJECT#, #VERSAO# and #DATA#).

NEW: Patch #4616 added the definition of a document on a wiki page - there is no need any more to enter a title and select all pages each time you want to create a PDF.
Instructions by mvlcek:

----

Anything between the two horizontal lines will be put on the title page.

The configured title page is not used.

----

In the section all linked pages are added to the document. The links must be in the following format:
 * [wiki:Chapter1]
 * [wiki:Chapter2]
 * [wiki:Chapter3]
 * ...
Everything besides the links is ignored.

WikiToPdf also adds support to some wiki formatting that didn't work with CombineWikiPlugin neither PageToPdfPlugin:

  • Tables (||Table||)
  • Images ([[Image(wiki:Page:image.png)]]) Attention - don't use this format [[Image(image.png)]]
  • Code blocks ({{{ code }}})

ATTENTION: If you want to use a cover file, take care it is encoded in Latin-1 (ISO-8859-1) - otherwise the plugin will fail to use it!

Example

Configurations WikiToPDF in file trac.ini, more information about HTMLDOC (http://www.htmldoc.org/htmldoc.html#CMDREF)

[components]
wikitopdf.* = enabled

[wikitopdf]
# base_dir is the Apache DocumentRoot, It is need to get PDF files with images.
base_dir = /path/to/DocumentRoot

# path to folder used to get a cover files. (key corrected from pathtocover to titlefile)
titlefile = /path/to/cover

# this are parameters functionality PDF links
link = http://servername/trac-project
folder_name = trac-project

[wikitopdf-admin]
# HTMLDOC options. See the link above.
size = A4
right = 1.5cm
left = 1.5cm
top = 1.5cm
bottom = 1.5cm
no-links = None
toctitle = Summary
numbered = None
linkstyle = plain
header = l
footer = .r1
logoimage = /path/to/header-logo.png
# jpeg = 90 # only add when the PDF's generated are too large

[wikitopdf-page]
# HTMLDOC options. See the link above.
size = A4
right = 1.5cm
left = 1.5cm
top = 1.5cm
bottom = 1.5cm
no-links = None
linkstyle = plain
header = l
footer = .r1
logoimage = /path/to/header-logo.png
# jpeg = 90 # only add when the PDF's generated are too large
Last modified 6 years ago Last modified on May 7, 2009, 1:49:31 PM