Merge branch 'master' of ssh://git.ikiwiki.info/srv/git/ikiwiki.info
[ikiwiki] / doc / plugins / creole.mdwn
1 [[!template id=plugin name=creole author="BerndZeimetz"]]
2 [[!tag type/format]]
3
4 This plugin allows ikiwiki to process pages written in
5 [WikiCreole](http://www.wikicreole.org/) format.
6 To use it, you need to have the [[!cpan Text::WikiCreole]] perl
7 module installed, enable the plugin, then files with the extention `.creole`
8 will be processed as creole.
9
10 The creole format is based on common elements across many different
11 wiki markup formats, so should be fairly easy to guess at. There is also a
12 [CheatSheet](http://www.wikicreole.org/wiki/CheatSheet).
13
14 Links are standard [[WikiLinks|ikiwiki/WikiLink]]. Links and
15 [[directives|ikiwiki/directive]] inside `{{{ }}}` blocks are still expanded,
16 since this happens before the creole format is processed. (You need to escape
17 them manually, via \\\[[directives]], the ~ escaping of creole doesn't work on
18 this.)
19
20 The standard ikiwiki [[WikiLinks|ikiwiki/WikiLink]] is almost the same as Creole link, except that creole uses \[[pagename|description]] while ikiwiki uses \[[description|pagename]].
21
22