ikiwiki (3.20130711) unstable; urgency=low
[ikiwiki.git] / doc / plugins / contrib / ftemplate / discussion.mdwn
1 I initially thought this wasn't actually necessary - the combination
2 of [[plugins/template]] with [[plugins/contrib/field]]'s `pagetemplate`
3 hook ought to provide the same functionality. However, `template`
4 doesn't run `pagetemplate` hooks; a more general version of this
5 plugin would be to have a variant of `template` that runs `pagetemplate`
6 hooks (probably easiest to just patch `template` to implement a
7 second directive, or have a special parameter `run_hooks="yes"`,
8 or something).
9
10 > I got the impression that `pagetemplate` hooks are intended to be completely independent of `template` variables; page-template is for the actual `page.tmpl` template, while `template` is for other templates which are used inside the page content.  So I don't understand why one would need a run_hooks option. --[[KathrynAndersen]]
11
12 >> `Render`, `inline`, `comments` and `recentchanges` run `pagetemplate`
13 >> hooks, as does anything that uses `IkiWiki::misctemplate`. From that
14 >> quick survey, it seems as though `template` is the only thing that
15 >> uses `HTML::Template` but *doesn't* run `pagetemplate` hooks?
16 >>
17 >> It just seems strange to me that `field` needs to have its own
18 >> variant of `template` (this), its own variant of `inline` (`report`),
19 >> and so on - I'd tend to lean more towards having `field`
20 >> enhance the existing plugins. I'm not an ikiwiki committer,
21 >> mind... Joey, your opinion would be appreciated! --[[smcv]]
22
23 >>> I did it that way basically because I needed the functionality ASAP, and I didn't want to step on anyone's toes, so I made them as separate plugins.  If Joey wants to integrate the functionality into IkiWiki proper, I would be very happy, but I don't want to put pressure on him. --[[KathrynAndersen]]
24
25 Another missing thing is that `ftemplate` looks in
26 the "system" templates directories, not just in the wiki, but that
27 seems orthogonal (and might be a good enhancement to `template` anyway).
28 --[[smcv]]
29
30 > Yes, I added that because I wanted the option of not having to make all my templates work as wiki pages also. --[[KathrynAndersen]]
31
32 >> Joey has added support for
33 >> [[todo/user-defined_templates_outside_the_wiki]] now. --s