Changes between Version 9 and Version 10 of PdfImagePlugin

Timestamp:

Feb 29, 2012, 7:31:14 PM (12 years ago)

Author:

ursaw

Comment:

Docu according version 0.0.3

PdfImagePlugin

@@ -5 +5 @@
 == Description ==
 
-Insert PDFs or vectorgraphics like SVGs as PNG-Image into a wikipage. This is somehow an extension of the base Image-Macro.
+Insert PDFs or vector graphics like SVGs as PNG-images into a wikipage or ticket.
     
- 
+Requires `convert` from [http://www.imagemagick.org ImageMagick], `convert` may fail on specific files. 
     
-The handling and the parameters are inspired by LaTeX includegraphics. 
+The handling and the parameters are inspired by LaTeX includegraphics and the trac !ImageMacro. 
 
-The Location of the file can be an attachment (wikipage or ticket) or a local file (keyword "file:").
-Locations in the SVN could lead into authentification Problems.
-External Locations means first downloading the resource. 
+Examples:
+{{{
+[[PdfImg(Book.pdf,width=400,page=100,caption="Page 100 from Book Example")]]
+[[PdfImg(source:testpro/drawing.svg@10,width=600,caption="SVG-image from repository in version 10")]]
+[[PdfImg(ticket:1:file.pdf)]]
+}}}
 
+=== Acknowledgement ===
 '''Attention''' PDF conversion with !ImageMagick-`convert`  may fail on specific PDF s. This is not a problem of the plugin, this is a problem of `convert`.
+
 
 === Requirements ===
  * !Install `convert` from the [http://www.imagemagick.org ImageMagick]-suite.
  * Tested -so far only- on Linux  
- * Tested on Trac version 0.11.7 and 0.12.2
 
-     
+Tested on this configurations:
+|| OS              || trac                  || imagemagick       ||
+|| Ubuntu 11.04    || 0.11.7-4 (deb)        || 7:6.6.2.6-1ubuntu ||
+|| Ubuntu 0.11.7-4 || 0.12.2 (easy_install) || ? ||
+
+
 === Parameters ===
+    
+Possible trac links for resource:
+The Location of the file can be an attachment (wikipage, ticket, svn) or a local file (keyword "file:").
+||= trac link =||= alternatives =||= comment              =||
+|| wiki        ||  !JustPageName || Attachment in wikipage ||
+|| ticket      ||  !#1           ||                        ||
+|| source      ||  browser,repos ||                        ||
+|| file        ||                || need configuration `file.prepath`   ||
+      
+Parameters:
 ||= Parameter =||= Value                 =||= default =||                         || 
 || `pdffile`   || location of PDF-file    ||           || required                ||
-|| page        || Page to display         || 1         || starting with '''1'''   ||
-|| width       || width in pixel          || 600       ||  must be absolute value ||
-|| caption     || Caption under Image     || ''none''  ||                         ||
+|| page        || Page to display         || 1         || starting with '''1'''   ||  
+|| width       || width in pixel          || 600       ||  must be absolute value ||  
+|| caption     || Caption under Image     || ''none''  ||                         ||  
 || label       || anchor to link to       ||           ||                         ||
 || || || || ||
 || cache       || build once or each time || True      ||  time consumption or changing vectorgraphics  ||
 || align       || left|right              || nothing   ||                         ||
+    
+
+
+