common: bump version to 1.11
[sheet.git] / common.inc.plp
index f6cd6a6f7a93452a66346a7fdef08af0f5a7da43..e3316fc439a00246e5454d0f64194b3a1fb460a6 100644 (file)
@@ -1,6 +1,6 @@
 <:
+use 5.014;
 use utf8;
-use strict;
 use warnings;
 no  warnings 'qw';  # you know what you doing
 no  warnings 'uninitialized';  # save some useless checks for more legible code
@@ -8,11 +8,40 @@ use open ':std' => ':utf8';
 
 use File::stat 'stat';
 use HTTP::Date;
+use Encode qw( decode_utf8 );
+
+sub Alert {
+       my ($html, $debug) = @_;
+       ref $html eq 'ARRAY' or $html = [$html];
+       my ($title, @lines) = @{$html};
+       $body = "<h2>$title</h2>";
+       $body .= "\n<p>$_</p>" for @lines;
+       $body .= "\n<pre>$debug</pre>" if $Dev and $debug;
+       say "<div class=error>$body</div>\n";
+}
+
+BEGIN {
+       require Time::HiRes;
+       our $Time = [Time::HiRes::gettimeofday()];
+
+       $PLP::ERROR = sub {
+               my ($text, $html) = @_;
+               warn $text;
+               unless ($PLP::sentheaders and $PLP::sentheaders->[0] !~ m{/PLP\.pm$}) {
+                       Html({nocache => 1});
+                       say '<h1>Page unavailable</h1>';
+               }
+               Alert("<strong>Fatal error</strong>: $html.");
+       };
+
+       push @INC, '.';
+
+       # user request
+       our $Dev = $ENV{HTTP_HOST} =~ /\bdev\./;
+       our ($file) = $ENV{SCRIPT_FILENAME} =~ m{ ([^/]+) \.plp$ }x;
+}
 
-$PLP::ERROR = sub {
-       my ($text, $html) = @_;
-       print '<p class="error"><strong>Fatal error</strong>: '.$html."</p>\n\n";
-};
+our $Request = decode_utf8($ENV{PATH_INFO} =~ s{^/}{}r);
 
 our $style;
 our $showkeys = !exists $get{keys} ? undef :
