wiki:syntax

Differences

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

Link to this comparison view

Both sides previous revision Previous revision
wiki:syntax [2014/10/03 00:38] – [Basic Text Formatting] rsimoeswiki:syntax [2017/06/28 18:06] (current) – external edit 127.0.0.1
Line 5: Line 5:
 ===== Basic Text Formatting ===== ===== Basic Text Formatting =====
  
 +DokuWiki supports **bold**, //italic//, __underlined__ and ''monospaced'' texts. Of course you can **__//''combine''//__** all these.
  
-DokuWiki supports **bold**, //italic//, __underlined__ and ''monospaced'' texts. Of course you can **__//''combine'' //__**all these. +  DokuWiki supports **bold**, //italic//, __underlined__ and ''monospaced'' texts. 
-<code> +  Of course you can **__//''combine''//__** all these.
-DokuWiki supports **bold**, //italic//, __underlined__ and ''monospaced'' texts. +
-Of course you can **__//''combine''//__** all these. +
-</code>+
  
 +You can use <sub>subscript</sub> and <sup>superscript</sup>, too.
  
-You can use <sub>subscript</sub>and <sup>superscript</sup> , too. +  You can use <sub>subscript</sub> and <sup>superscript</sup>, too.
- +
- +
-<code> +
-You can use <sub>subscript</sub> and <sup>superscript</sup> , too. +
-</code> +
  
 You can mark something as <del>deleted</del> as well. You can mark something as <del>deleted</del> as well.
-<code> 
-You can mark something as <del>deleted</del>  as well. 
-</code> 
  
 +  You can mark something as <del>deleted</del> as well.
  
 **Paragraphs** are created from blank lines. If you want to **force a newline** without a paragraph, you can use two backslashes followed by a whitespace or the end of line. **Paragraphs** are created from blank lines. If you want to **force a newline** without a paragraph, you can use two backslashes followed by a whitespace or the end of line.
  
 +This is some text with some linebreaks\\ Note that the
 +two backslashes are only recognized at the end of a line\\
 +or followed by\\ a whitespace \\this happens without it.
  
-This is some text with some linebreaks\\  +  This is some text with some linebreaks\\ Note that the 
-Note that the two backslashes are only recognized at the end of a line\\  +  two backslashes are only recognized at the end of a line\\ 
-or followed by\\  +  or followed by\\ a whitespace \\this happens without it.
-a whitespace %this happens without it. +
- +
- +
-<code> +
-This is some text with some linebreaks\\  +
-Note that the +
-two backslashes are only recognized at the end of a line\\  +
-or followed by\\  +
-a whitespace \\this happens without it. +
-</code> +
  
 You should use forced newlines only if really needed. You should use forced newlines only if really needed.
Line 101: Line 84:
  
   * For security reasons direct browsing of windows shares only works in Microsoft Internet Explorer per default (and only in the "local zone").   * For security reasons direct browsing of windows shares only works in Microsoft Internet Explorer per default (and only in the "local zone").
