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) {
        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);
                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.
     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
 
 
  -- 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.
 
 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.
 
 The function is passed named parameters: "page" and "content" and should
 return the htmlized content.