doc/todo/pedigree_plugin.mdwn

   1 After realizing (thanks to
   2 [[Allow_TITLE_to_include_part_of_the_path_in_addition_to_the_basename]])
   3 that I needed some kind of "parentlinks on steroids", I wrote a new
   4 plugin, called pedigree.
   5
   6 This plugin provides a bunch of loops that one can use in his/her
   7 `HTML::Template`'s to iterate over all or a subset of a page's
   8 parents. Inside these loops, half a dozen variables are made
   9 available, in addition to `PAGE` and `URL` that are already provided
  10 by parentlinks.
  11
  12 Amongst many possibilities, one can e.g. simply use this plugin to
  13 give every parent link a different `class=` attribute, depending
  14 either on its depth in the path leading to the current page, or on its
  15 distance to it.
  16
  17 The code and documentation (including simple and complex usage
  18 examples) are in the 'pedigree' Git branch in this repo:
  19
  20         git://repo.or.cz/ikiwiki/intrigeri.git
  21
  22 Seems there is also a [gitweb](http://repo.or.cz/w/ikiwiki/intrigeri.git).
  23
  24 Any opinions on the idea/design/implementation?
  25
  26 What needs to be changed so that it's possible to include it in
  27 mainline ikiwiki?
  28
  29 (I'll try never to rebase this branch, but writing this plugin has
  30 been a pretext for me to start learning Git, so...)
  31
  32 To finish with, it seems no plugin bundled with ikiwiki uses the current parentlinks implementation, so one could event think of moving it from the core to this plugin (which should then be enabled by default, since the default templates do use parentlinks ;).