Changes between Version 24 and Version 25 of PdfImagePlugin
- Timestamp:
- May 19, 2015, 6:34:02 PM (9 years ago)
Legend:
- Unmodified
- Added
- Removed
- Modified
-
PdfImagePlugin
v24 v25 1 1 [[PageOutline(2-5,Contents,pullout)]] 2 2 3 = !PdfImages as PNG in Wiki =3 = !PdfImages as PNG in Wiki 4 4 5 == Description ==5 == Description 6 6 7 7 Insert vector graphics like PDFs or SVGs as PNG-images into a wikipage or ticket. 8 8 9 10 9 Requires `convert` from [http://www.imagemagick.org ImageMagick], `convert` may fail on specific files. Additionally, Ghostscript is required for `convert` on Windows, which is available [http://pages.cs.wisc.edu/~ghost/doc/GPL/gpl902.htm here]. 11 10 12 11 The handling and the parameters are inspired by LaTeX includegraphics and the trac !ImageMacro. 13 12 … … 19 18 }}} 20 19 21 === Acknowledgement === 22 '''Attention''': PDF conversion with !ImageMagick-`convert`: 20 === Acknowledgement 21 22 '''Note''': PDF conversion with !ImageMagick-`convert`: 23 23 1. may fail on specific PDF s. This is not a problem of the plugin, this is a problem of `convert`. In this case you will get an error like "{{{ Can't display foo.pdf, ImageMagick->convert failed with errorcode=... , command=convert ... }}}" 24 24 2. if not restricted to certain pages, it can take very long; Example: Converting a PDF file of 400 pages by simply {{{ [[PdfImg(test.pdf)]] }}} took several minutes! (see #9874, #9875) 25 25 26 === Requirements 26 27 27 === Requirements ===28 28 * Install `convert` from the [http://www.imagemagick.org ImageMagick]-suite. 29 * Tested -so far only- on Linux29 * Tested on Linux. 30 30 31 31 Tested on this configurations: 32 || '''O S''' || '''trac''' || '''imagemagick''' ||32 || '''Operating System''' || '''Trac''' || '''Imagemagick''' || 33 33 || Ubuntu 11.04 || 0.11.7-4 (deb) || 7:6.6.2.6-1ubuntu || 34 34 || Ubuntu 10.04.4 LTS || 0.12.2 (easy_install) || 7:6.5.7.8-1ubuntu || 35 35 || Win64 Server 2003 R2 || 0.12.2 (Bitnami) || [http://www.imagemagick.org/script/binary-releases.php?ImageMagick=r33s1i1qna69puo410jup92sp2#windows ImageMagick-6.7.5-6-Q16-windows-x64-dll.exe][[BR]][http://pages.cs.wisc.edu/~ghost/doc/GPL/gpl902.htm Ghostscript gs902w64.exe] || 36 36 37 38 === Parameters === 37 === Parameters 39 38 40 Possible trac links for resource:39 Possible Trac links for resource: 41 40 The Location of the file can be an attachment (wikipage, ticket, svn) or a local file (keyword "file:"). 42 ||= trac link (resource) =||= alternatives =||= comment=||41 ||= '''Trac link (resource)''' =||= '''Alternatives''' =||= '''Comment''' =|| 43 42 || wiki || !JustPageName || Attachment in wikipage || 44 43 || ticket || !#1 || || … … 47 46 48 47 Parameters: 49 ||= Parameter =||= Value =||= default =||||48 ||= '''Parameter''' =||= '''Value''' =||= '''Default''' =|| || 50 49 || `pdffile` || resource of PDF-file || || required || 51 50 || page || Page to display || 1 || starting with '''1''' || 52 || width || width in pixel || 600 || must be absolute value||51 || width || width in pixel || 600 || must be absolute value || 53 52 || caption || Caption under Image || ''none'' || || 54 53 || label || anchor to link to || || || 55 54 || || || || || 56 || cache || build once or each time || True || time consumption or changing vectorgraphics||55 || cache || build once or each time || True || time consumption or changing vectorgraphics || 57 56 || align || left|right || nothing || || 58 57 59 60 == Bugs/Feature Requests == 58 == Bugs/Feature Requests 61 59 62 60 Existing bugs and feature requests for PdfImagePlugin are 63 61 [report:9?COMPONENT=PdfImagePlugin here]. 64 62 65 66 === Open Bugs ===67 [[TicketQuery(component=PdfImagePlugin&status!=closed&order=priority,desc=0,format=table,col=summary|component|type|status|priority|owner|severity|reporter)]]68 69 63 If you have any issues, create a 70 64 [http://trac-hacks.org/newticket?component=PdfImagePlugin&owner=ursaw new ticket]. 71 65 72 == Download == 66 [[TicketQuery(component=PdfImagePlugin&group=type,format=progress)]] 67 68 == Download 73 69 74 70 Download the zipped source from [download:pdfimageplugin here]. 75 71 76 == Source ==72 == Source 77 73 78 74 You can check out PdfImagePlugin from [http://trac-hacks.org/svn/pdfimageplugin here] using Subversion, or [source:pdfimageplugin browse the source] with Trac. 79 75 80 == Example == 76 == Example 77 81 78 {{{ 82 79 [[PdfImg(Book.pdf,width=400,page=100,caption="Page 100 from Book Example")]] … … 86 83 }}} 87 84 85 which is then displayed as: 86 88 87 [[Image(PdfImg_screenshot.png)]] 89 88 90 == Configuration == 89 == Configuration 90 91 91 No configuration is needed except to use the Resource 'file:' the following configuration must set: 92 92 93 Assume your server is 93 Assume your server is ''http://example.com'' and the webserver config mapped your local directory `/absolute/entry/directory` to the public directory `entrydir` then your configuration for the ''file:''-resource looks like: 94 94 95 {{{ 96 #!ini 95 {{{#!ini 97 96 [pdfimg] 98 97 file.prepath = /absolute/entry/directory 99 file.preurl 98 file.preurl = http://example.com/entrydir 100 99 }}} 101 100 102 == Recent Changes ==101 == Recent Changes 103 102 104 103 [[ChangeLog(pdfimageplugin, 3)]] 105 104 106 == Author/Contributors ==105 == Author/Contributors 107 106 108 107 '''Author:''' [wiki:ursaw] [[BR]] 109 '''Maintainer:''' [ wiki:ursaw] [[BR]]108 '''Maintainer:''' [[Maintainer]] [[BR]] 110 109 '''Contributors:'''