aboutsummaryrefslogtreecommitdiff
path: root/doc/ikiwiki
diff options
context:
space:
mode:
authorchrysn <chrysn@fsfe.org>2014-04-07 11:32:25 +0200
committerchrysn <chrysn@fsfe.org>2014-04-07 11:32:25 +0200
commitbcc209eb5acd26e3751c5869cd5c1ebe66b0bf03 (patch)
tree470783bccc4d9e366b770c51506dced57866dfbb /doc/ikiwiki
parent6cc43773e728df783e29389680e6bf50d3ef6592 (diff)
downloadikiwiki-bcc209eb5acd26e3751c5869cd5c1ebe66b0bf03.tar
ikiwiki-bcc209eb5acd26e3751c5869cd5c1ebe66b0bf03.tar.gz
add pagenumber parameter
this allows picking a page from a pdf. also, this enhances performance greatly when rendering pdfs, as only the first page is rasterized. (otherwise, imagemagick would treat the pdf as a list of images, work with all of them, until finally only the first page gets saved). the default parameter of 0 will select the single image contained in typical image files anyway, so no specialcasing between single- and multifile containers is needed.
Diffstat (limited to 'doc/ikiwiki')
-rw-r--r--doc/ikiwiki/directive/img.mdwn3
1 files changed, 3 insertions, 0 deletions
diff --git a/doc/ikiwiki/directive/img.mdwn b/doc/ikiwiki/directive/img.mdwn
index cda62b58f..08d158987 100644
--- a/doc/ikiwiki/directive/img.mdwn
+++ b/doc/ikiwiki/directive/img.mdwn
@@ -28,6 +28,9 @@ to the full size version. By default it does; set "link=somepage" to link
to another page instead, or "link=no" to disable the link, or
"link=http://url" to link to a given url.
+The `pagenumber` parameter selects which of multiple images should be rendered;
+this is relevant mainly for GIF and PDF source images.
+
You can also set default values that will be applied to all later images on
the page, unless overridden. Useful when including many images on a page.