2 # Common functions for HTML/XHTML output generation
3 # Copyright (C) 2003 Jan Kratochvil <project-www.jankratochvil.net@jankratochvil.net>
5 # This program is free software; you can redistribute it and/or modify
6 # it under the terms of the GNU General Public License as published by
7 # the Free Software Foundation; exactly version 2 of June 1991 is required
9 # This program is distributed in the hope that it will be useful,
10 # but WITHOUT ANY WARRANTY; without even the implied warranty of
11 # MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
12 # GNU General Public License for more details.
14 # You should have received a copy of the GNU General Public License
15 # along with this program; if not, write to the Free Software
16 # Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA
20 require 5.6.0; # at least 'use warnings;' but we need some 5.6.0+ modules anyway
21 our $VERSION=do { my @r=(q$Revision$=~/\d+/g); sprintf "%d.".("%03d"x$#r),@r; };
30 our @EXPORT=qw(&Wrequire &Wuse &a_href &a_href_cz &vskip &img ¢erimg &rightimg $W &top_dir &top_dir_disk);
31 our @ISA=qw(Exporter);
39 # print STDERR "Wrequire $file\n";
45 my $aref=($W->{"packages_used"}{$Apache::Registry::curstash}||=[]);
47 if !{ map(($_=>1),@$aref) }->{$class}; # Prevent duplicated entries.
49 1; # Otherwise 'require' would already file above.
56 # print STDERR "Wuse $file\n";
58 local $Exporter::ExportLevel=$Exporter::ExportLevel+1;
64 BEGIN { Wuse 'WebConfig'; } # for %WebConfig
65 require CGI; # for &escapeHTML
66 require Image::Size; # for &imgsize
67 use File::Basename; # &basename
68 use Carp qw(cluck confess);
70 require HTTP::BrowserDetect;
71 require HTTP::Negotiate;
76 # Undo 'www/engine/httpd-restart' as it may use obsolete Perl for 'mod_perl'
77 delete $ENV{"PERLLIB"};
78 delete $ENV{"LD_LIBRARY_PATH"};
85 # $W->{"force_charset"}
86 # %{$W->{"packages_used"}
87 # $W->{"heading_done"}
88 # $W->{"footer_passed"}
90 # %{$W->{"headers_lc"}} # maps lc($headers_key)=>$headers_key
91 # @{$W->{"packages_used"}{$Apache::Registry::curstash}}}
98 my $packages_used_save=$W->{"packages_used"};
99 $W={ %WebConfig,%args }; # override %WebConfig settings
100 $W->{"packages_used"}=$packages_used_save;
102 $W->{"__PACKAGE__"}||="Apache::ROOT".$Apache::Registry::curstash;
104 $W->{"top_dir"}||=eval '$'.$W->{"__PACKAGE__"}.'::top_dir';
106 do { $W->{$_}=0 if !defined $W->{$_}; } for ("detect_ent");
107 do { $W->{$_}=0 if !defined $W->{$_}; } for ("detect_js");
108 do { $W->{$_}=1 if !defined $W->{$_}; } for ("have_css"); # AFAIK it does not hurt anyone.
109 do { $W->{$_}=1 if !defined $W->{$_}; } for ("heading");
110 do { $W->{$_}=1 if !defined $W->{$_}; } for ("footer");
111 do { $W->{$_}=1 if !defined $W->{$_}; } for ("footer_delimit");
112 do { $W->{$_}=1 if !defined $W->{$_}; } for ("footer_mailme");
113 do { $W->{$_}=1 if !defined $W->{$_}; } for ("footer_ids");
114 do { $W->{$_}=1 if !defined $W->{$_}; } for ("indexme");
115 do { $W->{$_}="" if !defined $W->{$_}; } for ("head");
116 do { $W->{$_}="" if !defined $W->{$_}; } for ("head_css");
119 for (qw(footer_mailme footer_ids)) {
120 $W->{$_}=0 if !$W->{"footer"};
121 $footer_any=1 if $W->{$_};
123 $W->{"footer"}=0 if !$footer_any;
124 $W->{"footer_delimit"}=0 if !$W->{"footer"};
126 $W->{"r"}=Apache->request();
128 $W->{"QUERY_STRING"}=$W->{"r"}->args() || "";
129 if ($W->{"QUERY_STRING"}=~/[&]amp;have_ent/)
130 { $W->{"have_ent"}=0; }
131 elsif ($W->{"QUERY_STRING"}=~ /[&]have_ent/)
132 { $W->{"have_ent"}=1; }
134 { delete $W->{"have_ent"}; }
135 if ($W->{"detect_ent"} && !defined $W->{"have_ent"} && $W->{"r"}->method() eq "GET") {
136 $W->{"head"}.='<meta http-equiv="Refresh" content="0; URL='
137 .CGI::escapeHTML("http://".$W->{"r"}->hostname()."/".($W->{"r"}->uri()=~m#^/*(.*)$#)[0]
138 ."?".($W->{"QUERY_STRING"} || "detect_ent_glue=1").'&have_ent=detect')
141 $W->{"QUERY_STRING"}=~s/([&])amp;/$1/g;
142 $W->{"r"}->args($W->{"QUERY_STRING"});
143 $ENV{"QUERY_STRING"}=$W->{"QUERY_STRING"};
144 # Do not: $W->{"r"}->args()
145 # as it parses only QUERY_STRING (not POST data).
146 $W->{"args"}={ CGI->new()->Vars() };
148 do { $W->{$_}=$ENV{"HTTP_ACCEPT"} if !defined $W->{$_}; } for ("accept");
149 do { $W->{$_}=$ENV{"HTTP_USER_AGENT"} if !defined $W->{$_}; } for ("user_agent");
151 $W->{"browser"}=HTTP::BrowserDetect->new($W->{"user_agent"});
153 if (!defined $W->{"have_style"}) {
154 $W->{"have_style"}=(!$W->{"browser"}->netscape() || $W->{"browser"}->major>4 ? 1 : 0);
157 $W->{"have_js"}=($W->{"args"}{"have_js"} ? 1 : 0);
158 if ($W->{"detect_js"} && !$W->{"have_js"}) {
159 $W->{"head"}.='<script type="text/javascript" src="'.top_dir('/have_js.js.pl').'"></script>'."\n";
162 do { args_check(%$_) if $_; } for ($W->{"args_check"});
169 do { return $_ if $_; } for ($W->{"top_dir"});
170 return $INC[0]; # fallback
177 if (my $uri=$ENV{"REQUEST_URI"}) {
178 $uri.="Index" if $uri=~m#/$#;
180 my($inpath,$inquery)=split /[?]/,$in,2;
184 my($in1 ,$in2 )=($in =~m#^(/[^/]+)(/.*)$#);
185 my($uri1,$uri2)=($uri=~m#^(/[^/]+)(/.*)$#);
186 last if !defined $in1 || !defined $uri1 || $in1 ne $uri1;
193 $uri=File::Basename::dirname($uri);
194 my $r=$uri.(defined $in ? $in : "");
195 # 1 while $r=~s#^[.]/##;
196 # $r="./$r" if $r=~m#^(?:?.*)$#; # empty pathname?
199 return top_dir_disk().$in;
208 while (my($name,$regex)=each(%tmpl)) {
209 my $name_html="Parameter <span class=\"quote\">".CGI::escapeHTML($name)."</span>";
210 $W->{"args"}{$name}="" if !defined $W->{"args"}{$name};
211 my $val=$W->{"args"}{$name};
212 $val="" if !defined $val;
213 fatal "$name_html <span class=\"quote\">".CGI::escapeHTML($val)."</span>"
214 ." does not match required regex <span class=\"quote\">".CGI::escapeHTML($regex)."</span> "
215 if $regex ne "" && $val!~/$regex/;
223 return '<p'.(!defined $height ? "" : ' style="height: '.$height.';"').'> </p>'."\n";
230 $msg="UNKNOWN" if !$msg;
232 # heading(false/*title*/,false/*indexme*/); # notitle is always safe, don't index the error message
233 print "\n".vskip("3ex")."<hr /><h1 class=\"error\">FATAL ERROR: $msg!</h1>\n"
234 ."<p>You can report this problem's details to"
235 ." ".a_href("mailto:".$W->{"admin_mail"},"admin of this website").".</p>\n";
241 exit 1 if $W->{"footer_passed"}++; # deadlock prevention:
243 print vskip if $W->{"footer_delimit"};
245 if ($W->{"heading"}) {
246 do { &{$_}() if $_; } for ($W->{"footing_delimit"});
249 print "<hr />\n" if $W->{"footer"};
251 if ($W->{"footer_mailme"}) {
252 print '<form action="'.top_dir('/SendMsg.pl').'" method="post" onsubmit="'
253 ."this.elements['msgscript'].value=this.elements['msghtml'].value;"
254 ."this.elements['msghtml'].value='';"
257 print '<p align="right">'."\n";
258 print '<input name="msgscript" type="hidden" />'."\n";
259 print '<input name="msghtml" type="text" size="32" alt="Message" />'."\n";
260 print '<input name="submit" type="submit" value="Quick Note" />'."\n";
262 print '</form>'."\n";
265 if ($W->{"footer_ids"}) {
266 print '<p class="cvs-id">';
267 print join("<br />\n",map({ my $package=$_;
268 my $cvs_id=(eval('$'.$package."::CVS_ID")
269 # || $package # debug
275 $cvs_id='$'.$cvs_id.'$'; # Eaten by 'q' operator.
276 my @cvs_id_split=split / +/,$cvs_id;
277 if (@cvs_id_split==8) {
281 for (qw(.html.pl .pl .pm),"") {
283 last if -r top_dir_disk()."/$file$ext";
284 cluck "Class file $file not found" if !$ext;
288 .a_href((map({ my $s=$_; $s=~s#/viewcvs/#$&~checkout~/#; $s; } $W->{"viewcvs"}))[0]."$file?rev=".$cvs_id_split[2],
290 $cvs_id_split[1]=a_href($W->{"viewcvs"}.$file,
291 ($package!~/^Apache::/ ? $package : $cvs_id_split[1]));
292 $cvs_id_split[5]=&{$W->{"cvs_id_author"}}($cvs_id_split[5]);
294 join " ",@cvs_id_split;
299 @{$W->{"packages_used"}{$Apache::Registry::curstash}},
307 @{$W->{"packages_used"}{$Apache::Registry::curstash}},
309 my $cvs_id=(eval('$'.$package."::CVS_ID")
310 # || $package # debug
312 print '<!-- '.$package.' - $'.$cvs_id.'$ -->'."\n" if $cvs_id;
315 if ($W->{"heading"}) {
316 do { &{$_}() if $_; } for ($W->{"footing"});
319 print "</body></html>\n";
327 while (my($key,$val)=each(%pairs)) {
328 do { cluck "Headers already sent"; next; } if $W->{"heading_done"};
329 for ($W->{"headers_lc"}{lc $key} || ()) {
330 delete $W->{"headers"}{$_};
332 $W->{"headers_lc"}{lc $key}=$key;
333 $W->{"headers"}{$key}=$val;
343 elsif ($size<1024*1024)
344 { $size=sprintf "%.1fK",$size/1024; }
346 { $size=sprintf "%.1fM",$size/1024/1024; }
355 return $url!~m#^[a-z]+://#;
360 my($url,$contents,%args)=@_;
362 do { $$_=1 if !defined $$_; } for (\$args{"size"});
363 $contents=CGI::escapeHTML($url) if !defined $contents;
364 $contents=~s#<a\b[^>]*>##gi;
365 $contents=~s#</a>##gi;
367 $url=top_dir($url) if url_is_local $url && $url=~m#^/#;
370 my $urlent=CGI::escapeHTML($url);
373 elsif (url_is_local $url)
375 elsif (defined $W->{"have_ent"} && !$W->{"have_ent"}) # non-ent client
377 elsif ($W->{"have_ent"}) # ent client
379 else # unknown client, &CGI::escapeHTML should not be needed here
380 { $r.=CGI::escapeHTML(top_dir('/Redirect.pl?location='.uri_escape($url))); }
382 do { $r.=" $_" if $_; } for ($args{"attr"});
383 $r.='>'.$contents.'</a>';
384 if ($args{"size"} && url_is_local($url) && $url=~/[.](?:gz|Z|rpm|zip|deb|lha)/) { # Downloadable?
385 $url=top_dir_disk().$url if $url=~m#^/#;
387 { cluck "File not readable: $url"; }
389 $r.=' ('.size_display((stat($url))[7]).')';
397 # Do not: PerlModule Apache::ForwardedFor
398 # PerlPostReadRequestHandler Apache::ForwardedFor
399 # As 'Apache::ForwardedFor' takes the first of $ENV{"HTTP_X_FORWARDED_FOR"}
400 # while the contents is '127.0.0.1, 213.220.195.171' if client has its own proxy.
401 # We must take the last item ourselves.
402 my $r=$ENV{"HTTP_X_FORWARDED_FOR"} || $W->{"r"}->get_remote_host();
409 return "CZ" eq Geo::IP->new()->country_code_by_addr(remote_ip());
414 my($url,$contents,%args)=@_;
416 return a_href $url,$contents,%args if is_cz();
424 system {'flock'} 'flock','-x',top_dir_disk(),$cmd.' >&2';
429 my($width,$height)=@_;
431 return ($W->{"have_style"} ? "style=\"border:0;width:${width}px;height:${height}px\"" : "border=\"0\"")
432 ." width=\"$width\" height=\"$height\"";
435 sub negotiate_variant (%)
439 my @fields=("id","qs","content-type","encoding","charset","lang","size");
440 return [ map(($args{$_}),@fields) ];
444 { "id"=>"png","qs"=>1.0,"content-type"=>"image/png" },
445 { "id"=>"gif","qs"=>0.9,"content-type"=>"image/gif" },
447 my $img_variants_re='[.](?:'.join('|',"jpeg",map(($_->{"id"}),@img_variants)).')$';
453 if (!url_is_local($file_base)) {
454 return $file_base if !wantarray();
455 return ($file_base,$file_base);
457 # Known image extension?
458 if ($file_base=~m#$img_variants_re#o) {
459 return $file_base if !wantarray();
460 return ($file_base,$file_base) if $file_base!~m#^/#;
461 return (top_dir($file_base),top_dir_disk().$file_base);
466 if ($file_base!~m#^/#) {
467 $file_base_disk=$file_base_uri=$file_base;
470 $file_base_disk=top_dir_disk().$file_base;
471 $file_base_uri=top_dir($file_base);
475 for my $var (@img_variants) {
476 my $file=$file_base_disk.".".$var->{"id"};
477 # TODO: Somehow quickly check dependencies?
478 make('make -s --no-print-directory'
479 .' -C '."'".File::Basename::dirname($file)."' '".File::Basename::basename($file)."'")
481 push @nego_variants,negotiate_variant(
483 "size"=>(stat $file)[7],
486 # Do not: ,$W->{"r"});
487 # but should we provide somehow either 'HTTP::Headers' or 'HTTP::Request' ?
488 my $ext=HTTP::Negotiate::choose(\@nego_variants);
489 $ext||=$img_variants[0]->{"id"}; # &HTTP::Negotiate::choose failed?
491 return $file_base_uri.".".$ext if !wantarray();
492 return ($file_base_uri.".".$ext,$file_base_disk.".".$ext);
497 my($file_base,$alt,%attr)=@_;
499 my($file_uri,$file_disk)=img_src $file_base;
500 my($width,$height)=Image::Size::imgsize($file_disk);
502 $alt=CGI::escapeHTML($alt);
503 my $content="<img src=\"$file_uri\" alt=\"$alt\" title=\"$alt\" ".img_size($width,$height)
504 .(!$attr{"attr"} ? "" : " ".$attr{"attr"})." />";
505 return a_href img_src($attr{"a_href_img"}),$content if $attr{"a_href_img"};
506 return a_href $attr{"a_href"},$content if $attr{"a_href"};
513 $r.='<table border="0" width="100%"><tr>'."\n";
514 @_=( [@_] ) if !ref $_[0];
516 $r.="\t".'<td align="center">'.&{\&img}(@$_).'</td>'."\n";
518 $r.='</tr></table>'."\n";
524 my($text,@args_img)=@_;
526 # Workaround bug of 'Mozilla/4.0 (compatible; MSIE 6.0; Windows NT 5.1)':
528 <table border="0" width="100%">
529 <col width="@{[ (!$W->{"browser"}->ie() ? "1*" : "90%" ) ]}" />
530 <col width="@{[ (!$W->{"browser"}->ie() ? "0*" : "10%" ) ]}" />
536 @{[ &{\&img}(@args_img) ]}
545 my($class,$filename)=@_;
548 open F,$filename or die "Cannot open \"$filename\": $!";
561 push @r,shift @arr; # key
571 # $ENV{"CLIENT_CHARSET"} ignored (mod_czech support dropped!)
572 my $client_charset=$W->{"force_charset"} || "us-ascii";
573 header("Content-Style-Type"=>"text/css");
574 header("Content-Script-Type"=>"text/javascript");
576 while (my($key,$val)=each(%{$W->{"headers"}})) {
577 $W->{"r"}->header_out($key,$val);
579 $W->{"r"}->send_http_header("text/html; charset=$client_charset"); # "Content-type"; do not use header()
581 return if $W->{"heading_done"}++;
582 exit if $W->{"r"}->header_only();
584 if (1) { # || !$msie_major || $msie_major>=4) # TODO:dyn
585 print '<?xml version="1.0" encoding="'.$client_charset.'"?>'."\n";
587 print '<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.1//EN" "http://www.w3.org/TR/xhtml11/DTD/xhtml11.dtd">'."\n";
588 print '<html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en-US">'."\n";
589 my $title=$W->{"title_prefix"}.join("",map({ ': '.$_; } ($W->{"title"} || ())));
590 $title=~s#<[^>]*>##g;
592 print "<title>$title</title>\n";
594 if ($W->{"have_css"}) {
596 <style type="text/css"><!--
597 .cvs-id { font-family: monospace; }
598 .error { color: red; background-color: transparent; }
599 .quote { font-family: monospace; }
600 .nowrap { white-space: nowrap; }
601 .centered { text-align: center; }
602 .tab-bold { font-weight: bold; }
603 .tab-head { font-weight: bold; color: yellow; background-color: transparent; }
605 background-color: black;
608 :link { color: aqua; background-color: transparent; }
609 :visited { color: teal; background-color: transparent; }
610 h1,h2 { color: yellow; background-color: transparent; }
612 caption { caption-side: bottom; }
613 .footer img { vertical-align: middle; }
615 print $W->{"head_css"}."\n";
616 print "--></style>\n";
619 print '<meta name="robots" content="'.($W->{"indexme"} ? "" : "no" ).'index,follow" />'."\n";
621 for my $type (qw(prev next index contents start up)) {
622 do { print '<link rel="'.$type.'" href="'.$_.'" />'."\n" if $_; } for ($W->{"rel_$type"});
624 print "</head><body";
625 print ' bgcolor="black" text="white" link="aqua" vlink="teal"'
626 if $W->{"browser"}->netscape() && $W->{"browser"}->major<=4;
629 if ($W->{"heading"}) {
630 do { &{$_}() if $_; } for ($W->{"heading"});