* Add an img plugin, based on Christian Mock's img plugin, but stripped

  down to the bare essentials. Useful for handling large images on websites.

2 files changed, 30 insertions, 0 deletions

diff --git a/doc/logo.mdwn b/doc/logo.mdwn
index 339457d2f..35ec21748 100644
--- a/doc/logo.mdwn
+++ b/doc/logo.mdwn
@@ -26,6 +26,8 @@ added).
   Some other alternate icons and buttons are also included in the svg file
   and can be extracted by specifying their names.
 
+  [[img ikiwiki.png alt="bob" size="200x200"]]
+
   Contributed by Recai Oktaş
 
 * [[ikiwiki_logo|ikiwiki_old.png]] 
diff --git a/doc/plugins/img.mdwn b/doc/plugins/img.mdwn
new file mode 100644
index 000000000..4a92cefc4
--- /dev/null
+++ b/doc/plugins/img.mdwn
@@ -0,0 +1,28 @@
+[[template id=plugin name=img author="Christian Mock"]]
+[[tag type/chrome]]
+
+This is an image handling plugin. While ikiwiki supports inlining full-size
+images by making a [[WikiLink]] that points to the image, using this plugin
+you can easily scale down an image for inclusion onto a page, providing a
+link to a full-size version.
+
+This plugin uses the [ImageMagick](http://www.imagemagick.org/) tools via
+[PerlMagick](http://www.imagemagick.org/www/perl-magick.html).
+
+Note that this is a stripped down version of Christian Mock's
+[[original_img_plugin|contrib/img]].
+
+## usage
+
+	\[[img image1.jpg size="200x200" alt="clouds"]]
+
+Or set default values that will be applied to all later images on the page,
+unless overridden. Useful when including many images on a page.
+
+	\[[img defaults size=200x200 alt="wedding photo"]]
+	\[[img photo1.jpg]]
+	\[[img photo2.jpg]]
+	\[[img photo3.jpg size=200x600]]
+
+The `alt` parameter is optional. The `size` parameter is also optional,
+defaulting to full size.