画像・メディアハンドリング

You can upload and embed other files into DokuWiki 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. Also, please see mime for detailed information.

Uploading new files is done with the MediaPopup called from the クイックボタン.

Just use the uploadform 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 名前空間 in the name these will be created automatically.

Please note: If the wiki administrator enabled アクセスコントロール support upload may be restricted to certain users. User without the proper permission will not see the upload form.

The upload feature appears to be one of the most well hidden features of DokuWiki as in 6 different installations and many visited sites, it has yet to appear, even when all visitors are given all rights! It may work for some, but generally not reliably initiated :(

To improve the performance for the user, DokuWiki 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 the interval specified in the cachetime config option:

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

If PHP is installed with libGD support, resized versions of the embedded images are created on the server– if no GD support is found, it's up to the browser to rescale the images after downloading.

Please note: libGD is often compiled without GIF support because of patent restrictions – GIF images will not be rescaled if no support for them is found.

DokuWiki 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 DokuWiki 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?}}

BTW: You can find buttonmaker webfrontends at

• http://www.yugatech.com/make.php
• http://kalsey.com/tools/buttonmaker/

It is sometimes necessary to remove a media, which was being uploaded before. This manual lacks this information currently (and I don't know how to do it without deleting the files directly from Dokuwiki's directory).

The “Mediafile Selection” window has garbage can icon next to a image. You can use that to delete media.

In the latest version of DokuWiki the garbage can icon does not appear next to the image on the “Mediafile Selection” window. A screenshot would be nice here :)

It depends of your ACL configuration - check FAQ for deleting media files