]> git.vanrenterghem.biz Git - git.ikiwiki.info.git/blob - IkiWiki/Plugin/htmltidy.pm
Silence "used only once: possible typo" warnings for variables that are part of modul...
[git.ikiwiki.info.git] / IkiWiki / Plugin / htmltidy.pm
1 #!/usr/bin/perl
2 # HTML Tidy plugin
3 # requires 'tidy' binary, found in Debian or http://tidy.sf.net/
4 # mostly a proof-of-concept on how to use external filters.
5 # It is particularly useful when the html plugin is used.
6 #
7 # by Faidon Liambotis
8 package IkiWiki::Plugin::htmltidy;
10 use warnings;
11 use strict;
12 use IkiWiki 3.00;
13 use IPC::Open2;
15 sub import {
16         hook(type => "getsetup", id => "tidy", call => \&getsetup);
17         hook(type => "sanitize", id => "tidy", call => \&sanitize);
18         hook(type => "checkconfig", id => "tidy", call => \&checkconfig);
19 }
21 sub getsetup () {
22         return
23                 plugin => {
24                         safe => 1,
25                         rebuild => undef,
26                 },
27                 htmltidy => {
28                         type => "string",
29                         description => "tidy command line",
30                         safe => 0, # path
31                         rebuild => undef,
32                 },
33 }
35 sub checkconfig () {
36         if (! defined $config{htmltidy}) {
37                 $config{htmltidy}="tidy -quiet -asxhtml -utf8 --show-body-only yes --show-warnings no --tidy-mark no --markup yes";
38         }
39 }
41 sub sanitize (@) {
42         my %params=@_;
44         return $params{content} unless defined $config{htmltidy};
46         my $pid;
47         my $sigpipe=0;
48         $SIG{PIPE}=sub { $sigpipe=1 };
49         $pid=open2(*IN, *OUT, "$config{htmltidy} 2>/dev/null");
51         # open2 doesn't respect "use open ':utf8'"
52         binmode (IN, ':utf8');
53         binmode (OUT, ':utf8');
54         
55         print OUT $params{content};
56         close OUT;
58         local $/ = undef;
59         my $ret=<IN>;
60         close IN;
61         waitpid $pid, 0;
63         $SIG{PIPE}="DEFAULT";
64         if ($sigpipe || ! defined $ret) {
65                 return gettext("htmltidy failed to parse this html");
66         }
68         return $ret;
69 }
71 1