summaryrefslogtreecommitdiff
path: root/doc/plugins
diff options
context:
space:
mode:
Diffstat (limited to 'doc/plugins')
-rw-r--r--doc/plugins/contrib/plaintext.mdwn17
-rw-r--r--doc/plugins/plaintext/.discussion.mdwn.swpbin0 -> 12288 bytes
-rw-r--r--doc/plugins/plaintext/discussion.mdwn (renamed from doc/plugins/contrib/plaintext/discussion.mdwn)0
-rw-r--r--doc/plugins/txt.mdwn14
4 files changed, 14 insertions, 17 deletions
diff --git a/doc/plugins/contrib/plaintext.mdwn b/doc/plugins/contrib/plaintext.mdwn
deleted file mode 100644
index 0350bc3ca..000000000
--- a/doc/plugins/contrib/plaintext.mdwn
+++ /dev/null
@@ -1,17 +0,0 @@
-[[template id=plugin name=plaintext author="[[JeremieKoenig]]"]]
-[[tag type/format]]
-
-I was surprised that no plugin seems to be available to render plaintext pages;
-as I need one to implement the "[[todo/preview_changes]]" todo item,
-I quickly wrote it. Maybe this can be included in ikiwiki?
-
-This plugins uses HTML::Entities::encode_entities() on the page's content
-and wraps it in a `<pre>`...`</pre>` tag.
-
-Download from [here](http://www.jk.fr.eu.org/ikiwiki/plaintext.pm).
-
-## Problems
-
-Wikilinks are expanded as usual, and as such produce `<a href=...>text</a>`
-tags, which are displayed as plain text. Is there a way to disable the preprocessor
-for some types of pages? \ No newline at end of file
diff --git a/doc/plugins/plaintext/.discussion.mdwn.swp b/doc/plugins/plaintext/.discussion.mdwn.swp
new file mode 100644
index 000000000..df2347f9e
--- /dev/null
+++ b/doc/plugins/plaintext/.discussion.mdwn.swp
Binary files differ
diff --git a/doc/plugins/contrib/plaintext/discussion.mdwn b/doc/plugins/plaintext/discussion.mdwn
index 6b907e65c..6b907e65c 100644
--- a/doc/plugins/contrib/plaintext/discussion.mdwn
+++ b/doc/plugins/plaintext/discussion.mdwn
diff --git a/doc/plugins/txt.mdwn b/doc/plugins/txt.mdwn
new file mode 100644
index 000000000..8d8cb55c2
--- /dev/null
+++ b/doc/plugins/txt.mdwn
@@ -0,0 +1,14 @@
+[[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-is,
+with html markup characters such as ">" escaped.
+
+The only exceptions are that [[WikiLinks|WikiLink]] and
+[[PreprocessorDirectives|PreprocessorDirective]] 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.