summaryrefslogtreecommitdiff
diff options
context:
space:
mode:
authorjoey <joey@0fa5a96a-9a0e-0410-b3b2-a0fd24251071>2006-08-18 03:56:18 +0000
committerjoey <joey@0fa5a96a-9a0e-0410-b3b2-a0fd24251071>2006-08-18 03:56:18 +0000
commitc6ee9cbf454bd8e2b557487015ec3e45a9050153 (patch)
tree62cbeb2426d08bde9924b035f33e81a211919f8c
parent516c9eb3ebe932afa1004ef42490ff5d97c994d5 (diff)
* Support inlining pages raw, rather than creating a blog.
* Clean up yes/no parameter parsing in inline plugin. * Implemented better cycle detection in the inline plugin; nested inlines will now work.
-rw-r--r--IkiWiki/Plugin/inline.pm90
-rw-r--r--debian/changelog6
-rw-r--r--doc/plugins/inline.mdwn27
3 files changed, 80 insertions, 43 deletions
diff --git a/IkiWiki/Plugin/inline.pm b/IkiWiki/Plugin/inline.pm
index 5c2aeb6c7..2cc17e325 100644
--- a/IkiWiki/Plugin/inline.pm
+++ b/IkiWiki/Plugin/inline.pm
@@ -22,29 +22,29 @@ sub import { #{{{
package IkiWiki;
my %toping;
-my $processing_inline=0;
+my @processing_inline;
+
+sub yesno ($) { #{{{
+ my $val=shift;
+ return (defined $val && lc($val) eq "yes");
+} #}}}
sub preprocess_inline (@) { #{{{
my %params=@_;
+
+ # Avoid nested inlines, to avoid loops etc.
+ return "" if grep { $_ eq $params{page} } @processing_inline;
+ push @processing_inline, $params{page};
if (! exists $params{pages}) {
return "";
}
- if (! exists $params{archive}) {
- $params{archive}="no";
- }
- if (! exists $params{show} && $params{archive} eq "no") {
+ my $raw=yesno($params{raw});
+ my $archive=yesno($params{archive});
+ my $rss=exists $params{rss} ? yesno($params{rss}) : 1;
+ if (! exists $params{show} && ! $archive) {
$params{show}=10;
}
- if (! exists $params{rss}) {
- $params{rss}="yes";
- }
-
- # Avoid nested inlines, to avoid loops etc.
- if ($processing_inline) {
- return "";
- }
- $processing_inline=1;
my @list;
foreach my $page (keys %pagesources) {
@@ -72,7 +72,7 @@ sub preprocess_inline (@) { #{{{
}
$ret.=$formtemplate->output;
}
- elsif ($config{rss} && $params{rss} eq "yes") {
+ elsif ($config{rss} && $rss) {
# Add a rss link button.
my $linktemplate=template("rsslink.tmpl", blind_cache => 1);
$linktemplate->param(rssurl => rsspage(basename($params{page})));
@@ -80,46 +80,56 @@ sub preprocess_inline (@) { #{{{
}
my $template=template(
- (($params{archive} eq "no")
- ? "inlinepage.tmpl"
- : "inlinepagetitle.tmpl"),
+ ($archive ? "inlinepagetitle.tmpl" : "inlinepage.tmpl"),
blind_cache => 1,
- );
+ ) unless $raw;
foreach my $page (@list) {
- # Don't use htmllink because this way the title is separate
- # and can be overridden by other plugins.
- my $link=htmlpage(bestlink($params{page}, $page));
- $link=abs2rel($link, dirname($params{page}));
- $template->param(pageurl => $link);
- $template->param(title => pagetitle(basename($page)));
- # TODO: if $params{archive} eq "no", the only reason to do this
- # is to let the meta plugin get page title info; so stop
- # calling this next line then once the meta plugin can
- # store that accross runs (also tags plugin).
- $template->param(content => get_inline_content($page, $params{page}));
- $template->param(ctime => displaytime($pagectime{$page}));
+ if (! $raw) {
+ # Don't use htmllink because this way the title is separate
+ # and can be overridden by other plugins.
+ my $link=htmlpage(bestlink($params{page}, $page));
+ $link=abs2rel($link, dirname($params{page}));
+ $template->param(pageurl => $link);
+ $template->param(title => pagetitle(basename($page)));
+ # TODO: if $archive=1, the only reason to do this
+ # is to let the meta plugin get page title info; so stop
+ # calling this next line then once the meta plugin can
+ # store that accross runs (also tags plugin).
+ $template->param(content => get_inline_content($page, $params{page}));
+ $template->param(ctime => displaytime($pagectime{$page}));
- run_hooks(pagetemplate => sub {
- shift->(page => $page, destpage => $params{page},
- template => $template,);
- });
+ run_hooks(pagetemplate => sub {
+ shift->(page => $page, destpage => $params{page},
+ template => $template,);
+ });
- $ret.=$template->output;
- $template->clear_params;
+ $ret.=$template->output;
+ $template->clear_params;
+ }
+ else {
+ my $file=$pagesources{$page};
+ my $type=pagetype($file);
+ if (defined $type) {
+ $ret.="\n".
+ preprocess($page, $params{page},
+ linkify($page, $params{page},
+ filter($page,
+ readfile(srcfile($file)))));
+ }
+ }
}
# TODO: should really add this to renderedfiles and call
# check_overwrite, but currently renderedfiles
# only supports listing one file per page.
- if ($config{rss} && $params{rss} eq "yes") {
+ if ($config{rss} && $rss) {
writefile(rsspage($params{page}), $config{destdir},
genrss($params{page}, @list));
$toping{$params{page}}=1 unless $config{rebuild};
}
- $processing_inline=0;
-
+ pop @processing_inline;
return $ret;
} #}}}
diff --git a/debian/changelog b/debian/changelog
index 88dbb35d8..d1dac85e1 100644
--- a/debian/changelog
+++ b/debian/changelog
@@ -5,8 +5,12 @@ ikiwiki (1.21) UNRELEASED; urgency=low
class="selflink" so that it can be styled. I don't have a useful style
defined for that though.
* Call filter hooks on inlined page content.
+ * Support inlining pages raw, rather than creating a blog.
+ * Clean up yes/no parameter parsing in inline plugin.
+ * Implemented better cycle detection in the inline plugin; nested inlines
+ will now work.
- -- Joey Hess <joeyh@debian.org> Thu, 17 Aug 2006 20:39:20 -0400
+ -- Joey Hess <joeyh@debian.org> Thu, 17 Aug 2006 23:27:38 -0400
ikiwiki (1.20) unstable; urgency=low
diff --git a/doc/plugins/inline.mdwn b/doc/plugins/inline.mdwn
index 3226e01fe..0f0de5c42 100644
--- a/doc/plugins/inline.mdwn
+++ b/doc/plugins/inline.mdwn
@@ -1,5 +1,28 @@
-Allows including one wiki page inside another, generating blogs and RSS
-feeds. See [[blog]] for details.
+This is a [[PreProcessorDirective]] that allows including one wiki page
+inside another. For example:
+
+ \[[inline pages="blog/*"]]
+
+The most common use of inlining is generating blogs and RSS feeds.
+See [[blog]] for details.
+
+## usage
+
+Here are descriptions of all the supported parameters to the `inline`
+directive:
+
+* `pages` - A [[PageSpec]] of the pages to inline.
+* `show` - Specify the maximum number of matching pages to inline.
+ Default is 10, unless archiving, when the default is to show all.
+ Set to 0 to show all matching pages.
+* `rss` - Controls generation of an RSS feed. On by default, set to "no" to
+ disable.
+* `rootpage` - Enables a form to post new pages to a [[blog]].
+* `archive` - If set to "yes", only list page titles and some metadata, not
+ full controls.
+* `raw` - Rather than the default behavior of creating a [[blog]],
+ if raw is set to "yes", the page will be included raw, without additional
+ markup around it, as if it were a literal part of the inlining page.
This plugin is enabled by default.