Merge branch 'master' of ssh://git.ikiwiki.info/srv/git/ikiwiki.info
[ikiwiki] / doc / todo / Allow_per-page_template_selection.mdwn
1 It'd be nice to be able to specify an altenate template file to be
2 used for some pages. For example, I'd like most of my pages to use
3 page.tmpl but I want my front page to be formatted in some unique way,
4 so I'd like it to use a separate front.tmp template instead.
5
6 I'm not sure what syntax to use for this, (\[[template]] seems to be
7 taken for another purpose already). Perhaps something like
8 \[[page-template front]] ?).
9
10 Joey provided a nice suggestion for implementing this feature, ("I
11 would probably add a hook that allowed overriding the default template
12 constuction and returning a template object"). I did start looking
13 into that, but finally I wimped out and just put the following hack
14 into the `genpage()` function in Render.pm:
15
16
17         if ($page eq 'index') {
18                 $template->param(suppresstitle => 1);
19         }
20
21 That lets me use a `<TMPL_UNLESS SUPPRESSTITLE>` in my template to get
22 the effect I want. I don't think that's anything that upstream should
23 pick-up as is, (maybe with an appropriate configuration option, but
24 then again allowing for per-page template selection would be more
25 powerful anyway). But I'm happy enough now that I probably won't
26 pursue implementing this feature further myself.
27
28 But I'd still happily switch to using this feature if someone were to
29 implement it.
30
31 UPDATE: My latest hack is as follows:
32
33         if ($page eq 'index') {
34                 $template->param(toplevelindex => 1);
35         }
36
37 And that's something that I'm not actually embarrassed to suggest
38 could be accepted upstream. Joey, what do you think? And would a
39 proper patch be helpful (it really just adds those lines to the right
40 place).
41
42 > Fully implemented as a templatefile hook and a [[plugins/pagetemplate]]
43 > plugin. --[[Joey]] [[done]]