Added a comment
[ikiwiki] / IkiWiki / Plugin / toggle.pm
1 #!/usr/bin/perl
2 package IkiWiki::Plugin::toggle;
3
4 use warnings;
5 use strict;
6 use IkiWiki 3.00;
7
8 sub import {
9         add_underlay("javascript");
10         hook(type => "getsetup", id => "toggle", call => \&getsetup);
11         hook(type => "preprocess", id => "toggle",
12                 call => \&preprocess_toggle);
13         hook(type => "preprocess", id => "toggleable",
14                 call => \&preprocess_toggleable);
15         hook(type => "format", id => "toggle", call => \&format);
16 }
17
18 sub getsetup () {
19         return
20                 plugin => {
21                         safe => 1,
22                         rebuild => undef,
23                         section => "widget",
24                 },
25 }
26
27 sub genid ($$) {
28         my $page=shift;
29         my $id=shift;
30
31         $id="$page.$id";
32
33         # make it a legal html id attribute
34         $id=~s/[^-a-zA-Z0-9.]/-/g;
35         if ($id !~ /^[a-zA-Z]/) {
36                 $id="id$id";
37         }
38         return $id;
39 }
40
41 sub preprocess_toggle (@) {
42         my %params=(id => "default", text => "more", @_);
43
44         my $id=genid($params{page}, $params{id});
45         return "<a class=\"toggle\" href=\"#$id\">$params{text}</a>";
46 }
47
48 sub preprocess_toggleable (@) {
49         my %params=(id => "default", text => "", open => "no", @_);
50
51         # Preprocess the text to expand any preprocessor directives
52         # embedded inside it.
53         $params{text}=IkiWiki::preprocess($params{page}, $params{destpage}, $params{text});
54         
55         my $id=genid($params{page}, $params{id});
56         my $class=(lc($params{open}) ne "yes") ? "toggleable" : "toggleable-open";
57
58         # Should really be a postprocessor directive, oh well. Work around
59         # markdown's dislike of markdown inside a <div> with various funky
60         # whitespace.
61         my ($indent)=$params{text}=~/( +)$/;
62         $indent="" unless defined $indent;
63         return "<div class=\"$class\" id=\"$id\"></div>\n\n$params{text}\n$indent<div class=\"toggleableend\"></div>";
64 }
65
66 sub format (@) {
67         my %params=@_;
68
69         if ($params{content}=~s!(<div class="toggleable(?:-open)?" id="[^"]+">\s*)</div>!$1!g) {
70                 $params{content}=~s/<div class="toggleableend">//g;
71                 if (! ($params{content}=~s!^(<body[^>]*>)!$1.include_javascript($params{page})!em)) {
72                         # no <body> tag, probably in preview mode
73                         $params{content}=include_javascript(undef).$params{content};
74                 }
75         }
76         return $params{content};
77 }
78
79 sub include_javascript ($) {
80         my $from=shift;
81         
82         return '<script src="'.urlto("ikiwiki/ikiwiki.js", $from).
83                 '" type="text/javascript" charset="utf-8"></script>'."\n".
84                 '<script src="'.urlto("ikiwiki/toggle.js", $from).
85                 '" type="text/javascript" charset="utf-8"></script>';
86 }
87
88 1