Learn about DokuWiki
Learn about DokuWiki
Images and other media files can be uploaded and inserted through a simple media manager. To open the media manager click the button in the page editing toolbar. When you like to manage media, but have no need for inserting media links, you can use the fullscreen mediamanager too.
Browse the available namespace by clicking their name in the left pane. Namespaces can be expanded by a click on the + button right next to the namespace name.
To insert an image at the current cursor position in the edit window, just click the file name or image thumbnail in the right pane.
Just use the upload form at the top right to upload a file. Optionally you can give a new name for the file. Be sure to keep the file extension correct! If you use new namespaces in the name these will be created automatically.
Please note: If the administrator enabled ACL support, upload may be restricted to certain users. Users without the proper permission will not see the upload form
First you need to check “file_uploads” on php.ini and verify it is positioned at On.
If you want to upload a file and get a
“Upload denied. This file extension is forbidden!” message, you should change the mime configuration.
If /tmp folder on your server is mounted with the “noexec” option mediamanager fails to upload files. You need to modify the “upload_tmp_dir” on php.ini (globally) or in .htaccess
The screenshot on the right shows the media manager.
The left part has the name space tree (1) where you can navigate through the existing media namespaces. Media namespaces are separated from the page namespaces but usually follow their structure. You can use the + and - icons to collapse and expand deeper hierarchies. Clicking the namespace name will open it in the right side.
Above the tree are some option checkboxes (2) which influence the behavior of the manager. By default the manager will close when an image was selected. Sometimes this is not wanted, eg. if you like to insert multiple images, you can disable the automatic closing here. If you need a better overview in the right pane, you can hide the details for the media listing. Both options are stored in a cookie and will be remembered by your browser.
The top headline of the right pane always shows the currently selected namespace (3). All uploads you do will be put into this namespace.
Below the headline is the upload form (4). Note that this form will only be displayed if you have the needed permissions to upload in the current namespace. You can rename the file you are about to upload with the second text field. To create subnamespaces just prepend them to the name here. Which file extensions may be uploaded is configured through the mime settings. On compatible browsers an icon to activate the multiuploader is shown here as well.
Below the uploadform comes a listing with available mediafiles. For each file there is a line with a file type icon, the file name, and some toolbar buttons (5). The following buttons may be available depending on the file type and your permissions:
|View or download the file|
|Delete the file|
|Edit the metadata of the file (JPEG only)|
The file may be followed by a thumbnail (6) and a preview of the metadata (7). EXIF metadata editing is currently only supported for JPEG files.
When they haven't the UI for adding media, it's probably a permission problem. See the ACL manager please, here you set upload and remove permissions, for media you need to set them for the wanted namespaces.
Creating a new namespace is easy, just prepend your new namespace name to the filename. e.g.
:documents:yourfilenamehere.doc creates new namespace
When you want to create the namespace in your filesystem look for the directory
Remove all content within it and it will be removed for you.
No. By using overwriting you can do the same as by deleting.
When a flat organisation is not enough you can introduce extra namespaces in your current media namespace. It's fine to have media namespaces that don't exist as page namespaces.
At the moment this isn't possible.