IkiWiki/Plugin/shortcut.pm

   1 #!/usr/bin/perl
   2 package IkiWiki::Plugin::shortcut;
   3
   4 use warnings;
   5 use strict;
   6 use IkiWiki 3.00;
   7
   8 sub import {
   9         hook(type => "getsetup", id => "shortcut", call => \&getsetup);
  10         hook(type => "checkconfig", id => "shortcut", call => \&checkconfig);
  11         hook(type => "preprocess", id => "shortcut", call => \&preprocess_shortcut);
  12 }
  13
  14 sub getsetup () {
  15         return
  16                 plugin => {
  17                         safe => 1,
  18                         rebuild => undef,
  19                         section => "widget",
  20                 },
  21 }
  22
  23 sub checkconfig () {
  24         if (defined $config{srcdir} && length $config{srcdir}) {
  25                 # Preprocess the shortcuts page to get all the available shortcuts
  26                 # defined before other pages are rendered.
  27                 my $srcfile=srcfile("shortcuts.".$config{default_pageext}, 1);
  28                 if (! defined $srcfile) {
  29                         $srcfile=srcfile("shortcuts.mdwn", 1);
  30                 }
  31                 if (! defined $srcfile) {
  32                         print STDERR sprintf(gettext("shortcut plugin will not work without %s"),
  33                                 "shortcuts.".$config{default_pageext})."\n";
  34                 }
  35                 else {
  36                         IkiWiki::preprocess("shortcuts", "shortcuts", readfile($srcfile));
  37                 }
  38         }
  39 }
  40
  41 sub preprocess_shortcut (@) {
  42         my %params=@_;
  43
  44         if (! defined $params{name} || ! defined $params{url}) {
  45                 error gettext("missing name or url parameter");
  46         }
  47
  48         hook(type => "preprocess", no_override => 1, id => $params{name},
  49                 shortcut => 1,
  50                 call => sub { shortcut_expand($params{url}, $params{desc}, @_) });
  51
  52         #translators: This is used to display what shortcuts are defined.
  53         #translators: First parameter is the name of the shortcut, the second
  54         #translators: is an URL.
  55         return sprintf(gettext("shortcut %s points to <i>%s</i>"), $params{name}, $params{url});
  56 }
  57
  58 sub shortcut_expand ($$@) {
  59         my $url=shift;
  60         my $desc=shift;
  61         my %params=@_;
  62
  63         # Get params in original order.
  64         my @params;
  65         while (@_) {
  66                 my $key=shift;
  67                 my $value=shift;
  68                 push @params, $key if ! length $value;
  69         }
  70
  71         # If the shortcuts page changes, all pages that use shortcuts will
  72         # need to be updated.
  73         add_depends($params{destpage}, "shortcuts");
  74
  75         my $text=join(" ", @params);
  76
  77         $url=~s{\%([sSW])}{
  78                 if ($1 eq 's') {
  79                         my $t=$text;
  80                         $t=~s/([^A-Za-z0-9])/sprintf("%%%02X", ord($1))/seg;
  81                         $t;
  82                 }
  83                 elsif ($1 eq 'S') {
  84                         $text;
  85                 }
  86                 elsif ($1 eq 'W') {
  87                         my $t=Encode::encode_utf8($text);
  88                         $t=~s/([^A-Za-z0-9])/sprintf("%%%02X", ord($1))/seg;
  89                         $t;
  90                 }
  91         }eg;
  92
  93         $text=~s/_/ /g;
  94         if (defined $params{desc}) {
  95                 $desc=$params{desc};
  96         }
  97         if (defined $desc) {
  98                 $desc=~s/\%s/$text/g;
  99         }
 100         else {
 101                 $desc=$text;
 102         }
 103
 104         return "<a href=\"$url\">$desc</a>";
 105 }
 106
 107 1