Version 24 (modified by 11 years ago) (diff) | ,
---|
Contents
PdfImages as PNG in Wiki
Description
Insert vector graphics like PDFs or SVGs as PNG-images into a wikipage or ticket.
Requires convert
from ImageMagick, convert
may fail on specific files. Additionally, Ghostscript is required for convert
on Windows, which is available here.
The handling and the parameters are inspired by LaTeX includegraphics and the trac ImageMacro.
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
. In this case you will get an error like "Can't display foo.pdf, ImageMagick->convert failed with errorcode=... , command=convert ...
" - 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)
Requirements
- Install
convert
from the ImageMagick-suite. - Tested -so far only- on Linux
Tested on this configurations:
OS | trac | imagemagick |
Ubuntu 11.04 | 0.11.7-4 (deb) | 7:6.6.2.6-1ubuntu |
Ubuntu 10.04.4 LTS | 0.12.2 (easy_install) | 7:6.5.7.8-1ubuntu |
Win64 Server 2003 R2 | 0.12.2 (Bitnami) | ImageMagick-6.7.5-6-Q16-windows-x64-dll.exe Ghostscript gs902w64.exe |
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 (resource) | alternatives | comment |
---|---|---|
wiki | JustPageName | Attachment in wikipage |
ticket | #1 | |
source | browser,repos | |
file | need configuration file.prepath
|
Parameters:
Parameter | Value | default | |
---|---|---|---|
pdffile | resource 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 | |
label | anchor to link to | ||
cache | build once or each time | True | time consumption or changing vectorgraphics |
align | left|right | nothing |
Bugs/Feature Requests
Existing bugs and feature requests for PdfImagePlugin are here.
Open Bugs
Ticket | Summary | Component | Type | Status | Priority | Owner | Severity | Reporter |
---|---|---|---|---|---|---|---|---|
#9874 | PdfImg macro runs with 100% cpu load | PdfImagePlugin | enhancement | new | normal | critical | ||
#9875 | calling PdfImg macro for PDF files of many pages takes very long | PdfImagePlugin | enhancement | new | normal | major | ||
#10004 | support of pdf file ressource path for Apache location | PdfImagePlugin | enhancement | new | high | normal | ||
#10358 | Resolution of image after convert is horrid | PdfImagePlugin | defect | assigned | low | minor | ||
#12958 | Rendering issue in ticket when aligning side by side 2 pictures | PdfImagePlugin | defect | new | normal | normal |
If you have any issues, create a new ticket.
Download
Download the zipped source from [download:pdfimageplugin here].
Source
You can check out PdfImagePlugin from here using Subversion, or browse the source with Trac.
Example
[[PdfImg(Book.pdf,width=400,page=100,caption="Page 100 from Book Example")]] [[PdfImg(sketch.svg,cache=False)]] [[PdfImg(OtherPage:foo.pdf)]] [[PdfImg(file:relpath/to/foo.pdf)]]
Configuration
No configuration is needed except to use the Resource 'file:' the following configuration must set:
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:
[pdfimg] file.prepath = /absolute/entry/directory file.preurl = http://example.com/entrydir
Recent Changes
- 11408 by ursaw on 2012-03-21 08:10:12
-
changed external convert command according
ticket:9874#comment:5
- 11356 by ursaw on 2012-03-02 21:13:38
-
#9842 single quotes in convert command are optional under Linux, Windows dont like them..
- 11343 by ursaw on 2012-02-29 19:14:47
-
changed files and folders to lowercase
(more)
Author/Contributors
Attachments (1)
-
PdfImg_screenshot.png (63.1 KB) - added by 12 years ago.
Screenshot with PDF and SVG
Download all attachments as: .zip