User Tools

Site Tools


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
Next revision
Previous revision
wiki:syntax [2015/04/22 21:31]
paxswill [Embedding HTML and PHP] HTML and PHP embedding are disabled here
wiki:syntax [2017/04/29 01:05]
ThatIsUnfortunate Links adapted because of a move operation
Line 45: Line 45:
 ==== Internal ==== ==== Internal ====
  
-Internal links are created by using square brackets. You can either just give a [[pagename]] or use an additional [[pagename|link text]].+Internal links are created by using square brackets. You can either just give a [[corps:​dronv:​sl1de:​wiki:​pagename]] or use an additional [[corps:​dronv:​sl1de:​wiki:​pagename|link text]].
  
   Internal links are created by using square brackets. You can either just give   Internal links are created by using square brackets. You can either just give
Line 64: Line 64:
 Notes: Notes:
  
-  * Links to [[syntax|existing pages]] are shown in a different style from [[nonexisting]] ones.+  * Links to [[syntax|existing pages]] are shown in a different style from [[corps:​dronv:​sl1de:​wiki:​nonexisting]] ones.
   * 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.
Line 84: 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 170: Line 175:
  
 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.
 +
 +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 ==== ==== Fallback Formats ====
Line 262: 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 318: 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 423: Line 436:
  
  
 +===== Embedding HTML and PHP =====
 +
 +You can embed raw HTML or PHP code into your documents by using the ''​%%<​html>​%%''​ or ''​%%<​php>​%%''​ tags. (Use uppercase tags if you need to enclose block level elements.)
 +
 +HTML example:
 +
 +<​code>​
 +<​html>​
 +This is some <span style="​color:​red;​font-size:​150%;">​inline HTML</​span>​
 +</​html>​
 +<​HTML>​
 +<p style="​border:​2px dashed red;">​And this is some block HTML</​p>​
 +</​HTML>​
 +</​code>​
 +
 +<​html>​
 +This is some <span style="​color:​red;​font-size:​150%;">​inline HTML</​span>​
 +</​html>​
 +<​HTML>​
 +<p style="​border:​2px dashed red;">​And this is some block HTML</​p>​
 +</​HTML>​
 +
 +PHP example:
 +
 +<​code>​
 +<php>
 +echo 'The PHP version: ';
 +echo phpversion();​
 +echo ' (generated inline HTML)';​
 +</​php>​
 +<PHP>
 +echo '<​table class="​inline"><​tr><​td>​The same, but inside a block level element:</​td>';​
 +echo '<​td>'​.phpversion().'</​td>';​
 +echo '</​tr></​table>';​
 +</​PHP>​
 +</​code>​
 +
 +<php>
 +echo 'The PHP version: ';
 +echo phpversion();​
 +echo ' (inline HTML)';​
 +</​php>​
 +<PHP>
 +echo '<​table class="​inline"><​tr><​td>​The same, but inside a block level element:</​td>';​
 +echo '<​td>'​.phpversion().'</​td>';​
 +echo '</​tr></​table>';​
 +</​PHP>​
 +
 +**Please Note**: HTML and PHP embedding is disabled by default in the configuration. If disabled, the code is displayed instead of executed.
  
 ===== RSS/ATOM Feed Aggregation ===== ===== RSS/ATOM Feed Aggregation =====
Line 433: 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.txt · Last modified: 2019/01/06 09:18 (external edit)