Table of Contents

How to Upload an Image To This Wiki



Step 1: Upload Your Image

Navigate to the page where you want to add the image.

Click the “Edit this page” button (a pencil) to enter editing mode.

Click your cursor where you want the image to appear.

Click the “Add images and other files” button in the toolbar (looks like a picture icon).

In the media manager pop-up:

Click the “Select files” button at the top right.

Choose the image file from your computer.

Click “Upload”.

Wait for the upload to complete. The image should now be listed in the media manager.

Step 2: Insert the Image

In the media manager:

Select the newly uploaded image.

Choose the desired link target:

Direct link: Opens the image in full size in a new window.

Detail page: Opens a page showing the image and its details (EXIF data, etc.).

No link: The image is simply displayed, not clickable.

Set the desired alignment (left, center, right) and image size if needed.

Click “Insert”.

Syntax for Embedding the Image

The media manager will automatically insert the correct syntax into your page's text. It will look something like this:

 {{ :namespace:imagename.jpg?200 | Description of the image }} 

namespace: The directory where the image is stored (optional if in the main media folder).

imagename.jpg: The name of your image file.

?200: Optional parameter to specify image width in pixels.


Alternative Syntax:

You can also manually write the image syntax:

{{imagename.jpg}}               <- Default size

{{imagename.jpg?200}}           <- 200 pixels wide

{{imagename.jpg?200x150}}       <- 200 pixels wide, 150 pixels high

{{ :namespace:imagename.jpg }}  <- Image in a namespace


Tips and Considerations:

Image Names: Use descriptive and meaningful names for your images. Avoid spaces and special characters, use hyphens or underscores instead.

Image Formats: DokuWiki supports JPEG, PNG, and GIF formats.

Image Size: For web display, optimize your images to reduce file size without sacrificing quality.

Image Descriptions: Provide descriptive text (alt text) for accessibility and SEO purposes.