Web.pm

   1 # $Id$
   2 # Common functions for HTML/XHTML output generation
   3 # Copyright (C) 2003 Jan Kratochvil <project-www.jankratochvil.net@jankratochvil.net>
   4 #
   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
   8 #
   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.
  13 #
  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
  17
  18
  19 package My::Web;
  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; };
  22 our $CVS_ID=q$Id$;
  23 use strict;
  24 use warnings;
  25
  26 use Exporter;
  27 sub Wrequire ($);
  28 sub Wuse ($@);
  29 our $W;
  30 our @EXPORT=qw(&Wrequire &Wuse &a_href &a_href_cz &vskip &img &centerimg &rightimg $W &top_dir &top_dir_disk &Wprint &input_hidden_persistents);
  31 our @ISA=qw(Exporter Tie::Handle);
  32
  33 BEGIN
  34 {
  35         $W->{"__My::Web_init"}=1;
  36
  37         sub Wrequire ($)
  38         {
  39         my($file)=@_;
  40
  41 #               print STDERR "Wrequire $file\n";
  42                 $file=~s#/#::#g;
  43                 $file=~s/[.]pm$//;
  44                 my $class=$file;
  45                 $file=~s#::#/#g;
  46                 $file.=".pm";
  47                 my $who=$W->{"__PACKAGE__"};
  48                 $who||="__My::Web" if $W->{"__My::Web_init"};
  49                 if ($who) {
  50                         my $aref=($W->{"packages_used"}{$who}||=[]);
  51                         push @$aref,$class
  52                                         if !{ map(($_=>1),@$aref) }->{$class};  # Prevent duplicated entries.
  53                         }
  54                 CORE::require $file;
  55                 1;      # Otherwise 'require' would already file above.
  56         }
  57
  58         sub Wuse ($@)
  59         {
  60         my($file,@list)=@_;
  61
  62 #               print STDERR "Wuse $file\n";
  63                 Wrequire $file;
  64                 local $Exporter::ExportLevel=$Exporter::ExportLevel+1;
  65                 $file->import(@list);
  66                 1;
  67         }
  68 }
  69
  70 BEGIN { Wuse 'WebConfig'; }     # for %WebConfig
  71 require CGI;    # for &escapeHTML
  72 require Image::Size;    # for &imgsize
  73 use File::Basename;     # &basename
  74 use Carp qw(cluck confess);
  75 use URI::Escape;
  76 require HTTP::BrowserDetect;
  77 require HTTP::Negotiate;
  78 my $have_Geo_IP; BEGIN { $have_Geo_IP=eval { require Geo::IP; 1; }; }
  79 # Do not: use ModPerl::Util qw(exit);
  80 # to prevent in mod_perl2: "exit" is not exported by the ModPerl::Util module
  81 # I do not know why.
  82 use POSIX qw(strftime);
  83 use Tie::Handle;
  84 use Apache2::Const qw(HTTP_MOVED_TEMPORARILY);
  85 use URI;
  86 use URI::QueryParam;
  87
  88
  89 #our $W;
  90                 # $W->{"title"}
  91                 # $W->{"head"}
  92                 # $W->{"force_charset"}
  93                 # $W->{"heading_done"}
  94                 # $W->{"footer_passed"}
  95                 # %{$W->{"headers"}}
  96                 # %{$W->{"headers_lc"}} # maps lc($headers_key)=>$headers_key
  97                 # @{$W->{"packages_used"}{$W->{"__PACKAGE__"}}}
  98                 # @{$W->{"packages_used"}{"__My::Web"}}
  99                 # %{$W->{"args"}}
 100
 101 sub init ($%)
 102 {
 103 my($class,%args)=@_;
 104
 105         print STDERR "$class->init ".Apache2::RequestUtil->request()->unparsed_uri()."\n";
 106
 107         my $packages_used_save=$W->{"packages_used"};
 108         $W={ %WebConfig,%args };        # override %WebConfig settings
 109         $W->{"packages_used"}=$packages_used_save;
 110
 111         # {"__PACKAGE__"} is mandatory for mod_perl-2.0;
 112         # $Apache2::Registry::curstash is no longer supported.
 113         do { cluck "No $_" if !$W->{$_}; } for "__PACKAGE__";
 114
 115         $W->{"top_dir"}||=eval '$'.$W->{"__PACKAGE__"}.'::top_dir';
 116
 117         do { $W->{$_}=0  if !defined $W->{$_}; } for ("detect_ent");
 118         do { $W->{$_}=0  if !defined $W->{$_}; } for ("detect_js");
 119         do { $W->{$_}=1  if !defined $W->{$_}; } for ("have_css");      # AFAIK it does not hurt anyone.
 120         do { $W->{$_}=1  if !defined $W->{$_}; } for ("footer");
 121         do { $W->{$_}=1  if !defined $W->{$_}; } for ("footer_delimit");
 122         do { $W->{$_}=1  if !defined $W->{$_}; } for ("footer_mailme");
 123         do { $W->{$_}=1  if !defined $W->{$_}; } for ("footer_ids");
 124         do { $W->{$_}=1  if !defined $W->{$_}; } for ("indexme");
 125         do { $W->{$_}="" if !defined $W->{$_}; } for ("head");
 126         do { $W->{$_}="" if !defined $W->{$_}; } for ("body_attr");
 127         do { $W->{$_}="en-US" if !defined $W->{$_}; } for ("language");
 128
 129         my $footer_any=0;
 130         for (qw(footer_mailme footer_ids)) {
 131                 $W->{$_}=0 if !$W->{"footer"};
 132                 $footer_any=1 if $W->{$_};
 133                 }
 134         $W->{"footer"}=0 if !$footer_any;
 135         $W->{"footer_delimit"}=0 if !$W->{"footer"};
 136
 137         $W->{"r"}=Apache2::RequestUtil->request();
 138
 139         $W->{"QUERY_STRING"}=$W->{"r"}->args() || "";
 140         if ($W->{"detect_ent"}) {
 141                          if ($W->{"QUERY_STRING"}=~/[&]amp;have_ent/)
 142                         { $W->{"have_ent"}=0; }
 143                 elsif ($W->{"QUERY_STRING"}=~    /[&]have_ent/)
 144                         { $W->{"have_ent"}=1; }
 145                 else
 146                         { delete $W->{"have_ent"}; }
 147                 if (!defined $W->{"have_ent"} && $W->{"r"}->method() eq "GET") {
 148                         $W->{"head"}.='<meta http-equiv="Refresh" content="0; URL='
 149                                         .CGI::escapeHTML("http://".&{$W->{"web_hostname_sub"}}()."/".($W->{"r"}->uri()=~m#^/*(.*)$#)[0]
 150                                                         ."?".($W->{"QUERY_STRING"} || "detect_ent_glue=1").'&have_ent=detect')
 151                                         .'" />'."\n";
 152                         }
 153                 }
 154         $W->{"QUERY_STRING"}=~s/([&])amp;/$1/g;
 155         $W->{"r"}->args($W->{"QUERY_STRING"});
 156         # Workaround: &CGI::Vars behaves weird if strings passed both as POST data and in: $QUERY_STRING
 157         do { $W->{"r"}->args(""); delete $ENV{"QUERY_STRING"}; } if $W->{"r"}->method() eq "POST";
 158         # Do not: $W->{"r"}->args()
 159         # as it parses only QUERY_STRING (not POST data).
 160         $W->{"args"}={ CGI->new($W->{"r"})->Vars() };
 161         for my $name (keys(%{$W->{"args"}})) {
 162                 my @vals=split /\x00/,$W->{"args"}{$name};
 163                 next if @vals<=1;
 164                 $W->{"args"}{$name}=[@vals];
 165                 }
 166
 167         do { $W->{$_}=$W->{"r"}->headers_in()->{"Accept"}     if !defined $W->{$_}; } for ("accept");
 168         do { $W->{$_}=$W->{"r"}->headers_in()->{"User-Agent"} if !defined $W->{$_}; } for ("user_agent");
 169
 170         $W->{"browser"}=HTTP::BrowserDetect->new($W->{"user_agent"});
 171
 172         if (!defined $W->{"have_style"}) {
 173                 $W->{"have_style"}=(!$W->{"browser"}->netscape() || ($W->{"browser"}->major() && $W->{"browser"}->major()>4) ? 1 : 0);
 174                 }
 175
 176         $W->{"have_js"}=($W->{"args"}{"have_js"} ? 1 : 0);
 177         if ($W->{"detect_js"} && !$W->{"have_js"}) {
 178                 $W->{"head"}.='<script type="text/javascript" src="'.top_dir('/have_js.js.pl').'"></script>'."\n";
 179                 }
 180
 181         do { args_check(%$_) if $_; } for ($W->{"args_check"});
 182
 183         $ENV{"HOSTNAME"}||=&{$W->{"web_hostname_sub"}}();
 184
 185         return bless $W,$class;
 186 }
 187
 188 sub Wprint($)
 189 {
 190 my($text)=@_;
 191
 192         $W->{"r"}->puts($text);
 193 }
 194
 195 # local *FH;
 196 # tie *FH,ref($W),$W;
 197 sub TIEHANDLE($)
 198 {
 199 my($class,$W)=@_;
 200
 201         my $self={};
 202         $self->{"W"}=$W or confess "Missing W";
 203         return bless $self,$class;
 204 }
 205
 206 sub WRITE
 207 {
 208 my($self,$scalar,$length,$offset)=@_;
 209
 210         Wprint substr($scalar,0,$length);
 211 }
 212
 213 sub top_dir_disk ()
 214 {
 215         do { return $_ if $_; } for ($W->{"top_dir"});
 216         return $INC[0]; # fallback
 217 }
 218
 219 # $args{"abs"}
 220 sub top_dir (;$%)
 221 {
 222 my($in,%args)=@_;
 223
 224         if (my $uri=$W->{"r"}->unparsed_uri()) {
 225                 if ($W->{"args"}{"Wabs"} || $args{"abs"}) {
 226                         # FIXME: $in may not be defined here!
 227                         # to prevent: Use of uninitialized value in ...
 228                         if ($in=~m#^/#) {
 229                                 $in=~s#^/*##;
 230                                 }
 231                         else {
 232                                 $in=$uri."/".$in;
 233                                 $in=~tr#/#/#s;
 234                                 1 while $in=~s#/(?:[^/]+)/\Q..\E/#/#g
 235                                 }
 236                         return "http://".&{$W->{"web_hostname_sub"}}()."/".(defined $in ? $in : "");
 237                         }
 238                 $uri.="Index" if $uri=~m#/$#;
 239                 if (defined $in) {
 240                         my($inpath,$inquery)=split /[?]/,$in,2;
 241                         $inpath=~tr///cs;
 242                         $uri=~tr///cs;
 243                         for (;;) {
 244                                 my($in1 ,$in2 )=($in =~m#^(/[^/]+)(/.*)$#);
 245                                 my($uri1,$uri2)=($uri=~m#^(/[^/]+)(/.*)$#);
 246                                 last if !defined $in1 || !defined $uri1 || $in1 ne $uri1;
 247                                 $in=$in2;
 248                                 $uri=$uri2;
 249                                 }
 250                         }
 251                 $uri=~s#^/*##;
 252                 $uri=~s#[^/]+#..#g;
 253                 $uri=File::Basename::dirname($uri);
 254                 my $r=$uri.(defined $in ? $in : "");
 255 #               1 while $r=~s#^[.]/##;
 256 #               $r="./$r" if $r=~m#^(?:?.*)$#;  # empty pathname?
 257                 return $r;
 258                 }
 259         return top_dir_disk().$in;
 260 }
 261
 262 sub fatal (;$);
 263
 264 sub args_check (%)
 265 {
 266 my(%tmpl)=@_;
 267
 268         while (my($name,$regex)=each(%tmpl)) {
 269                 my $name_html="Parameter <span class=\"quote\">".CGI::escapeHTML($name)."</span>";
 270                 $W->{"args"}{$name}="" if !defined $W->{"args"}{$name};
 271                 $W->{"args"}{$name}=[ $W->{"args"}{$name} ] if !ref $W->{"args"}{$name} && ref $regex;
 272                 fatal "$name_html passed as multivar although singlevar expected"
 273                                 if ref $W->{"args"}{$name} && !ref $regex;
 274                 $regex=$regex->[0] if ref $regex;
 275                 for my $val (!ref $W->{"args"}{$name} ? $W->{"args"}{$name} : @{$W->{"args"}{$name}}) {
 276                         $val="" if !defined $val;
 277                         fatal "$name_html <span class=\"quote\">".CGI::escapeHTML($val)."</span>"
 278                                                         ." does not match the required regex <span class=\"quote\">".CGI::escapeHTML($regex)."</span> "
 279                                         if $regex ne "" && $val!~/$regex/;
 280                         }
 281                 }
 282 }
 283
 284 sub vskip (;$)
 285 {
 286 my($height)=@_;
 287
 288         return '<p'.(!defined $height ? "" : ' style="height: '.$height.';"').'>&nbsp;</p>'."\n";
 289 }
 290
 291 sub fatal (;$)
 292 {
 293 my($msg)=@_;
 294
 295         $msg="UNKNOWN" if !$msg;
 296         cluck "FATAL: $msg";
 297
 298         $W->{"indexme"}=0;      # For the case no heading was sent yet.
 299         $W->{"heading_done"}=0; # for the case of already sent {"header_only"}==1
 300         $W->{"header_only"}=0;  # assurance for &heading
 301         My::Web->heading();
 302         Wprint "\n".vskip("3ex")."<hr /><h1 class=\"error\">FATAL ERROR: $msg!</h1>\n"
 303                         ."<p>You can report this problem's details to"
 304                         ." ".a_href("mailto:".$W->{"admin_mail"},"admin of this website").".</p>\n";
 305         footer();
 306 }
 307
 308 sub footer (;$)
 309 {
 310         exit 1 if $W->{"footer_passed"}++;      # deadlock prevention:
 311
 312         Wprint vskip if $W->{"footer_delimit"};
 313
 314         do { &{$_}() if $_; } for ($W->{"footing_delimit"});
 315
 316         Wprint "<hr />\n" if $W->{"footer"};
 317
 318         if ($W->{"footer_mailme"}) {
 319                 Wprint '<form action="'.top_dir('/SendMsg.pl').'" method="post" onsubmit="'
 320                                 ."this.elements['msgscript'].value=this.elements['msghtml'].value;"
 321                                 ."this.elements['msghtml'].value='';"
 322                                 ."this.submit();"
 323                                 .'">'."\n";
 324                         Wprint input_hidden_persistents()."\n";
 325                         Wprint '<p align="right">'."\n";
 326                                 Wprint '<input name="msgscript" type="hidden" />'."\n";
 327                                 Wprint '<input name="msghtml" type="text" size="32" alt="Message" />'."\n";
 328                                 Wprint '<input name="submit" type="submit" value="Quick Note" />'."\n";
 329                         Wprint '</p>'."\n";
 330                 Wprint '</form>'."\n";
 331                 }
 332
 333         my @packages_used=(
 334                         $W->{"__PACKAGE__"},
 335                         __PACKAGE__,
 336                         @{$W->{"packages_used"}{"__My::Web"}},
 337                         map((!$_ ? () : @$_),$W->{"packages_used"}{$W->{"__PACKAGE__"}}),
 338                         );
 339         my %packages_used;
 340         @packages_used=grep((!$packages_used{$_}++),@packages_used);
 341         if ($W->{"footer_ids"}) {
 342                 Wprint '<p class="cvs-id">';
 343                 Wprint join("<br />\n",map({ my $package=$_;
 344                         my $cvs_id=(eval('$'.$package."::CVS_ID")
 345 #                                       || $package     # debug
 346                                         );
 347                         if (!$cvs_id) {
 348                                 ();
 349                                 }
 350                         else {
 351                                 $cvs_id='$'.$cvs_id.'$';        # Eaten by 'q' operator.
 352                                 my @cvs_id_split=split / +/,$cvs_id;
 353                                 if (@cvs_id_split==8) {
 354                                         my $file=$package;
 355                                         $file=~s#::#/#g;
 356                                         my $ext;
 357                                         my @tried;
 358                                         for (qw(.html.pl .pl .pm),"") {
 359                                                 $ext=$_;
 360                                                 my $pathname=top_dir_disk()."/$file$ext";
 361                                                 push @tried,$pathname;
 362                                                 last if -r $pathname;
 363                                                 cluck "Class file $file not found; tried: ".join(" ",@tried) if !$ext;
 364                                                 }
 365                                         $file.=$ext;
 366                                         $cvs_id_split[2]=""
 367                                                         .a_href((map({ my $s=$_; $s=~s#/viewcvs/#$&~checkout~/#; $s; } $W->{"viewcvs"}))[0]."$file?rev=".$cvs_id_split[2],
 368                                                                         $cvs_id_split[2]);
 369                                         $cvs_id_split[1]=a_href($W->{"viewcvs"}.$file,
 370                                                         ($package!~/^Apache2::/ ? $package : $cvs_id_split[1]));
 371                                         $cvs_id_split[5]=&{$W->{"cvs_id_author"}}($cvs_id_split[5]);
 372                                         }
 373                                 join " ",@cvs_id_split;
 374                                 }
 375                         } @packages_used));
 376                 Wprint "</p>\n";
 377                 }
 378
 379         for my $package (@packages_used) {
 380                 my $cvs_id=(eval('$'.$package."::CVS_ID")
 381 #                               || $package     # debug
 382                                 );
 383                 Wprint '<!-- '.$package.' - $'.$cvs_id.'$ -->'."\n" if $cvs_id;
 384                 }
 385
 386         do { &{$_}() if $_; } for ($W->{"footing"});
 387
 388         Wprint "</body></html>\n";
 389         exit(0);
 390 }
 391
 392 sub header (%)
 393 {
 394 my(%pairs)=@_;
 395
 396         while (my($key,$val)=each(%pairs)) {
 397                 do { cluck "Headers already sent"; next; } if $W->{"heading_done"};
 398                 for ($W->{"headers_lc"}{lc $key} || ()) {
 399                         delete $W->{"headers"}{$_};
 400                         }
 401                 $W->{"headers_lc"}{lc $key}=$key;
 402                 $W->{"headers"}{$key}=$val;
 403                 }
 404 }
 405
 406 sub size_display ($)
 407 {
 408 my($size)=@_;
 409
 410            if ($size<4096)
 411                 {}
 412         elsif ($size<1024*1024)
 413                 { $size=sprintf "%.1fK",$size/1024; }
 414         else
 415                 { $size=sprintf "%.1fM",$size/1024/1024; }
 416         $size.="B";
 417         return $size;
 418 }
 419
 420 sub url_is_local ($)
 421 {
 422 my($url)=@_;
 423
 424         return $url!~m#^[a-z]+://#;
 425 }
 426
 427 sub url_out($%)
 428 {
 429 my($url,%args)=@_;
 430
 431         return $url if !url_is_local $url;
 432         $url=top_dir($url,%args) if $url=~m#^/# || $args{"abs"};
 433
 434         my $uri=URI->new($url);
 435         # Prefer the $uri values over "args_persistent" values.
 436         $uri->query_form_hash({
 437                         map({
 438                                 my $key=$_;
 439                                 my $val=$W->{"args"}{$key};
 440                                 (!defined $val ? () : ($key=>$val));
 441                                 } keys(%{$W->{"args_persistent"}})),
 442                         %{$uri->query_form_hash()},
 443                         });
 444         $url="".$uri;
 445
 446         return $url;
 447 }
 448
 449 sub a_href ($;$%)
 450 {
 451 my($url,$contents,%args)=@_;
 452
 453         do { $$_=1 if !defined $$_; } for (\$args{"size"});
 454         if (!defined $contents) {
 455                 $contents=$url;
 456                 $contents=File::Basename::basename($contents) if $args{"basename"};
 457                 $contents=CGI::escapeHTML($contents);
 458                 }
 459         $contents=~s#<a\b[^>]*>##gi;
 460         $contents=~s#</a>##gi;
 461
 462         $url=url_out($url,%args);
 463
 464         my $r='<a href="';
 465         my $urlent=CGI::escapeHTML($url);
 466            if ($url eq $urlent)
 467                 { $r.=$url; }
 468         elsif (url_is_local $url)
 469                 { $r.=$urlent; }
 470         elsif (defined $W->{"have_ent"} && !$W->{"have_ent"})   # non-ent client
 471                 { $r.=$url; }
 472         elsif ($W->{"have_ent"})        # ent client
 473                 { $r.=$urlent; }
 474         else    # unknown client, &CGI::escapeHTML should not be needed here
 475                 { $r.=CGI::escapeHTML(top_dir('/Redirect.pl?location='.uri_escape($url))); }
 476         $r.='"';
 477         do { $r.=" $_" if $_; } for ($args{"attr"});
 478         $r.='>'.$contents.'</a>';
 479         if ($args{"size"} && url_is_local($url) && ($args{"size"}>=2 || $url=~/[.](?:gz|Z|rpm|zip|deb|lha)/)) { # Downloadable?
 480                 $url=top_dir_disk().$url if $url=~m#^/#;
 481                 if (!-r $url)
 482                         { cluck "File not readable: $url"; }
 483                 else {
 484                         $r.='&nbsp;('.size_display((stat($url))[7]).')';
 485                         }
 486                 }
 487         return $r;
 488 }
 489
 490 sub input_hidden_persistents()
 491 {
 492         return join("",map({
 493                 my $key=$_;
 494                 my $val=$W->{"args"}{$key};
 495                 (!defined $val ? () : '<input type="hidden"'
 496                                 .' name="'.CGI::escapeHTML($key).'"'
 497                                 .' value="'.CGI::escapeHTML($val).'"'
 498                                 .' />'."\n");
 499                 } (keys(%{$W->{"args_persistent"}}))));
 500 }
 501
 502 sub http_moved($$;$)
 503 {
 504 my($self,$url,$status)=@_;
 505
 506         $url=url_out($url,"abs"=>1);
 507         $status||=HTTP_MOVED_TEMPORARILY;
 508         $W->{"r"}->status($status);
 509         $W->{"r"}->headers_out()->{"Location"}=$url;
 510         $W->{"header_only"}=1;
 511         My::Web->heading();
 512         exit;
 513         die "NOTREACHED";
 514 }
 515
 516 sub remote_ip ()
 517 {
 518         # Do not: PerlModule                 Apache2::ForwardedFor
 519         #         PerlPostReadRequestHandler Apache2::ForwardedFor
 520         # As 'Apache2::ForwardedFor' takes the first of $ENV{"HTTP_X_FORWARDED_FOR"}
 521         # while the contents is '127.0.0.1, 213.220.195.171' if client has its own proxy.
 522         # We must take the last item ourselves.
 523         my $r=$W->{"r"}->headers_in()->{"X-Forwarded-For"} || $W->{"r"}->get_remote_host();
 524         $r=~s/^.*,\s*//;
 525         return $r;
 526 }
 527
 528 sub is_cz ()
 529 {
 530         return 0 if !$have_Geo_IP;
 531         return "CZ" eq Geo::IP->new()->country_code_by_addr(remote_ip());
 532 }
 533
 534 sub a_href_cz ($$;%)
 535 {
 536 my($url,$contents,%args)=@_;
 537
 538         return a_href $url,$contents,%args if is_cz();
 539         return $contents;
 540 }
 541
 542 sub make ($)
 543 {
 544 my($cmd)=@_;
 545
 546         system {'flock'} 'flock','-x',top_dir_disk(),$cmd.' >&2';
 547 }
 548
 549 sub img_size ($$)
 550 {
 551 my($width,$height)=@_;
 552
 553         return ($W->{"have_style"} ? "style=\"border:0;width:${width}px;height:${height}px\"" : "border=\"0\"")
 554                         ." width=\"$width\" height=\"$height\"";
 555 }
 556
 557 sub negotiate_variant (%)
 558 {
 559 my(%args)=@_;
 560
 561         my @fields=("id","qs","content-type","encoding","charset","lang","size");
 562         return [ map(($args{$_}),@fields) ];
 563 }
 564
 565 # Input: $self is required!
 566 # Input: Put the fallback variant as the first one.
 567 # Returns: always only scalar!
 568 sub Negotiate_choose($$)
 569 {
 570 my($self,$variants)=@_;
 571
 572         my $best=HTTP::Negotiate::choose($variants,
 573                         # Do not: $W->{"r"}
 574                         # to prevent: Can't locate object method "scan" via package "Apache2::RequestRec" at HTTP/Negotiate.pm line 84.
 575                         # Do not: $W->{"r"}->headers_in()
 576                         # to prevent: Can't locate object method "scan" via package "APR::Table" at HTTP/Negotiate.pm line 84.
 577                         # Do not: HTTP::Headers->new($W->{"r"}->headers_in());
 578                         # to prevent empty result or even: Odd number of elements in anonymous hash
 579                         HTTP::Headers->new(%{$W->{"r"}->headers_in()}));
 580         $best||=$variants->[0]{"id"};   # &HTTP::Negotiate::choose failed?
 581         return $best;
 582 }
 583
 584 my @img_variants=(
 585                 { "id"=>"png","qs"=>0.9,"content-type"=>"image/png" },
 586                 { "id"=>"gif","qs"=>0.7,"content-type"=>"image/gif" },
 587                 );
 588 my $img_variants_re='[.](?:'.join('|',"jpeg",map(($_->{"id"}),@img_variants)).')$';
 589
 590 sub img_src ($)
 591 {
 592 my($file_base)=@_;
 593
 594         if (!url_is_local($file_base)) {
 595                 return $file_base if !wantarray();
 596                 return ($file_base,$file_base);
 597                 }
 598         # Known image extension?
 599         if ($file_base=~m#$img_variants_re#o) {
 600                 return $file_base if !wantarray();
 601                 return ($file_base,$file_base) if $file_base!~m#^/#;
 602                 return (top_dir($file_base),top_dir_disk().$file_base);
 603                 }
 604
 605         my $file_base_disk;
 606         my $file_base_uri;
 607         if ($file_base!~m#^/#) {
 608                 $file_base_disk=$file_base_uri=$file_base;
 609                 }
 610         else {
 611                 $file_base_disk=top_dir_disk().$file_base;
 612                 $file_base_uri=top_dir($file_base);
 613                 }
 614
 615         my @nego_variants;
 616         for my $var (@img_variants) {
 617                 my $file=$file_base_disk.".".$var->{"id"};
 618                 # TODO: Somehow quickly check dependencies?
 619                 make('make -s --no-print-directory'
 620                                                 .' -C '."'".File::Basename::dirname($file)."' '".File::Basename::basename($file)."'")
 621                                 if !-f $file;
 622                 push @nego_variants,negotiate_variant(
 623                                 %$var,
 624                                 "size"=>(stat $file)[7],
 625                                 );
 626                 }
 627         my $ext=__PACKAGE__->Negotiate_choose(\@nego_variants);
 628
 629         return $file_base_uri.".".$ext if !wantarray();
 630         return ($file_base_uri.".".$ext,$file_base_disk.".".$ext);
 631 }
 632
 633 sub img ($$;%)
 634 {
 635 my($file_base,$alt,%attr)=@_;
 636
 637         my($file_uri,$file_disk)=img_src $file_base;
 638         my($width,$height)=Image::Size::imgsize($file_disk);
 639         $alt=~s/<[^>]*>//g;
 640         $alt=CGI::escapeHTML($alt);
 641         my $content="<img src=\"$file_uri\" alt=\"$alt\" title=\"$alt\" ".img_size($width,$height)
 642                         .(!$attr{"attr"} ? "" : " ".$attr{"attr"})." />";
 643         return a_href img_src($attr{"a_href_img"}),$content if $attr{"a_href_img"};
 644         return a_href $attr{"a_href"},$content if $attr{"a_href"};
 645         return $content;
 646 }
 647
 648 sub centerimg
 649 {
 650         my $r.="";
 651         $r.='<table border="0" width="100%"><tr>'."\n";
 652         @_=( [@_] ) if !ref $_[0];
 653         for (@_) {
 654                 $r.="\t".'<td align="center">'.&{\&img}(@$_).'</td>'."\n";
 655                 }
 656         $r.='</tr></table>'."\n";
 657         return $r;
 658 }
 659
 660 sub rightimg
 661 {
 662 my($text,@args_img)=@_;
 663
 664         # Workaround bug of 'Mozilla/4.0 (compatible; MSIE 6.0; Windows NT 5.1)':
 665         return <<"HERE";
 666 <table border="0" width="100%">
 667         <col width="@{[ (!$W->{"browser"}->ie() ? "1*" : "90%" ) ]}" />
 668         <col width="@{[ (!$W->{"browser"}->ie() ? "0*" : "10%" ) ]}" />
 669         <tr>
 670                 <td align="left">
 671                         @{[ $text ]}
 672                 </td>
 673                 <td align="right">
 674                         @{[ &{\&img}(@args_img) ]}
 675                 </td>
 676         </tr>
 677 </table>
 678 HERE
 679 }
 680
 681 sub readfile ($$)
 682 {
 683 my($class,$filename)=@_;
 684
 685         local *F;
 686         open F,$filename or die "Cannot open \"$filename\": $!";
 687         local $/=undef();
 688         my $data=<F>;
 689         close F;
 690         return $data;
 691 }
 692
 693 sub arr_keys (@)
 694 {
 695 my(@arr)=@_;
 696
 697         my @r=();
 698         while (@arr) {
 699                 push @r,shift @arr;     # key
 700                 shift @arr;     # val
 701                 }
 702         return @r;
 703 }
 704
 705 sub no_cache($)
 706 {
 707 my($self)=@_;
 708
 709         header("Expires"=>"Mon, 26 Jul 1997 05:00:00 GMT");     # date in the past
 710         header("Last-Modified"=>strftime("%a, %d %b %Y %H:%M:%S GMT",gmtime()));        # always modified
 711         header("Cache-Control"=>"no-cache, must-revalidate");   # HTTP/1.1
 712         header("Pragma"=>"no-cache");   # HTTP/1.0
 713 }
 714
 715 sub heading ()
 716 {
 717 my($class)=@_;
 718
 719         # $ENV{"CLIENT_CHARSET"} ignored (mod_czech support dropped!)
 720         my $client_charset=$W->{"force_charset"} || "us-ascii";
 721         header("Content-Style-Type"=>"text/css");
 722         header("Content-Script-Type"=>"text/javascript");
 723         do { header("Content-Language"=>$_) if $_; } for $W->{"language"};
 724         $class->no_cache() if $W->{"no_cache"};
 725
 726         while (my($key,$val)=each(%{$W->{"headers"}})) {
 727                 $W->{"r"}->headers_out()->{$key}=$val;
 728                 }
 729         exit if $W->{"r"}->header_only();
 730         return if $W->{"header_only"};
 731         # We still can append headers before we put out some text.
 732         # FIXME: It is not clean to still append them without overwriting.
 733         return if $W->{"heading_done"}++;
 734
 735         my $lang=($W->{"language"}||"en-US");
 736         # Workaround bug
 737         #   https://bugzilla.mozilla.org/show_bug.cgi?id=120556
 738         # of at least
 739         #   Mozilla/5.0 (X11; U; Linux i686; en-US; rv:1.8b) Gecko/20050217
 740         my $mime=$class->Negotiate_choose([
 741                         # Put the fallback variant as the first one.
 742                         # Rate both variants the same to prefer "text/html" for undecided clients.
 743                         # At least
 744                         #   Mozilla/5.0 (X11; U; Linux i686; en-US; rv:1.8b) Gecko/20050217
 745                         # prefers "application/xhtml+xml" over "text/html" itself:
 746                         #   text/xml,application/xml,application/xhtml+xml,text/html;q=0.9,text/plain;q=0.8,image/png,*/*;q=0.5
 747                         negotiate_variant(
 748                                         "id"=>"text/html",
 749                                         "content-type"=>"text/html",
 750                                         "qs"=>0.6,
 751                                         "charset"=>$client_charset,
 752                                         "lang"=>$lang,
 753                                         ),
 754                         negotiate_variant(
 755                                         "id"=>"application/xhtml+xml",
 756                                         "content-type"=>"application/xhtml+xml",
 757                                         "qs"=>0.6,
 758                                         "charset"=>$client_charset,
 759                                         "lang"=>$lang,
 760                                         ),
 761                         # application/xml ?
 762                         # text/xml ?
 763                         ]);
 764         $W->{"r"}->content_type("$mime; charset=$client_charset");
 765         if (1) { # || !$msie_major || $msie_major>=4) # TODO:dyn
 766                 Wprint '<?xml version="1.0" encoding="'.$client_charset.'"?>'."\n";
 767                 }
 768         Wprint '<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.1//EN" "http://www.w3.org/TR/xhtml11/DTD/xhtml11.dtd">'."\n";
 769         Wprint '<html xmlns="http://www.w3.org/1999/xhtml" xml:lang="'.$lang.'">'."\n";
 770         my $title=$W->{"title_prefix"}.join("",map({ ': '.$_; } ($W->{"title"} || ())));
 771         $title=~s#<[^>]*>##g;
 772         Wprint "<head>";
 773         Wprint "<title>$title</title>\n";
 774         if ($W->{"have_css"}) {
 775                 # Everything can get overriden later.
 776                 Wprint <<"HERE";
 777 <link rel="stylesheet" type="text/css" href="@{[ url_out("/My/Web.css") ]}" />
 778 HERE
 779                 }
 780         Wprint '<meta name="robots" content="'.($W->{"indexme"} ? "" : "no" ).'index,follow" />'."\n";
 781         Wprint $W->{"head"};
 782         for my $type (qw(prev next index contents start up)) {
 783                 do { Wprint '<link rel="'.$type.'" href="'.$_.'" />'."\n" if $_; } for ($W->{"rel_$type"});
 784                 }
 785         Wprint "</head><body";
 786 #       Wprint ' bgcolor="black" text="white" link="aqua" vlink="teal"'
 787 #                       if $W->{"browser"}->netscape() && (!$W->{"browser"}->major() || $W->{"browser"}->major()<=4);
 788         Wprint $W->{"body_attr"};
 789         Wprint ">\n";
 790
 791         do { &{$_}() if $_; } for ($W->{"heading"});
 792 }
 793
 794 BEGIN {
 795         delete $W->{"__My::Web_init"};
 796         }
 797
 798 1;