doc/bugs/wrong_rendering_of_templatebody.mdwn

   1 I recently moved from Trisquel's version of ikiwiki (from 2013, the same one of
   2 Debian wheezy backports) to the version 5.20141016 which I built from git, by
   3 pulling the tag. One of the new things I have now is the templatebody
   4 directive.
   5
   6 > Not directly relevant to this bug, but if you want the latest ikiwiki release
   7 > for a Debian derivative, you can fetch it from Debian unstable (normally)
   8 > or Debian experimental (during the Debian release freeze, e.g. now) -
   9 > the correct way is to get the (signed) source package with `dget`
  10 > or similar, check the GPG signature (which should be from me or Joey), and
  11 > rebuild it for your distribution. Just getting the binary `.deb` from Debian
  12 > is a little more risky, depending how far your distribution has diverged from
  13 > Debian, but in the case of ikiwiki it should usually work fine in practice.
  14 > --[[smcv]]
  15
  16 I started using it in my templates, and I suddenly notice strange behavior: one
  17 of my templates renders as the *rest* of the template page when used, instead of
  18 the body part. In other words, it renders exactly the part it should hide (the
  19 description) and ignores the body itself (which is inside \[[!templatebody]]).
  20
  21 When I manually re-generate the wiki, it suddenly renders right. As soon as the
  22 page gets rebuilt automatically after some git push, it renders the wrong way.
  23
  24 > Where did you install the newer ikiwiki? `/usr/local`? Somewhere else?
  25 >
  26 > It sounds to me as though manual re-generation is using ikiwiki ≥ 3.20140916
  27 > with the `templatebody` directive enabled, but the git hook is using
  28 > ikiwiki < 3.20140916 and/or has the `templatebody` disabled. This might
  29 > result from having a different `PERL5LIB` environment variable in
  30 > the two situations, for instance.
  31 >
  32 > It might help to debug this if you edit your older and newer ikiwiki's
  33 > `IkiWiki.pm`, `IkiWiki/Render.pm` and/or `IkiWiki/Plugin/templatebody.pm`
  34 > so they do `print STDERR "loaded (old/new) (whatever).pm"` at some fairly
  35 > early stage - I would suggest `getsetup()`, `refresh()` and `import()`
  36 > respectively. --[[smcv]]
  37
  38 >> Yes, I installed in `/usr/local`, but I also removed the deb package. So I
  39 >> only have 1 ikiwiki version now.
  40 >>
  41 >> I also noticed the following behavior. I created a set of pages, each of them
  42 >> containing several occurences of a certain template. Then I created another
  43 >> page, which inlines all of them. All good. Then, I edited that main page to do
  44 >> different sorting (using inline directive's sort option). After comitting the change,
  45 >> suddenly all the inlined pages have the templates inside them contain the
  46 >> template info instead of template body. How is that even related to the minor
  47 >> change I did - change the sorting? :-P
  48 >>
  49 >> I'll look at the templatebody.pm file and try debug prints. I hope I can see them in
  50 >> the git push output, because rendering the wiki from command line doesn't have this
  51 >> problem.
  52 >>
  53 >> One more thing, my setup uses the pingee plugin. When doing a git push, it browses to
  54 >> the wiki page using wget with `?do=ping` parameter, and then ikiwiki responds by rebuilding
  55 >> the necessary pages.
  56 >>
  57 >> Thanks for the pointers.
  58 >>
  59 >> --[[fr33domlover]]
  60
  61
  62 [[This|http://www.rel4tion.org/languages/haskell/]] is the page, and
  63 [[this|http://www.rel4tion.org/templates/wikitag/]] is a template it uses. Right
  64 now the template is rendered on that page exactly like the template page itself.
  65 Both display the description text, and the \[[!templatebody]] content isn't
  66 displayed at all.
  67
  68 If I debug it myself and find something relevant, I'll update here.
  69
  70 -- [[fr33domlover]]