meta data for this page
Differences
This shows you the differences between two versions of the page.
Both sides previous revision Previous revision Next revision | Previous revision | ||
wiki:syntax [2017/04/24 14:42] superadmin |
wiki:syntax [2020/11/10 13:20] (current) |
||
---|---|---|---|
Line 1: | Line 1: | ||
- | ====== Syntax ====== | + | ====== |
- | [[doku> | + | [[doku> |
===== Basic Text Formatting ===== | ===== Basic Text Formatting ===== | ||
Line 19: | Line 19: | ||
**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\\ Note that the | ||
+ | two backslashes are only recognized at the end of a line\\ | ||
+ | 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 ===== | ||
+ | |||
+ | DokuWiki supports multiple ways of creating links. | ||
==== External ==== | ==== External ==== | ||
Line 28: | Line 38: | ||
External links are recognized automagically: | External links are recognized automagically: | ||
- | You can set link text as well: [[http:// | + | |
+ | automagically: | ||
+ | | ||
+ | | ||
==== Internal ==== | ==== Internal ==== | ||
- | Internal links are created by using square brackets. You can either just give a [[pagename]] or use an additional [[pagename|link text]], [[some: | + | 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 | Internal links are created by using square brackets. You can either just give | ||
- | a [[pagename]] or use an additional [[pagename|link text]], [[some: | + | a [[pagename]] or use an additional [[pagename|link text]]. |
[[doku> | [[doku> | ||
- | Linking to a specific section is possible. | + | You can use [[some: |
+ | |||
+ | You can use [[some: | ||
+ | |||
+ | For details about namespaces see [[doku> | ||
+ | |||
+ | Linking to a specific section is possible, too. Just add the section name behind a hash character as known from HTML. This links to [[syntax# | ||
This links to [[syntax# | This links to [[syntax# | ||
Line 46: | Line 65: | ||
* 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 [[nonexisting]] ones. | ||
+ | * DokuWiki does not use [[wp> | ||
+ | * When a section' | ||
+ | |||
+ | ==== Interwiki ==== | ||
+ | |||
+ | DokuWiki supports [[doku> | ||
+ | |||
+ | DokuWiki supports [[doku> | ||
+ | For example this is a link to Wikipedia' | ||
==== Windows Shares ==== | ==== Windows Shares ==== | ||
- | Windows shares like [[\\server\share|this]] are recognized. Please note that these only make sense in a homogeneous user group like a corporate [[wp> | + | Windows shares like [[\\server\share|this]] are recognized, too. Please note that these only make sense in a homogeneous user group like a corporate [[wp> |
Windows Shares like [[\\server\share|this]] are recognized, too. | Windows Shares like [[\\server\share|this]] are recognized, too. | ||
Line 64: | Line 92: | ||
$lang[' | $lang[' | ||
</ | </ | ||
+ | |||
+ | ==== Image Links ==== | ||
+ | |||
+ | You can also use an image to link to another internal or external page by combining the syntax for links and [[# | ||
+ | |||
+ | [[http:// | ||
+ | |||
+ | [[http:// | ||
+ | |||
+ | Please note: The image formatting is the only formatting syntax accepted in link names. | ||
+ | |||
+ | The whole [[# | ||
===== Footnotes ===== | ===== Footnotes ===== | ||
Line 97: | Line 137: | ||
Resize to given width and height((when the aspect ratio of the given width and height doesn' | Resize to given width and height((when the aspect ratio of the given width and height doesn' | ||
- | Resized external image: | + | Resized external image: |
Real size: {{wiki: | Real size: {{wiki: | ||
Resize to given width: | Resize to given width: | ||
Resize to given width and height: {{wiki: | Resize to given width and height: {{wiki: | ||
- | Resized external image: | + | Resized external image: |
Line 181: | Line 221: | ||
Also take a look at the [[doku> | Also take a look at the [[doku> | ||
+ | |||
+ | ===== Text Conversions ===== | ||
+ | |||
+ | DokuWiki can convert certain pre-defined characters or strings into images or other text or HTML. | ||
+ | |||
+ | The text to image conversion is mainly done for smileys. And the text to HTML conversion is used for typography replacements, | ||
+ | |||
+ | ==== Text to Image Conversions ==== | ||
+ | |||
+ | DokuWiki converts commonly used [[wp> | ||
+ | |||
+ | * 8-) %% 8-) %% | ||
+ | * 8-O %% 8-O %% | ||
+ | * :-( %% :-( %% | ||
+ | * :-) %% :-) %% | ||
+ | * =) %% =) %% | ||
+ | * :-/ %% :-/ %% | ||
+ | * :-\ %% :-\ %% | ||
+ | * :-? %% :-? %% | ||
+ | * :-D %% :-D %% | ||
+ | * :-P %% :-P %% | ||
+ | * :-O %% :-O %% | ||
+ | * :-X %% :-X %% | ||
+ | * :-| %% :-| %% | ||
+ | * ;-) %% ;-) %% | ||
+ | * ^_^ %% ^_^ %% | ||
+ | * :?: %% :?: %% | ||
+ | * :!: %% :!: %% | ||
+ | * LOL %% LOL %% | ||
+ | * FIXME %% FIXME %% | ||
+ | * DELETEME %% DELETEME %% | ||
==== Text to HTML Conversions ==== | ==== Text to HTML Conversions ==== | ||
Line 346: | Line 417: | ||
</ | </ | ||
- | The following language strings are currently recognized: //4cs, 6502acme, 6502kickass, 6502tasm, 68000devpac, abap, actionscript-french, actionscript, | + | The following language strings are currently recognized: //4cs 6502acme 6502kickass 6502tasm 68000devpac abap actionscript3 |
+ | |||
+ | There are additional [[doku> | ||
==== Downloadable Code Blocks ==== | ==== Downloadable Code Blocks ==== | ||
Line 414: | Line 487: | ||
**Please Note**: HTML and PHP embedding is disabled by default in the configuration. If disabled, the code is displayed instead of executed. | **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 ===== | ||
+ | [[DokuWiki]] can integrate data from external XML feeds. For parsing the XML feeds, [[http:// | ||
+ | |||
+ | ^ Parameter | ||
+ | | any number | will be used as maximum number items to show, defaults to 8 | | ||
+ | | reverse | ||
+ | | author | ||
+ | | date | show item dates | | ||
+ | | description| show the item description. If [[doku> | ||
+ | | nosort | ||
+ | | //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: | ||
+ | |||
+ | By default the feed will be sorted by date, newest items first. You can sort it by oldest first using the '' | ||
+ | |||
+ | **Example: | ||
+ | |||
+ | {{rss> | ||
+ | |||
+ | {{rss> | ||
+ | |||
===== Control Macros ===== | ===== Control Macros ===== | ||
Line 422: | Line 518: | ||
| %%~~NOTOC~~%% | | %%~~NOTOC~~%% | ||
| %%~~NOCACHE~~%% | DokuWiki caches all output by default. Sometimes this might not be wanted (eg. when the %%< | | %%~~NOCACHE~~%% | DokuWiki caches all output by default. Sometimes this might not be wanted (eg. when the %%< | ||
+ | |||
+ | ===== Syntax Plugins ===== | ||
+ | |||
+ | DokuWiki' | ||
+ | |||
+ | ~~INFO: | ||
+ |