Changes between Initial Version and Version 1 of TracWikiToPdfPlugin/Doc0.11

Timestamp:

May 7, 2009, 11:59:39 AM (15 years ago)

Author:

Nickolas Grigoriadis

Comment:

--

TracWikiToPdfPlugin/Doc0.11

@@ +1 @@
+[[TOC(TracWikiToPdfPlugin,TracWikiToPdfPlugin/Doc0.10,TracWikiToPdfPlugin/Doc0.11)]]
+= 0.11 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#).
+
+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! 
+
+== CSS Support ==
+You can get Syntax highlighting when using the experimental HTMLDoc 1.9. [[BR]]
+Just a note: htmldoc version htmldoc-1.9.x-!r1586 has broken headers/footers, version htmldoc-1.9.x-!r1563 works fine. 
+You only need the unstable 1.9 version if you want syntax highlighting and/or css support. 
+{{{
+[wikitopdf]
+css_file = /var/lib/trac/IS/conf/htmldoc.css
+}}}
+
+== Support for Dynamic images ==
+If you want TracWikiToPdfPlugin to handle dynamically generated images, or any images dome by another plugin you need to configure in the trac.ini file:
+{{{
+[wikitopdf]
+tmp_dir = /tmp/wikitopdf
+trac_uri = http://trac.blah.is.co.za
+}}}
+More information is available at #3493.
+
+== 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
+}}}