new txt plugin, was previously contrib/plaintext
[ikiwiki.git] / doc / plugins / txt.mdwn
1 [[template id=plugin name=txt author="[[Gabriel]]"]]
2 [[tag type/format]]
3
4 This plugin makes ikiwiki treat files with names ending in ".txt"
5 as wiki pages.
6
7 Unlike other [[type/format]] plugins, no formatting of markup in 
8 txt files is done; the file contents is displayed to the user as-is,
9 with html markup characters such as ">" escaped.
10
11 The only exceptions are that [[WikiLinks|WikiLink]] and
12 [[PreprocessorDirectives|PreprocessorDirective]] are still expanded by
13 ikiwiki, and that, if the [[cpan URI::Find]] perl module is installed, URLs
14 in the txt file are converted to hyperlinks.