Image- and Mediahandling

You can upload and embed other files into the Wiki pages with the Image Syntax. While images and flash media are displayed right on the page, other files (such as PDF documents) are just linked to from the document.

Uploading new files is done with the MediaPopup called from the toolbar.

Just use the upload form on the lower right to upload a file. Optionally you can give a new name for the file. Be sure to keep the fileextension correct! If you use new namespaces in the name these will be created automatically.

Please note: Upload may be restricted to certain users. Users without the proper permission will not see the upload form.

To improve the performance for the user, the Wiki tries to cache external images. If you want to use an external image without caching you can add the nocache parameter like this.

{{http://de3.php.net/images/php.gif?nocache}}

You can combine this parameter with resizing, too.

{{http://de3.php.net/images/php.gif?300x50&nocache}}

Hitting an external Server on every pageload isn't very polite. Instead you can use the parameter recache to let DokuWiki to recache the image using a predefined interval (1 day):

{{http://de3.php.net/images/php.gif?recache}}

The Wiki allows you to put images in a page and have them link to a page providing details about the image or to a page that contains the full image. It also allows you to include images that do not link to any other page.

By default, clicking on an image brings up a “detail” page. The detail page is rendered by the detail.php template file. The standard detail.php file shows a larger version of the image along with a listing of EXIF and IPTC metadata contained within the the image (such as caption, author, date taken, etc.), along with other descriptive information.

The following syntax embeds an image in the page at full size, and clicking on this image produces a detail page providing metadata for the image:

{{wiki:dokuwiki-128.png}}

Try clicking on this scaled-down image to see its detail page.

You may click on the image shown on the details page to get yet another page the contains only the image, shown at its actual size. Often you'll embed the image on a page at a small size and show the image on a detail page at a medium size, so that only this final direct link provides the image at its full size.

You may instead embed an image on a page such that clicking on it brings you directly to the full image in its own page. This is called a “direct” link, and it's indicated by appending the direct option to the image:

{{wiki:dokuwiki-128.png?direct}}

Try clicking on this scaled-down image to see its direct page.

It is also possible to embed an image in the page without having the image link to any other page. You accomplish this with the nolink option, as follows:

{{wiki:dokuwiki-128.png?nolink}}

Try clicking on this image. Couldn't do it, huh?

Sometimes you may want to embed a dynamic image like this one

Using the usual method:

{{http://www.cowpimp.com/ButtonMaker/button.php?barPosition=50&leftText=Dynamic&leftTextColor=ffffff&rightText=IMG&rightTextPosition=54}}

doesn't work:

button.php

This is because the Wiki assumes an image ends with .gif,.jpg or .png but this file ends with .php. The trick is to append an additonal CGI parameter like this: &.png – the CGI will ignore this unknown parameter but DokuWiki will think it's an image.

You also need to add a questionmark at the very end or DokuWiki will think the CGI params are caching options.

{{http://www.cowpimp.com/ButtonMaker/button.php?barPosition=50&leftText=Dynamic&leftTextColor=ffffff&rightText=IMG&rightTextPosition=54&.png?}}

It is sometimes necessary to remove a media, which was being uploaded before. Please contact admin@diynot.com before doing this.