-  * For Mozilla and Firefox it can be enabled through different workaround mentioned in the [[http://kb.mozillazine.org/Links_to_local_pages_do_not_work|Mozilla Knowledge Base]]. However, there will still be a JavaScript warning about trying to open a Windows Share. To remove this warning (for all users), put the following line in ''conf/userscript.js'': +  * For Mozilla and Firefox it can be enabled through different workaround mentioned in the [[http://kb.mozillazine.org/Links_to_local_pages_do_not_work|Mozilla Knowledge Base]]. However, there will still be a JavaScript warning about trying to open a Windows Share. To remove this warning (for all users), put the following line in ''conf/lang/en/lang.php'' (more details at [[doku>localization#changing_some_localized_texts_and_strings_in_your_installation|localization]]): <code - conf/lang/en/lang.php> 
- +<?php 
-  LANG.nosmblinks = '';+/** 
 + * Customization of the english language file 
 + * Copy only the strings that needs to be modified 
 + */ 
 +$lang['js']['nosmblinks'] = ''; 
 +</code>
  
 ==== Image Links ==== ==== Image Links ====
Line 139: Line 127:
 ---- ----
  
-===== Images and Other Files =====+===== Media Files =====
  
-You can include external and internal [[doku>images]] with curly brackets. Optionally you can specify the size of them.+You can include external and internal [[doku>images|images, videos and audio files]] with curly brackets. Optionally you can specify the size of them.
  
 Real size:                        {{wiki:dokuwiki-128.png}} Real size:                        {{wiki:dokuwiki-128.png}}
Line 174: Line 162:
  
   {{ wiki:dokuwiki-128.png |This is the caption}}   {{ wiki:dokuwiki-128.png |This is the caption}}
- 
-If you specify a filename (external or internal) that is not an image (''gif, jpeg, png''), then it will be displayed as a link instead. 
  
 For linking an image to another page see [[#Image Links]] above. For linking an image to another page see [[#Image Links]] above.
 +
 +==== Supported Media Formats ====
 +
 +DokuWiki can embed the following media formats directly.
 +
 +| Image | ''gif'', ''jpg'', ''png''  |
 +| Video | ''webm'', ''ogv'', ''mp4'' |
 +| Audio | ''ogg'', ''mp3'', ''wav''  |
 +| Flash | ''swf''                    |
 +
 +If you specify a filename that is not a supported media format, then it will be displayed as a link instead.
 +
 +By adding ''?linkonly'' you provide a link to the media without displaying it inline
 +
 +  {{wiki:dokuwiki-128.png?linkonly}}
 +
 +{{wiki:dokuwiki-128.png?linkonly}} This is just a link to the image.
 +
 +==== Fallback Formats ====
 +
 +Unfortunately not all browsers understand all video and audio formats. To mitigate the problem, you can upload your file in different formats for maximum browser compatibility.
 +
 +For example consider this embedded mp4 video:
 +
 +  {{video.mp4|A funny video}}
 +
 +When you upload a ''video.webm'' and ''video.ogv'' next to the referenced ''video.mp4'', DokuWiki will automatically add them as alternatives so that one of the three files is understood by your browser.
 +
 +Additionally DokuWiki supports a "poster" image which will be shown before the video has started. That image needs to have the same filename as the video and be either a jpg or png file. In the example above a ''video.jpg'' file would work.
  
 ===== Lists ===== ===== Lists =====
Line 258: Line 273:
 Some times you want to mark some text to show it's a reply or comment. You can use the following syntax: Some times you want to mark some text to show it's a reply or comment. You can use the following syntax:
  
-  I think we should do it +<code> 
-   +I think we should do it 
-  > No we shouldn't + 
-   +> No we shouldn't 
-  >> Well, I say we should + 
-   +>> Well, I say we should 
-  > Really? + 
-   +> Really? 
-  >> Yes! + 
-   +>> Yes! 
-  >>> Then lets do it!+ 
 +>>> Then lets do it! 
 +</code>
  
 I think we should do it I think we should do it
Line 314: Line 331:
   ^ Heading 5    | Row 2 Col 2          | Row 2 Col 3        |   ^ Heading 5    | Row 2 Col 2          | Row 2 Col 3        |
  
-You can have rowspans (vertically connected cells) by adding '':::'' into the cells below the one to which they should connect.+You can have rowspans (vertically connected cells) by adding ''%%:::%%'' into the cells below the one to which they should connect.
  
 ^ Heading 1      ^ Heading 2                  ^ Heading 3          ^ ^ Heading 1      ^ Heading 2                  ^ Heading 3          ^
Line 445: Line 462:
 <code> <code>
 <php> <php>
-echo 'A logo generated by PHP:'; +echo 'The PHP version: '; 
-echo '<img src="' . $_SERVER['PHP_SELF'] . '?=' . php_logo_guid() . '" alt="PHP Logo !" />'; +echo phpversion(); 
-echo '(generated inline HTML)';+echo ' (generated inline HTML)';
 </php> </php>
 <PHP> <PHP>
 echo '<table class="inline"><tr><td>The same, but inside a block level element:</td>'; echo '<table class="inline"><tr><td>The same, but inside a block level element:</td>';
-echo '<td><img src="' . $_SERVER['PHP_SELF'] . '?=' . php_logo_guid() . '" alt="PHP Logo !" /></td>';+echo '<td>'.phpversion().'</td>';
 echo '</tr></table>'; echo '</tr></table>';
 </PHP> </PHP>
Line 457: Line 474:
  
 <php> <php>
-echo 'A logo generated by PHP:'; +echo 'The PHP version: '; 
-echo '<img src="' . $_SERVER['PHP_SELF'] . '?=' . php_logo_guid() . '" alt="PHP Logo !" />'; +echo phpversion(); 
-echo '(inline HTML)';+echo ' (inline HTML)';
 </php> </php>
 <PHP> <PHP>
 echo '<table class="inline"><tr><td>The same, but inside a block level element:</td>'; echo '<table class="inline"><tr><td>The same, but inside a block level element:</td>';
-echo '<td><img src="' . $_SERVER['PHP_SELF'] . '?=' . php_logo_guid() . '" alt="PHP Logo !" /></td>';+echo '<td>'.phpversion().'</td>';
 echo '</tr></table>'; echo '</tr></table>';
 </PHP> </PHP>
Line 478: Line 495:
 | date       | show item dates | | date       | show item dates |
 | description| show the item description. If [[doku>config:htmlok|HTML]] is disabled all tags will be stripped | | description| show the item description. If [[doku>config:htmlok|HTML]] is disabled all tags will be stripped |
 +| nosort     | do not sort the items in the feed |
 | //n//[dhm] | refresh period, where d=days, h=hours, m=minutes. (e.g. 12h = 12 hours). | | //n//[dhm] | refresh period, where d=days, h=hours, m=minutes. (e.g. 12h = 12 hours). |
  
 The refresh period defaults to 4 hours. Any value below 10 minutes will be treated as 10 minutes. [[wiki:DokuWiki]] will generally try to supply a cached version of a page, obviously this is inappropriate when the page contains dynamic external content. The parameter tells [[wiki:DokuWiki]] to re-render the page if it is more than //refresh period// since the page was last rendered. The refresh period defaults to 4 hours. Any value below 10 minutes will be treated as 10 minutes. [[wiki:DokuWiki]] will generally try to supply a cached version of a page, obviously this is inappropriate when the page contains dynamic external content. The parameter tells [[wiki:DokuWiki]] to re-render the page if it is more than //refresh period// since the page was last rendered.
 +
 +By default the feed will be sorted by date, newest items first. You can sort it by oldest first using the ''reverse'' parameter, or display the feed as is with ''nosort''.
  
 **Example:** **Example:**
  • wiki/syntax.1412296732.txt.gz
  • Last modified: 2017/06/28 18:05
  • (external edit)