doc/todo/publishing_in_the_future.mdwn

   1 [[!tag wishlist]]I would quite like the ability to write a page (blog post in
   2 practice) but for the page to not be displayed until a date and time after it
   3 is added to the wiki. I've thought this through a bit, but would appreciate
   4 feedback from people before I go any further. Would anyone else find this
   5 useful?
   6
   7 Thinking about how to implement this in ikiwiki, perhaps a conditional
   8 pagespec would be best (which could be tidied up into a template)
   9
  10     \[[!if test="current_date_before(<TMPL_VAR date>)"
  11     then="""[[!tag draft]]"""
  12     else="""[[!meta date="<TMPL_VAR date>"]]"""
  13     ]]
  14
  15 …pre-supposing a scheme whereby tagging 'draft' hides the page from an
  16 aggregation somewhere.  With a template, this could collapse to
  17
  18     \[[!template id=publishafter date="Thu Aug 30 14:13:06 BST 2012"]]
  19
  20 This would require implementing the `current_date_before` pagespec.
  21
  22 You would also need a regularly scheduled wiki refresh and a way of marking the
  23 unpublished pages as 'dirty' so they were always scanned on refresh until their
  24 publish date has occurred. That could perhaps be implemented via a small plugin
  25 which defined a pagespec which ensured the page was 'dirty':
  26
  27     \[[!if test="current_date_before(<TMPL_VAR date>)"
  28     then="""[[!tag draft]][[!dirty]]"""
  29     else="""[[!meta date="<TMPL_VAR date>"]]"""
  30     ]]
  31
  32 The following is an attempt at the dirty part:
  33
  34     #!/usr/bin/perl
  35     package IkiWiki::Plugin::dirty;
  36     # provides a pagespec 'dirty' which ensures the page will always be
  37     # re-scanned for content on wiki refresh.
  38
  39     use warnings;
  40     use strict;
  41     use IkiWiki 3.00;
  42
  43     hook(type => "preprocess", id => "dirty", call => \&preprocess);
  44     hook(type => "needsbuild", id => "dirty", call => \&needsbuild);
  45
  46     sub preprocess (@) {
  47       my %params = @_;
  48       $pagestate{$params{page}}{dirty}{dirty} = 1;
  49       return '';
  50     }
  51
  52     sub needsbuild (@) {
  53       my $pages= shift;
  54       my %p2 = map { $_ => 1 } @$pages;
  55       my %d2 = map { $_ => 1 } @$deleted;
  56
  57       foreach my $page (keys %pagestate) {
  58         if(exists $pagestate{$page}{dirty}{dirty}) {
  59           push @$pages, $pagesources{$page} unless
  60             (exists $p2{$pagesources{$page}} or exists $d2{$pagesources{$page}});
  61           delete $pagestate{$page}{dirty}{dirty};
  62         }
  63       }
  64
  65       return $pages;
  66     }
  67
  68     1
  69
  70 Although it doesn't fit, the `current_date_before` pagespec could be implemented
  71 in the same plugin. I tried the following (before the trailing `1`):
  72
  73     package IkiWiki::PageSpec;
  74     use Date::Parse;
  75
  76     sub match_current_date_before ($$;@) {
  77       shift;
  78       my $date = shift;
  79       my $out = str2time($date);
  80       if(defined $out) {
  81         return IkiWiki::SuccessReason->new("time before now") if $out < time();
  82         return IkiWiki::FailReason->new("time not before now");
  83       } else { return IkiWiki::ErrorReason->new("couldn't parse time $date")};
  84     }
  85
  86 I always hit the `ErrorReason` branch when I try to use it, even with strings
  87 which work fine in test scripts.  If anyone can help me debug that I'd be very
  88 grateful.
  89 If anyone has any clues as to why this doesn't work
  90
  91 Thoughts on the whole idea? — [[Jon]]
  92
  93 > There is an old todo about it: [[tagging_with_a_publication_date]].
  94 > I feel my idea there about making a pagespec that is limited to
  95 > items in the present/past, combined with setting the meta data, is a good
  96 > way.. --[[Joey]]