use perl modules up front
[ikiwiki] / IkiWiki / Plugin / table.pm
1 package IkiWiki::Plugin::table;
2 # by Victor Moral <victor@taquiones.net>
3
4 use warnings;
5 use strict;
6 use Encode;
7 use IkiWiki 2.00;
8
9 sub import { #{{{
10         hook(type => "getsetup", id => "table", call => \&getsetup);
11         hook(type => "preprocess", id => "table", call => \&preprocess);
12 } # }}}
13
14 sub getsetup () { #{{{
15         return
16                 plugin => {
17                         safe => 1,
18                         rebuild => undef,
19                 },
20 } #}}}
21
22 sub preprocess (@) { #{{{
23         my %params =(
24                 format  => 'auto',
25                 header  => 'row',
26                 @_
27         );
28
29         if (exists $params{file}) {
30                 if (! $pagesources{$params{file}}) {
31                         error gettext("cannot find file");
32                 }
33                 $params{data} = readfile(srcfile($params{file}));
34                 add_depends($params{page}, $params{file});
35         }
36
37         if (lc $params{format} eq 'auto') {
38                 # first try the more simple format
39                 if (is_dsv_data($params{data})) {
40                         $params{format} = 'dsv';
41                 }
42                 else {
43                         $params{format} = 'csv';
44                 }
45         }
46
47         my @data;
48         if (lc $params{format} eq 'csv') {
49                 @data=split_csv($params{data},
50                         defined $params{delimiter} ? $params{delimiter} : ",",);
51                 # linkify after parsing since html link quoting can
52                 # confuse CSV parsing
53                 if (! exists $params{file}) {
54                         @data=map {
55                                 [ map {
56                                         IkiWiki::linkify($params{page},
57                                                 $params{destpage}, $_);
58                                 } @$_ ]
59                         } @data;
60                 }
61         }
62         elsif (lc $params{format} eq 'dsv') {
63                 # linkify before parsing since wikilinks can contain the
64                 # delimiter
65                 if (! exists $params{file}) {
66                         $params{data} = IkiWiki::linkify($params{page},
67                                 $params{destpage}, $params{data});
68                 }
69                 @data=split_dsv($params{data},
70                         defined $params{delimiter} ? $params{delimiter} : "|",);
71         }
72         else {
73                 error gettext("unknown data format");
74         }
75
76         my $header;
77         if (lc($params{header}) eq "row" || IkiWiki::yesno($params{header})) {
78                 $header=shift @data;
79         }
80         if (! @data) {
81                 error gettext("empty data");
82         }
83
84         my @lines;
85         push @lines, defined $params{class}
86                         ? "<table class=\"".$params{class}.'">'
87                         : '<table>';
88         push @lines, "\t<thead>",
89                 genrow(\%params, "th", @$header),
90                 "\t</thead>" if defined $header;
91         push @lines, "\t<tbody>" if defined $header;
92         push @lines, genrow(\%params, "td", @$_) foreach @data;
93         push @lines, "\t</tbody>" if defined $header;
94         push @lines, '</table>';
95         my $html = join("\n", @lines);
96
97         if (exists $params{file}) {
98                 return $html."\n\n".
99                         htmllink($params{page}, $params{destpage}, $params{file},
100                                 linktext => gettext('Direct data download'));
101         }
102         else {  
103                 return $html;
104         }            
105 } #}}}
106
107 sub is_dsv_data ($) { #{{{
108         my $text = shift;
109
110         my ($line) = split(/\n/, $text);
111         return $line =~ m{.+\|};
112 }
113
114 sub split_csv ($$) { #{{{
115         my @text_lines = split(/\n/, shift);
116         my $delimiter = shift;
117
118         eval q{use Text::CSV};
119         error($@) if $@;
120         my $csv = Text::CSV->new({ 
121                 sep_char        => $delimiter,
122                 binary          => 1,
123                 allow_loose_quotes => 1,
124         }) || error("could not create a Text::CSV object");
125         
126         my $l=0;
127         my @data;
128         foreach my $line (@text_lines) {
129                 $l++;
130                 if ($csv->parse($line)) {
131                         push(@data, [ map { decode_utf8 $_ } $csv->fields() ]);
132                 }
133                 else {
134                         debug(sprintf(gettext('parse fail at line %d: %s'), 
135                                 $l, $csv->error_input()));
136                 }
137         }
138
139         return @data;
140 } #}}}
141
142 sub split_dsv ($$) { #{{{
143         my @text_lines = split(/\n/, shift);
144         my $delimiter = shift;
145         $delimiter="|" unless defined $delimiter;
146
147         my @data;
148         foreach my $line (@text_lines) {
149                 push @data, [ split(/\Q$delimiter\E/, $line, -1) ];
150         }
151     
152         return @data;
153 } #}}}
154
155 sub genrow ($@) { #{{{
156         my %params=%{shift()};
157         my $elt = shift;
158         my @data = @_;
159
160         my $page=$params{page};
161         my $destpage=$params{destpage};
162         my $type=pagetype($pagesources{$page});
163
164         my @ret;
165         push @ret, "\t\t<tr>";
166         for (my $x=0; $x < @data; $x++) {
167                 my $cell=IkiWiki::htmlize($page, $destpage, $type,
168                          IkiWiki::preprocess($page, $destpage, $data[$x]));
169
170                 # automatic colspan for empty cells
171                 my $colspan=1;
172                 while ($x+1 < @data && $data[$x+1] eq '') {
173                         $x++;
174                         $colspan++;
175                 }
176
177                 # check if the first column should be a header
178                 my $e=$elt;
179                 if ($x == 0 && lc($params{header}) eq "column") {
180                         $e="th";
181                 }
182
183                 if ($colspan > 1) {
184                         push @ret, "\t\t\t<$e colspan=\"$colspan\">$cell</$e>"
185                 }
186                 else {
187                         push @ret, "\t\t\t<$e>$cell</$e>"
188                 }
189         }
190         push @ret, "\t\t</tr>";
191
192         return @ret;
193 } #}}}
194
195 1