doc/patchqueue/datearchives-plugin.mdwn

   1 I'll be using IkiWiki primarily as a blog, so I want a way to view entries by date. A URL of the form `/date/YYYY/MM/DD.html` (or `/date/YYYY/MM/DD/` when using the `use_dirs` patch) should show posts from that period. ATM, I have this:
   2
   3 <pre>
   4 Index: IkiWiki/Plugin/datearchives.pm
   5 ===================================================================
   6 --- IkiWiki/Plugin/datearchives.pm      (revision 0)
   7 +++ IkiWiki/Plugin/datearchives.pm      (revision 0)
   8 @@ -0,0 +1,31 @@
   9 +#!/usr/bin/perl
  10 +
  11 +package IkiWiki::Plugin::datearchives;
  12 +
  13 +use warnings;
  14 +use strict;
  15 +use IkiWiki;
  16 +
  17 +sub import { #{{{
  18 +    hook(type => "pagetemplate", id => "datearchives", call => \&pagetemplate, scan => 1);
  19 +} # }}}
  20 +
  21 +sub pagetemplate (@) { #{{{
  22 +    my %args = @_;
  23 +    my $dt;
  24 +    eval {
  25 +        use DateTime;
  26 +        $dt = DateTime->from_epoch(epoch => $IkiWiki::pagectime{ $args{page} });
  27 +    };
  28 +    return if $@;
  29 +    my $base = $config{datearchives_base} || 'date';
  30 +    my $link = $base.'/'.$dt->strftime('%Y/%m/%d');
  31 +    push @{$links{$args{page}}}, $link;
  32 +    my $template = $args{template};
  33 +       if ($template->query(name => "ctime")) {
  34 +        $template->param(ctime => htmllink( $args{page}, $args{destpage}, $link, 0, 0,
  35 +                                            $template->param('ctime')));
  36 +       }
  37 +} # }}}
  38 +
  39 +1
  40 </pre>
  41
  42 This works (although accessing `%IkiWiki::pagectime` is not too clever), but it would be far more useful if the date pages were automatically created and populated with the relevant posts. A [[Pagespec]] works perfectly for displaying the relevant content, but we're still left with the issue of actually creating the page. What's the Right Way to do this? We could create them in the RCS working copy and check them in, or create them directly in the output directory... (I'd also like to create an option for the tags plugin to auto-create its targets in the same way). Any opinions? :-)
  43
  44 > Ok, first, I don't understand what your plugin does. Maybe I need to get
  45 > some sleep, but a better explanation might help. :-) It seems to make
  46 > links from pages to the archive pages? But I don't understand why you
  47 > want such links .. wouldn't a sidebar with links to the available archive
  48 > pages work better? Or something else, depending on personal preference.
  49 >
  50 > Secondly, you're certianly not the first to wat to do data based archive
  51 > pages. So far I have successfully punted the issue of creating these
  52 > pages out of ikiwiki by pointing out that everyone wants them to be
  53 > _different_, and suggesting people set up cron jobs or other machinery to
  54 > generate the kinds of archives that they like. This makes me happy
  55 > because generalizing all the possible ways people might want to do date
  56 > based archives and somehow bolting support for creating them onto the
  57 > size of ikiwiki seems to be a recipe for a mess.
  58 >
  59 > A few examples of ikiwiki sites with date archives:
  60 > <http://www.golden-gryphon.com/blog/manoj/> and
  61 > <http://roland.entierement.nu/categories/geek-en.html> --[[Joey]]
  62
  63 >> Yeah, it wasn't much of a description, was it? ;-) It's an attempt to emulate the style of Wordpress and other popular blog platforms, which can link a post's creation date to  YYY/MM/DD archive pages, which then list all the relevant posts. My use-case is on a blog page which in-lines (via pagespecs) recent blog posts.
  64
  65 >> I agree with not adding this kind of functionality to the core. :-) I simply didn't want to have break links when I convert to IkiWiki. I guess I'll just play around with the page-creation thing myself then. Feel free to delete this from the queue. :-) --Ben
  66
  67 >>> Ah, I get it, I hadn't realized it was making the date into a link.
  68 >>> No reason to delete this from the queue, it's a reasonable plugin. I
  69 >>> might move it to the contributed plugins directory as it's a bit
  70 >>> specialised to be included in ikiwiki though. --[[Joey]]