Page Formatting ~ Extra Text Styles
Extra Text Formatting
Here are some extra formatting codes to add to your repertoire.
You can add footnotes 1) by using double parentheses.
You can add footnotes ((This is a footnote)) by using double parentheses.
Scroll to the bottom of this page to see the footnote.
An administrator can change the Smileys in the
smiley directory configured in the
DokuWiki can convert simple text characters to typographically correct symbols. Click on the Special Chars icon Ω in the toolbar and choose from the drop-list of accented characters and symbols. Here is an example of some recognized characters.
→ ← ↔ ⇒ ⇐ ⇔ » « – —
640x480 © ™ ®
"He thought 'It's a man's world'…"
-> <- <-> => <= <=> >> << -- --- 640x480 (c) (tm) (r) "He thought 'It's a man's world'..."
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 > No we shouldn't >> Well, I say we should > Really? >> Yes! >>> Then lets do it!
I think we should do it
No we shouldn't
Well, I say we should
Then lets do it!
The Commentsrc Plugin allows text to be entered that is only visible while editing a page by enclosing the text within !- and -!.
!- This is a comment. -!
Currently only one such comment is allowed per page, otherwise all the intervening text is also treated as comment.
Be aware that a DokuWiki search will include this comment text even though it is invisible on the displayed page.
The HideText Plugin allows text to be hidden behind a legend that when clicked reveals the text. The default legend is >>> or it can be defined by the plugin.
<hidetext> This text is hidden. </hidetext>
Click to reveal
<hidetext Click to reveal > This text is also hidden. </hidetext>
The Box Plugin supports boxes with optional widths, round corners, colours, titles, captions, etc.
<box 50% red | **Bold Title** > The box contents can include almost any **DokuWiki** markup, and can spread over as many lines as are needed. =) </box | Box Caption >
The full syntax is:
<box width classes colours | title text > contents text </box | caption text >
- width - any legal CSS width value, set to 50% by default.
- classes any number of classes defined by styles in your template or the plugin's stylesheet. The Box Plugin comes with the following classes already defined:
- round - box will have round corners
- blue - blue colour scheme
- red - red colour scheme
- green - green colour scheme
- orange - orange colour scheme
- left - float the box left within the Wiki page
- right - float the box right within the Wiki page
- If no classes are specified the default styles will be used, i.e. square corners in a colour scheme based on the default DokuWiki colour scheme and a central position.
- colours - 1-4 colours in CSS hex or RGB notation, e.g. F00 fcab94 rgb(255,255,0). These colours are applied in order to:
- content background
- title background
- outer box background
- If less than four colours are specified, the first colour is used for the missing colours.
- title text - text displayed above the box contents, with distinct style. DokuWiki text markup, links, smileys and the like can be used.
- contents text - text displayed inside the box. DokuWiki markup is allowed and pretty well anything goes.
- caption text - text displayed below the box contents, with distinct style. DokuWiki markup is NOT allowed.
The opening <box … > including the title must all appear on one line. The box contents can appear over as many lines as are needed.
DokuWiki supports a simple syntax to create tables.
|Heading 1||Heading 2||Heading 3|
|Row 1 Col 1||Row 1 Col 2||Row 1 Col 3|
|Row 2 Col 1||some colspan (note the double pipe)|
|Row 3 Col 1||Row 2 Col 2||Row 2 Col 3|
Table rows have to start and end with a
| for normal rows or a
^ for headers.
^ Heading 1 ^ Heading 2 ^ Heading 3 ^ | Row 1 Col 1 | Row 1 Col 2 | Row 1 Col 3 | | Row 2 Col 1 | some colspan (note the double pipe) || | Row 3 Col 1 | Row 2 Col 2 | Row 2 Col 3 |
To connect cells horizontally, just make the next cell completely empty as shown above. Be sure to have always the same amount of cell separators!
Vertical tableheaders are possible, too.
|Heading 1||Heading 2|
|Heading 3||Row 1 Col 2||Row 1 Col 3|
|Heading 4||no colspan this time|
|Heading 5||Row 2 Col 2||Row 2 Col 3|
As you can see, it's the cell separator before a cell which decides about the formatting:
| ^ Heading 1 ^ Heading 2 ^ ^ Heading 3 | Row 1 Col 2 | Row 1 Col 3 | ^ Heading 4 | no colspan this time | | ^ Heading 5 | Row 2 Col 2 | Row 2 Col 3 |
Note: Vertical spans (rowspan) are not possible.
You can align the table contents, too. Just add at least two whitespaces at the opposite end of your text: Add two spaces on the left to align right, two spaces on the right to align left and two spaces at least at both ends for centered text.
|Table with alignment|
This is how it looks in the source:
^ Table with alignment ^^^ | right| center |left | |left | right| center | | xxxxxxxxxxxx | xxxxxxxxxxxx | xxxxxxxxxxxx |
You can insert non-parsed blocks into your pages by either indenting them by at least two spaces (as used in earlier examples), or by using the tag pairs
This is preformatted <code> where all spaces are preserved: like <-this
<code> This is preformatted <code> where all spaces are preserved: like <-this </code>
This is much the same using <file>, but you could use it to show that you quoted a file.
<file> This is much the same using <file>, but you could use it to show that you quoted a file. </file>
To make the parser ignore an area completely (i.e. do no formatting on it), enclose the area with
<\nowiki> tags, or even simpler, with double percent signs
This is some <nowiki> text which contains addresses like this: http://www.splitbrain.org and **formatting**, but nothing is done with it.
<nowiki> This is some <nowiki> text which contains addresses like this: http://www.splitbrain.org and **formatting**, but nothing is done with it. </nowiki>
This is some text using double % signs in a similar way like this: http://www.splitbrain.org and **formatting**.
This is some text using double % signs in a similar way like this: %%http://www.splitbrain.org%% and %%**formatting**%%.