IkiWiki/Plugin/sidebar.pm

   1 #!/usr/bin/perl
   2 # Sidebar plugin.
   3 # by Tuomo Valkonen <tuomov at iki dot fi>
   4
   5 package IkiWiki::Plugin::sidebar;
   6
   7 use warnings;
   8 use strict;
   9 use IkiWiki;
  10
  11 sub import { #{{{
  12         IkiWiki::hook(type => "pagetemplate", id => "sidebar",
  13                 call => \&pagetemplate);
  14 } # }}}
  15
  16 sub sidebar_content ($) { #{{{
  17         my $page=shift;
  18
  19         my $sidebar_page=IkiWiki::bestlink($page, "sidebar") || return;
  20         my $sidebar_file=$IkiWiki::pagesources{$sidebar_page} || return;
  21         my $sidebar_type=IkiWiki::pagetype($sidebar_file);
  22
  23         if (defined $sidebar_type) {
  24                 # FIXME: This isn't quite right; it won't take into account
  25                 # adding a new sidebar page. So adding such a page
  26                 # currently requires a wiki rebuild.
  27                 IkiWiki::add_depends($page, $sidebar_page);
  28
  29                 my $content=IkiWiki::readfile(IkiWiki::srcfile($sidebar_file));
  30                 return unless length $content;
  31                 return IkiWiki::htmlize($sidebar_type,
  32                        IkiWiki::linkify($sidebar_page, $page,
  33                        IkiWiki::preprocess($sidebar_page, $page,
  34                        IkiWiki::filter($sidebar_page, $content))));
  35         }
  36
  37 } # }}}
  38
  39 sub pagetemplate (@) { #{{{
  40         my %params=@_;
  41
  42         my $page=$params{page};
  43         my $template=$params{template};
  44
  45         if ($template->query(name => "sidebar")) {
  46                 my $content=sidebar_content($page);
  47                 if (defined $content && length $content) {
  48                         $template->param(sidebar => $content);
  49                 }
  50         }
  51 } # }}}
  52
  53 1