don't render internal-use pages, and document them

diff --git a/IkiWiki/Render.pm b/IkiWiki/Render.pm
index 4fefadf09d5994c982735da22f6da194a563be50..5684f80924f32fca82772a9b1295247c430f3883 100644 (file)
--- a/IkiWiki/Render.pm
+++ b/IkiWiki/Render.pm
@@ -193,6 +193,7 @@ sub render ($) { #{{{
        my $type=pagetype($file);
        my $srcfile=srcfile($file);
        if (defined $type) {
+               return if $type=~/^_/;
                my $page=pagename($file);
                delete $depends{$page};
                will_render($page, htmlpage($page), 1);

diff --git a/debian/changelog b/debian/changelog
index b098bf9663326df35edcd1f26fbdabde0bfd82d2..b57ef1178ff451d74a515a03e5cd4f1aa58a1b74 100644 (file)
--- a/debian/changelog
+++ b/debian/changelog
@@ -21,6 +21,8 @@ ikiwiki (2.21) UNRELEASED; urgency=low
     tables and the like.
   * prettydate,ddate: Don't ignore time formats passed to displaytime
     function.
+  * Pages with extensions starting with "_" are internal-use, and will
+    not be rendered or web-edited.
 
  -- Joey Hess <joeyh@debian.org>  Fri, 11 Jan 2008 15:09:37 -0500
 

diff --git a/doc/plugins/write.mdwn b/doc/plugins/write.mdwn
index 0da425402fb53b826eab803fb619e3daa8ed97c6..76fa3f0d7e028be4a0272749528d08dbd77e79ad 100644 (file)
--- a/doc/plugins/write.mdwn
+++ b/doc/plugins/write.mdwn
@@ -143,6 +143,11 @@ specifies the filename extension that a file must have to be htmlized using
 this plugin. This is how you can add support for new and exciting markup
 languages to ikiwiki.
 
+Note that if you choose a filename extension that starts with "_",
+ikiwiki will not render the page, or allow the page to be edited with the
+web interface. This is useful for certian types of internal-use pages, but
+should generally be avoided.
+
 The function is passed named parameters: "page" and "content" and should
 return the htmlized content.