* Add a rawhtml plugin that allows copying raw html files from the srcdir.

2 files changed, 14 insertions, 1 deletions

diff --git a/doc/plugins/html.mdwn b/doc/plugins/html.mdwn
index 4351ecdb5..d19c99af8 100644
--- a/doc/plugins/html.mdwn
+++ b/doc/plugins/html.mdwn
@@ -1,7 +1,7 @@
 [[template id=plugin name=html included=1 author="[[Joey]]"]]
 [[tag type/html type/format]]
 
-This plugin lets raw html pages be used as source pages for the wiki. The
+This plugin lets html pages be used as source pages for the wiki. The
 html pages will still be wrapped in the same html template as any other
 page, so for best results you should include only the page body in the html
 file. Also, if the htmlscrubber plugin is enabled, the html pages will be
diff --git a/doc/plugins/rawhtml.mdwn b/doc/plugins/rawhtml.mdwn
new file mode 100644
index 000000000..41f4a7056
--- /dev/null
+++ b/doc/plugins/rawhtml.mdwn
@@ -0,0 +1,13 @@
+[[template id=plugin name=rawhtml included=1 author="[[Joey]]"]]
+[[tag type/html type/format]]
+
+This plugin changes how ikiwiki handles html files, making it treat html
+or xhtml files not as source files but as data files that are copied
+unchanged when the wiki is built. Compared with the [[html]] plugin, which
+treats html files as source files for the wiki, this plugin allows complete
+control over html pages. Note that this means that the html will not be
+sanitised of problimatic content such as javascript, so it can be insecure
+to enable this plugin if untrusted users have write access to your wiki's
+repository.
+
+This plugin is included in ikiwiki, but is not enabled by default.