NAME

Konstrukt::Plugin::wiki::markup::link::image - Plugin to handle (internal and external) images

SYNOPSIS

See "SYNOPSIS" in Konstrukt::Plugin::wiki::markup::linkplugin.

DESCRIPTION

This one will be responsible for all internal and external image links.

Internal images will be displayed on the page with a default width of 180px. They will link to a page with the full sized image.

External images will just be linked and not displayed unless you define a parameter to show them.

Note that the filename of internal images will be normalized. All characters but letters, numbers, parenthesis and dots will be replaced by underscores.

EXAMPLE

Internal images

inline image: image:foo.jpg
explicit image with alternative text: [[image:foo bar baz|alternative text (default = image name)]]
explicit image with specified width: [[image:foo|200px]]

Parameter reference:
left: align the image on the left side
right: align the image on the right side
center: centered alignment of the image
123px: width in pixels
thumb: alias for 100px width
text at the end: alternative text

Default alignment: No special alignment, but may be overridden by the
template/stylesheet. 

External images (.gif, .jpg, .png)

implicit image: http://foo.bar/baz.gif
explicit image: [[http://foo.bar/baz bar foo.jpg|link text]]
explicit image displayed on the page: [[http://foo.bar/baz bar foo.jpg|embed|link text]]

When an explicit image is displayed using the embed parameter the parameters
available for internal images will also work.

METHODS

matching_regexps()

See "matching_regexps" in Konstrukt::Plugin::wiki::markup::linkplugin for a description.

init

Initialization.

install

Installs the templates.

Parameters:

none

handle()

See "handle" in Konstrukt::Plugin::wiki::markup::linkplugin for a description.

Parameters:

  • $link - The link string.

execute_again

Yep, will return template nodes.

prepare

Won't do anything in the prepare run.

Parameters:

  • $tag - Reference to the tag (and its children) that shall be handled.

execute

Here we will decide which link should be returned in dependence of the existance of the image.

Parameters:

  • $tag - Reference to the tag (and its children) that shall be handled.

AUTHOR

Copyright 2006 Thomas Wittek (mail at gedankenkonstrukt dot de). All rights reserved.

This document is free software. It is distributed under the same terms as Perl itself.

SEE ALSO

Konstrukt::Plugin::wiki