new txt plugin, was previously contrib/plaintext
[ikiwiki.git] / doc / plugins / plaintext / discussion.mdwn
1 I guess the reason I never thought to write this is when I put a .txt file
2 in ikiwiki, I'm happy enough to see it copied through unchanged.
3
4 I guess the advantage of using this plugin is that you get the page wrapper
5 around the preformatted text, and could even inline such a page.
6
7 There is not currently a good way to turn off some processing steps for
8 some page types. It's either all or nothing. The patch in
9 [[todo/format_escape]] might allow a formatter to register its own special
10 version of htmllink that didn't do anything, but would that be enough?
11
12 --[[Joey]]
13
14 [Here](http://www.gmcmanus.org/plaintext.pm) is an alternate approach.
15 It encodes entities using a filter hook, before wikilinks are linkified.
16 So wikilinks turn up as links.
17 It also uses URI::Find to turn URIs into links.
18
19 I'm not very familiar with Perl, so this code could be improved.
20
21 --Gabriel
22
23 I like this approach! It sidesteps the annoying problem, and it actually
24 makes the .txt format genuinely wiki-like, by allowing wikilinks and
25 preprocessor directices.
26
27 The only thing I am not sure about is the conversion of external urls to
28 hyperlinks. 
29
30 Can you please add a copyright/license statemnt to the top of the plugin?
31 If you do, I'll add it to ikiwiki. Thanks! --[[Joey]]
32
33 > I've added copyright and license (GPLv2 or later). --Gabriel