Gallery Plugin Usage Guide

The most common way is to specify a media namespace to display all images in that namespace:

{{gallery>:wiki:pagename?150x150&lightbox&showtitle}}

Syntax Explanation:

• `:wiki:pagename` - Specify the media namespace (note: colon `:` must be in front of the namespace)
• `150×150` - Thumbnail size (width x height, in pixels)
• `lightbox` - Enable lightbox effect (click thumbnail to view full-size image)
• `showtitle` - Show image title (if EXIF data is available)

You can also specify a single image file:

{{gallery>:wiki:pagename:imagename.jpg?150x150&lightbox}}

If you need to manually specify a list of images, use the following syntax:

<gallery 150x150&lightbox>
:wiki:pagename:image1.jpg
:wiki:pagename:image2.jpg
https://example.com/external_image.jpg
</gallery>

• Important Note: Media files are shared across all language versions. You do NOT need to create separate folders for each language version. All language versions share the same image folder.
• Click “Media Manager” in the navigation bar
• In the left tree structure, click the root directory `[Root]` to expand
• Find and expand the `wiki` folder (Note: not `en:wiki` or `zh:wiki`, but `wiki` under the root directory)
• Find or create a folder named after your page (e.g., `新车间_xinchejian`) under the `wiki` folder
• Click into that folder
• Upload image files
• Uploaded images will automatically appear in the gallery (both Chinese and English versions will display them)

• Folder names should match the page name
• For example: if the page is `en:wiki:xinchejian`, the media folder should be `wiki:新车间_xinchejian`
• Image file names should use lowercase letters, numbers, and underscores; avoid spaces and special characters

• `150×150` - Thumbnail size (default)
• `200×200` - Larger thumbnails
• `100×100` - Smaller thumbnails
• Note: Use lowercase `x`, e.g., `150×150`

• `full` - Full-width responsive layout (default, recommended)
• `center` - Center-aligned
• `left` - Left-aligned
• `right` - Right-aligned

• `lightbox` - Enable lightbox effect (enabled by default)
• `nocrop` - Don't crop, maintain original image aspect ratio
• `crop` - Crop thumbnails to match specified size
• `showtitle` - Show image title
• `showname` - Show filename
• `nocache` - Disable caching (not recommended, only for debugging)

{{gallery>:wiki:新车间_xinchejian?150x150&lightbox&showtitle}}

Displays all images in the `wiki:新车间_xinchejian` namespace with 150×150 thumbnails, lightbox enabled, and titles shown.

{{gallery>:wiki:pagename?200x200&center&nocrop&lightbox}}

Displays 200×200 thumbnails, center-aligned, no cropping, with lightbox enabled.

{{gallery>:wiki:pagename?150x150&=5&lightbox}}

Shows only the first 5 images.

• Gallery output is cached by default. If you upload new images but they don't appear, you need to clear the page cache or wait for the cache to expire
• Image files should be uploaded to the Media Manager, not the page directory
• Media files are shared; all language versions share the same image folder
• Recommended image formats: JPEG, PNG, or GIF
• Image file names should follow valid DokuWiki page name format (lowercase letters, numbers, underscores)

• Check if images are uploaded to the correct media namespace
• Check if the namespace path is correct (note: colon `:` must be in front of the namespace)
• Clear page cache: add `&purge=true` to the page URL

• Confirm there are image files in the media namespace
• Check if image file formats are supported (JPEG, PNG, GIF)
• Check if file permissions are correct

• Check if `lightbox` option is enabled
• Clear browser cache
• Check for JavaScript errors