@@ -21,7 +50,9 @@ our $showkeys = !exists $get{keys} ? undef :
 $header{content_type} = 'text/html; charset=utf-8';
 
 sub stylesheet {
-       my %styles = map {$_ => $_} @_;
+       my ($avail) = @_;
+       my @avail = ref $avail eq 'ARRAY' ? @{$avail} : $avail or return;
+       my %styles = map {$_ => $_} @avail;
 
        if (defined( my $setstyle = $get{style} )) {
                $style = $styles{ $setstyle };
@@ -30,23 +61,23 @@ sub stylesheet {
                        my $cookie = CGI::Cookie->new(
                                -name    => 'style',
                                -value   => $setstyle || '',
-                               -path    => '/',  # site-wide; current page is confusing to most users
+                               -path    => '/',  # site-wide
                                -expires => $setstyle ? '+5y' : '-1d',
                        ) or die "empty object returned\n";
                        AddCookie($cookie->as_string);
                } or warn "Unable to create style cookie: $@";
        }
 
-       $style ||= exists $cookie{style} && $styles{ $cookie{style} } || $_[0];
+       $style ||= exists $cookie{style} && $styles{ $cookie{style} } || $avail[0];
 
-       return join "\n", map { sprintf(
+       return map { sprintf(
                '<link rel="%s" type="text/css" media="all" href="%s" title="%s">',
-               $_ eq $style ? 'stylesheet' : 'alternate stylesheet', "/$_.css?1.6", $_
-       ) } @_;
+               $_ eq $style ? 'stylesheet' : 'alternate stylesheet', "/$_.css?1.11", $_
+       ) } @avail;
 }
 
 sub checkmodified {
-       my $lastmod;
+       my $lastmod = 0;
        for (@_) {
                my $mod = stat $_ or next;
                $mod = $mod->mtime or next;
@@ -65,53 +96,72 @@ sub checkmodified {
 sub Html {
        my ($meta) = @_;
 
-       # announce and check data modification
-       checkmodified(
-               $ENV{SCRIPT_FILENAME},
-               (grep { /\bShiar_/ } values %INC),
-               $meta->{data} ? @{ $meta->{data} } : (),
-       );
-       $header{'Cache-Control'} = sprintf 'max-age: ', 24*60*60;
+       unless ($meta->{nocache}) {
+               # announce and check data modification
+               checkmodified(
+                       $ENV{SCRIPT_FILENAME},
+                       (grep { /\bShiar_/ } values %INC),
+                       $meta->{data} ? @{ $meta->{data} } : (),
+               );
+               $header{'Cache-Control'} = 'max-age='.(24*60*60);
+       }
 
        # default fallbacks
-       $meta->{stylesheet} ||= [qw'light dark circus mono red terse'];
+       $meta->{stylesheet} ||= [qw( light dark circus mono red )];
        $meta->{charset} ||= 'utf-8';
 
+       # convert options to arrays
+       ref $_ eq 'ARRAY' or $_ = [$_]
+               for grep {$_} $meta->{raw}, $meta->{description}, $meta->{keywords};
+
+       # document headers before output
+       $header{content_type} = "text/html; charset=$meta->{charset}"
+               unless $PLP::sentheaders;
+       unshift @{ $meta->{raw} }, stylesheet($meta->{stylesheet});
+
+       push @{ $meta->{raw} }, (
+               '<link rel="stylesheet" type="text/css" media="monochrome" href="/mono.css?1.11" title="light">',
+       );
+
        # optional amends
        push @{ $meta->{raw} }, (
                '<!--[if lte IE 6]><style> .help dl.legend dt {margin:0 0 1px} </style><![endif]-->',
                '<!--[if lte IE 7]><style> .help dl.legend dd {float:none} </style><![endif]-->',
-               !$showkeys ? '<style type="text/css"> .no {visibility:hidden} </style>'
-                       : $showkeys eq 'ghost' ? '<style type="text/css"> .no, .alias {opacity:.5} </style>'
-                       : (),
-               '<script type="text/javascript" src="/keys.js?1.6"></script>',
+               !$showkeys ? '<style> .no {visibility:hidden} </style>' :
+               $showkeys eq 'ghost' ? '<style> .no, .alias {opacity:.5} </style>' : (),
+               '<script type="text/javascript" src="/keys.js?1.6" async></script>',
        ) if $meta->{keys};
 
-       # flatten arrays
-       ref $_ eq 'ARRAY' and $_ = join ' ',  @$_ for $meta->{description};
-       ref $_ eq 'ARRAY' and $_ = join ', ', @$_ for $meta->{keywords};
-       ref $_ eq 'ARRAY' and $_ = join "\n", @$_ for $meta->{raw};
-       ref $_ eq 'ARRAY' and $_ = stylesheet(@$_)."\n" for $meta->{stylesheet};
-
-       # other vars
-       my ($file) = $ENV{SCRIPT_FILENAME} =~ m{ ([^/]+) \.plp$ }x;
-
        # leading output
-       $header{content_type} = "text/html; charset=$meta->{charset}";
-       print <<"EOT";
-<!DOCTYPE html>
-<html lang="en">
-
-<head>
-<meta http-equiv="content-type" content="$header{content_type}">
-<title>$meta->{title}</title>
-<meta name="description" content="$meta->{description}">
-<meta name="keywords" content="$meta->{keywords}">
-<link rel="icon" type="image/png" href="/clip.png">
-EOT
-       print $_, "\n" for $meta->{stylesheet} || ();
-       print $_, "\n" for $meta->{raw} || ();
-       print qq{</head>\n\n<body id="$file">\n};
+       say '<!DOCTYPE html>';
+       say '<html lang="en">';
+       say '';
+       say '<head>';
+       say sprintf '<meta http-equiv="content-type" content="%s">', $_
+               for $header{content_type};
+       say sprintf '<title>%s</title>', $meta->{title};
+       say sprintf '<meta name="description" content="%s">', EscapeHTML($_)
+               for join(' ', @{ $meta->{description} }) || ();
+       say sprintf '<meta name="keywords" content="%s">', EscapeHTML($_)
+               for join(', ', @{ $meta->{keywords} }) || ();
+       say '<meta name="viewport" content="width=device-width, initial-scale=1">';
+       say '<link rel="icon" type="image/png" href="/clip.png">';
+       say for map { @{$_} } $meta->{raw} || ();
+       say '<meta name="robots" content="noindex">' if $Dev;
+       say '</head>';
+       say '';
+       say sprintf '<body id="%s">', $file;
+
+       # development version indicator
+       printf '<p style="%s">beta</p>', join('; ',
+               'position: fixed',
+               'right: 1em',
+               'opacity: .5',
+               'border: 1ex solid red',
+               'border-width: 1ex 0',
+               'z-index: 1',
+               'background: inherit',
+       ) if $Dev;
 
        # prepare trailing output
        PLP_END {
@@ -119,15 +169,26 @@ EOT
 <p class="footer">
        <a href="/" rel="start">sheet.shiar.nl</a>/$file.<a href="/source/$file.plp"
         rel="source" title="Written in Perl">plp</a>
-       <a href="http://git.shiar.nl/sheet.git/history/HEAD:/$file.plp"
+       version <a href="http://git.shiar.nl/sheet.git/history/HEAD:/$file.plp"
         rel="vcs-git" title="Git repository">$meta->{version}</a>
        created by <a href="http://shiar.nl/" rel="author">Shiar</a> •
-       <a href="http://www.fsf.org/licensing/licenses/agpl-3.0.html" rel="license copyright"
-        title="Licensed under the GNU Affero General Public License, version 3">AGPLv3</a>
-</p>
-
-</html>
+       <a href="http://www.fsf.org/licensing/licenses/agpl-3.0.html"
+        title="Licensed under the GNU Affero General Public License, version 3"
+        rel="license">AGPLv3</a>
 EOT
+               say sprintf '• %.3fs', Time::HiRes::tv_interval($Time) if $Dev and $Time;
+               say '</p>';
+               say '';
+               say '</html>';
        };
 }
 
+sub showlink {
+       my ($title, $href, $selected) = @_;
+       return sprintf(
+               !$href ? '%s' :
+               $selected ? '<strong>%s</strong>' : '<a href="%2$s">%s</a>',
+               EscapeHTML($title), EscapeHTML($href)
+       );
+}
+