Page Formatting ~ Extra Text Styles

Extra Text Formatting

Here are some extra formatting codes to add to your repertoire.

Footnotes

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.

Smileys

DokuWiki converts commonly used emoticons to their graphical equivalents. Click on the Smileys icon :-D in the toolbar and choose from the drop-list. Here is an overview of Smileys included in DokuWiki.

Smileys

  • 8-) 8-)
  • 8-O 8-O
  • :-( :-(
  • :-) :-)
  • =) =)
  • :-/ :-/
  • :-\ :-\
  • :-? :-?
  • :-D :-D
  • :-P :-P
  • :-O :-O
  • :-X :-X
  • :-| :-|
  • ;-) ;-)
  • ^_^ ^_^
  • :?: :?:
  • :!: :!:
  • LOL LOL
  • FIXME FIXME
  • DELETEME DELETEME

An administrator can change the Smileys in the smiley directory configured in the conf/smileys.conf file.

Typography

Special Chars

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'..."

An administrator can turn off these conversions through a config option and a pattern file.

Quoting

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
Really?
Yes!
Then lets do it!

Comments

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.

Hidden Text

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.

>>>

This text is hidden.

<hidetext> This text is hidden. </hidetext>

Click to reveal

This text is also hidden.

<hidetext Click to reveal > This text is also hidden. </hidetext>

Boxes

The Box Plugin supports boxes with optional widths, round corners, colours, titles, captions, etc.

Bold Title

The box contents can include almost any DokuWiki markup, and can spread over as many lines as are needed. =)

Box Caption

<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
    • borders
    • 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.

Tables

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
right center left
left right center
xxxxxxxxxxxx xxxxxxxxxxxx xxxxxxxxxxxx

This is how it looks in the source:

^           Table with alignment           ^^^
|         right|    center    |left          |
|left          |         right|    center    |
| xxxxxxxxxxxx | xxxxxxxxxxxx | xxxxxxxxxxxx |

Non-parsed Blocks

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 <code> & </code> or <file> & </file>.

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> & <\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**%%.

See Syntax Highlighting and Downloadable Code Blocks for further options.

1)
This is a footnote