Differences

This shows you the differences between two versions of the page.

--- images [2020-11-22 03:04] – [Linking from non-DokuWiki syntax] Fred23
+++ images [2023-11-09 12:45] (current) – Added a note about spaces preceding the title marker | causing issues in dw2pdf generated PDFs 80.209.162.130
@@ Line 1: / Line 1: @@
+====== Image and Media Handling ======
+You can upload and embed other files into [[DokuWiki]] pages with the [[wiki:syntax#images_and_other_files|Image Syntax]]. While images, audio and [[video]] media are [[wiki:syntax#supported_media_formats|displayed right]] on the page, other files (such as PDF documents) are just linked to from the document. Please see [[mime]] for detailed information.
+===== Uploading =====
+{{:wiki:mediamanager.png?200 |The Media Manager popup}}
+Uploading new files is done with the [[media manager|media manager popup]] called by button {{https://www.dokuwiki.org/lib/images/toolbar/image.png}} of the [[toolbar]] of the [[Edit window]].
+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.
+The [[fullscreen mediamanager|fullscreen media manager]] lets you also upload images and [[video|videos]]. Besides it can show media revisions and edit the image metadata as well.
+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.
+===== Embedding =====
+Use ''{{}}'' to embed your media
+  {{wiki:dokuwiki-128.png}}
+  {{wiki:text2html.rc}}
+An image {{wiki:dokuwiki-128.png?30}} is displayed and other media {{wiki:text2html.rc}} shows only a link with matching icon.
+You may use ''|'' to add a title to your image
+  {{wiki:dokuwiki-128.png|The logo of DokuWiki}}
+{{wiki:dokuwiki-128.png?30|The logo of DokuWiki}} Try hovering over the image for showing the title as a tooltip.
+//When adding a title you should not have a space before the ''|'' character.  Doing so may lead to the creation of random links in the preceding text when exporting the page to pdf using the DW2PDF plugin.//
+How images are embedded can be influenced by various parameters. Parameters are added in URL style by appending a question mark (''?'') and separating multiple parameters by an ampersand (''&'').
+=====Alignment=====
+By using left or right whitespaces you can choose left, right or center alignment.
+{{ wiki:dokuwiki-128.png}}
+{{wiki:dokuwiki-128.png }}
+{{ wiki:dokuwiki-128.png }}
+  {{ wiki:dokuwiki-128.png}}
+  {{wiki:dokuwiki-128.png }}
+  {{ wiki:dokuwiki-128.png }}
+===== Resizing =====
+DokuWiki can rescale images with two methods. By default it uses PHP's libGD support if installed. Better results can be achieved with the [[config:im_convert|imagemagick]] command line tool.
+When using libGD, resizing can fail when not enough memory is available or the image format is not supported by the installed libGD version.
+For resizing external images, they need to be cached at your server. To do that, you have to allow DokuWiki to download external files by increasing the size restriction in the [[config:fetchsize]] option.
+To scale an image proportionally, give the wanted width in pixels:
+  {{wiki:dokuwiki-128.png?20}}
+{{wiki:dokuwiki-128.png?20 }} This image is scaled down to a width of 20 pixels.
+Or to scale an image proportionally in height, give the wanted height in Pixels, preceeded by a width of 0:
+  {{wiki:dokuwiki-128.png?0x20}}
+{{wiki:dokuwiki-128.png?0x20 }} This image is scaled down to a height of 20 pixels.
+When you give the width and height, DokuWiki will crop the image before scaling to avoid distorting the image:
+  {{wiki:dokuwiki-128.png?20x50}}
+{{wiki:dokuwiki-128.png?20x50 }} This image is scaled to a width of 20 pixels and a height of 50 pixels.
@@ Line 41: / Line 115: @@
+==== Linking from non-DokuWiki syntax ====
+This would be useful for example when you are using the ''%%<HTML>%%'' tags to enhance visual aspects in your page, wanting to have a ''<DIV>'' background image from the DokuWiki media storage.
+Basically you just copy the code generated by DokuWiki, but __you can't use resizing__. The generated URL generally has three parameters; ''media'', ''w'' and ''tok'', and resizing with ''w'' (defining the desired width of the image) does not work unless ''tok'' parameter is also given. In other words, you can only give ''media'' URL parameter.
+While you could copy the ''tok'' from generated code and use the URL in your HTML, it would break as soon as the image in question is replaced with updated content, for example.
+Example:
+<code>
+DIV.personal_info {
+  ...
+  background-image:  url('{/install_dir}/lib/exe/fetch.php?media=name:space:mypic.png');
+}
+</code>
 ===== Dynamic Images =====
@@ Line 83: / Line 173: @@
 To link images to other resources, simply pipe that link into the image, as you would with any other text.
-Example:  [[http://www.google.com|{{wiki:dokuwiki-128.png}}]]
+Example: [[http://www.google.com|{{wiki:dokuwiki-128.png}}]]
-  Example:  [[http://www.google.com|{{wiki:dokuwiki-128.png}}]]
+  Example: [[http://www.google.com|{{wiki:dokuwiki-128.png}}]]