diff options
Diffstat (limited to '.library/IkiWiki/Plugin/license.pm')
-rw-r--r-- | .library/IkiWiki/Plugin/license.pm | 89 |
1 files changed, 89 insertions, 0 deletions
diff --git a/.library/IkiWiki/Plugin/license.pm b/.library/IkiWiki/Plugin/license.pm new file mode 100644 index 00000000..e608461f --- /dev/null +++ b/.library/IkiWiki/Plugin/license.pm @@ -0,0 +1,89 @@ +# A plugin for ikiwiki to implement adding a footer with licensing information +# to every rendered page. + +# Copyright © 2007 Thomas Schwinge <tschwinge@gnu.org> +# +# This program is free software; you can redistribute it and/or modify it +# under the terms of the GNU General Public License as published by the +# Free Software Foundation; either version 2, or (at your option) any later +# version. +# +# This program is distributed in the hope that it will be useful, but +# WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY +# or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License +# for more details. +# +# You should have received a copy of the GNU General Public License along +# with this program; if not, write to the Free Software Foundation, Inc., +# 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA. + +# A footer with licensing information will be added to every rendered page if +# either (a) a file `license.mdwn' is found (using the same rules as for the +# sidebar plugin) or (b) (which be used to override (a)) a statement à la +# ``[[license text=WHATEVER]]'' is found in the source page. +# +# The state which page's license text was gathered from which source is not +# tracked, so you'll need a full wiki-rebuild if (a)'s files are changed. + +package IkiWiki::Plugin::license; + +use warnings; +use strict; +use IkiWiki 2.00; + +sub import +{ + hook (type => "preprocess", id => "license", call => \&preprocess); + hook (type => "pagetemplate", id => "license", call => \&pagetemplate); +} + +my %text; + +sub preprocess (@) +{ + my %params = @_; + my $page = $params {page}; + + # We don't return any text here, but record the passed text. + $text {$page} = $params {text}; + return ""; +} + +sub pagetemplate (@) +{ + my %params = @_; + my $page = $params {page}; + my $destpage = $params {destpage}; + + my $template = $params {template}; + + if ($template->query (name => "license")) + { + my $content; + my $pagetype; + if (defined $text {$page}) + { + $pagetype = pagetype ($pagesources {$page}); + $content = $text {$page}; + } + else + { + my $license_page = bestlink ($page, "license") || return; + my $license_file = $pagesources {$license_page} || return; + $pagetype = pagetype ($license_file); + $content = readfile (srcfile ($license_file)); + } + + if (defined $content && length $content) + { + $template->param (license => + IkiWiki::htmlize ($destpage, $pagetype, + IkiWiki::linkify ($page, $destpage, + IkiWiki::preprocess ($page, $destpage, + IkiWiki::filter ($page, $destpage, $content))))); + + } + } +} + +1 |