aboutsummaryrefslogtreecommitdiff
path: root/doc/plugins/txt.mdwn
blob: a51aabf481e4473b4d3325dcd9aa967c2e19f069 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
[[!template id=plugin name=txt author="[[Gabriel]]"]]
[[!tag type/format]]

This plugin makes ikiwiki treat files with names ending in ".txt"
as wiki pages.

Unlike other [[type/format]] plugins, no formatting of markup in 
txt files is done; the file contents is displayed to the user as
pre-formatted text, with html markup characters such as ">" escaped.

The only exceptions are that [[WikiLinks|ikiwiki/WikiLink]] and
[[directives|ikiwiki/directive]] are still expanded by
ikiwiki, and that, if the [[!cpan URI::Find]] perl module is installed, URLs
in the txt file are converted to hyperlinks.

----

As a special case, a file `robots.txt` will be copied intact into the
`destdir`, as well as creating a wiki page named "robots".