From: Joey Hess <joey@kodama.kitenet.net>
Date: Tue, 29 Jan 2008 05:07:55 +0000 (-0500)
Subject: don't render internal-use pages, and document them
X-Git-Tag: 2.30~85
X-Git-Url: http://git.tremily.us/?a=commitdiff_plain;h=2ff726e87595d7496245f7c01e2bb217004979c0;p=ikiwiki.git

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

diff --git a/IkiWiki/Render.pm b/IkiWiki/Render.pm
index 4fefadf09..5684f8092 100644
--- 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 b098bf966..b57ef1178 100644
--- 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 0da425402..76fa3f0d7 100644
--- 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.