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
Last revisionBoth sides next revision
wiki:syntax [2024/03/10 18:36] – external edit 127.0.0.1wiki:syntax [2024/03/31 18:47] – andi
Line 27: Line 27:
   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\\ a whitespace \\this happens without it.   or followed by\\ a whitespace \\this happens without it.
 +
  
 You should use forced newlines only if really needed. You should use forced newlines only if really needed.
 +
  
 ===== Links ===== ===== Links =====
Line 42: Line 44:
   link text as well: [[http://www.google.com|This Link points to google]]. Email   link text as well: [[http://www.google.com|This Link points to google]]. Email
   addresses like this one: <andi@splitbrain.org> are recognized, too.   addresses like this one: <andi@splitbrain.org> are recognized, too.
 +
  
 ==== Internal ==== ==== Internal ====
Line 67: Line 70:
   * DokuWiki does not use [[wp>CamelCase]] to automatically create links by default, but this behavior can be enabled in the [[doku>config]] file. Hint: If DokuWiki is a link, then it's enabled.   * DokuWiki does not use [[wp>CamelCase]] to automatically create links by default, but this behavior can be enabled in the [[doku>config]] file. Hint: If DokuWiki is a link, then it's enabled.
   * When a section's heading is changed, its bookmark changes, too. So don't rely on section linking too much.   * When a section's heading is changed, its bookmark changes, too. So don't rely on section linking too much.
 +
  
 ==== Interwiki ==== ==== Interwiki ====
Line 84: Line 88:
  
   * 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/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>+  * 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 <?php
 /** /**
Line 91: Line 97:
  */  */
 $lang['js']['nosmblinks'] = ''; $lang['js']['nosmblinks'] = '';
 +
 </code> </code>
 +
  
 ==== Image Links ==== ==== Image Links ====
Line 115: Line 123:
 You can use up to five different levels of headlines to structure your content. If you have more than three headlines, a table of contents is generated automatically -- this can be disabled by including the string ''<nowiki>~~NOTOC~~</nowiki>'' in the document. You can use up to five different levels of headlines to structure your content. If you have more than three headlines, a table of contents is generated automatically -- this can be disabled by including the string ''<nowiki>~~NOTOC~~</nowiki>'' in the document.
  
-==== Headline Level 3 ==== +== Headline Level 2 
-=== Headline Level 4 === +=== Headline Level 3 
-== Headline Level 5 ==+==== Headline Level 4 
 +===== Headline Level 5
  
-  ==== Headline Level 3 ==== +  == Headline Level 2 
-  === Headline Level 4 === +  === Headline Level 3 
-  == Headline Level 5 ==+  ==== Headline Level 4 
 +  ===== Headline Level 5
  
 By using four or more dashes, you can make a horizontal line: By using four or more dashes, you can make a horizontal line:
Line 164: Line 174:
  
 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 ==== ==== Supported Media Formats ====
Line 172: Line 183:
 | Video | ''webm'', ''ogv'', ''mp4'' | | Video | ''webm'', ''ogv'', ''mp4'' |
 | Audio | ''ogg'', ''mp3'', ''wav''  | | 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. If you specify a filename that is not a supported media format, then it will be displayed as a link instead.
Line 181: Line 192:
  
 {{wiki:dokuwiki-128.png?linkonly}} This is just a link to the image. {{wiki:dokuwiki-128.png?linkonly}} This is just a link to the image.
 +
  
 ==== Fallback Formats ==== ==== Fallback Formats ====
Line 193: Line 205:
  
 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. 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 208: Line 221:
   - That's it   - That's it
  
-<code>+```
   * This is a list   * This is a list
   * The second item   * The second item
Line 218: Line 231:
     - Just use indention for deeper levels     - Just use indention for deeper levels
   - That's it   - That's it
-</code>+```
  
 Also take a look at the [[doku>faq:lists|FAQ on list items]]. Also take a look at the [[doku>faq:lists|FAQ on list items]].
 +
  
 ===== Text Conversions ===== ===== Text Conversions =====
Line 468: Line 482:
 | %%~~NOTOC~~%%   | If this macro is found on the page, no table of contents will be created | | %%~~NOTOC~~%%   | If this macro is found on the page, no table of contents will be created |
 | %%~~NOCACHE~~%% | DokuWiki caches all output by default. Sometimes this might not be wanted (eg. when the %%<php>%% syntax above is used), adding this macro will force DokuWiki to rerender a page on every call | | %%~~NOCACHE~~%% | DokuWiki caches all output by default. Sometimes this might not be wanted (eg. when the %%<php>%% syntax above is used), adding this macro will force DokuWiki to rerender a page on every call |
 +
  
 ===== Syntax Plugins ===== ===== Syntax Plugins =====
  • wiki/syntax.txt
  • Last modified: 2024/02/12 13:09
  • (external edit)