DokuWiki

It's better when it's simple

User Tools

Site Tools


images

Differences

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

Link to this comparison view

Both sides previous revisionPrevious revision
Next revision
Previous revision
images [2017-03-02 02:55] – old revision restored (2016-04-22 13:15) bactramimages [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 ====== ====== 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.+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 =====
  
-====Uploading==== 
 {{:wiki:mediamanager.png?200 |The Media Manager popup}} {{:wiki:mediamanager.png?200 |The Media Manager popup}}
  
-{{http://wiki.splitbrain.org/lib/images/toolbar/image.png}} Uploading new files is done with the [[media manager|media manager popup]] called from the [[toolbar]] of the [[Edit window]]. +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. 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. Besides it can show media revisions and edit the image metadata as well.+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. 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====+===== Embedding ====
 Use ''{{}}'' to embed your media Use ''{{}}'' to embed your media
  
   {{wiki:dokuwiki-128.png}}   {{wiki:dokuwiki-128.png}}
   {{wiki:text2html.rc}}   {{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. An image {{wiki:dokuwiki-128.png?30}} is displayed and other media {{wiki:text2html.rc}} shows only a link with matching icon.
  
Line 29: Line 30:
 {{wiki:dokuwiki-128.png?30|The logo of DokuWiki}} Try hovering over the image for showing the title as a tooltip. {{wiki:dokuwiki-128.png?30|The logo of DokuWiki}} Try hovering over the image for showing the title as a tooltip.
  
-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 (&).+//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===== =====Alignment=====
Line 65: Line 69:
 {{wiki:dokuwiki-128.png?0x20 }} This image is scaled down to a height of 20 pixels. {{wiki:dokuwiki-128.png?0x20 }} This image is scaled down to a height of 20 pixels.
  
-When you give the width and height, the image will be scaled to exactly that height, ignoring the aspect ratio:+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}}
Line 71: Line 75:
 {{wiki:dokuwiki-128.png?20x50 }} This image is scaled to a width of 20 pixels and a height of 50 pixels. {{wiki:dokuwiki-128.png?20x50 }} This image is scaled to a width of 20 pixels and a height of 50 pixels.
  
-In DokuWiki 2009-02-14 or later, giving both width and height will crop the image before scaling to avoid distorting the image. 
  
 ===== Linking ===== ===== Linking =====
Line 128: Line 131:
 } }
 </code> </code>
 +
 ===== Dynamic Images ===== ===== Dynamic Images =====
  
Line 169: Line 173:
 To link images to other resources, simply pipe that link into the image, as you would with any other text. 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}}]]
  
  
images.1488419722.txt.gz · Last modified: 2017-03-02 02:55 by bactram

Except where otherwise noted, content on this wiki is licensed under the following license: CC Attribution-Share Alike 4.0 International
CC Attribution-Share Alike 4.0 International Donate Powered by PHP Valid HTML5 Valid CSS Driven by DokuWiki