charset: numeric offset parameters
[sheet.git] / charset.plp
index 501e26c3b2af683970755840687812240ecbd022..7794284f7ff685f4db1f6ef2279a249841dfc76b 100644 (file)
-<:
-use utf8;
-use strict;
-use warnings;
-use open IO => ':utf8';
-
-our $VERSION = 'v1.0';
+<(common.inc.plp)><:
 
-$header{content_type} = 'text/html; charset=utf-8';
+Html({
+       title => 'charset cheat sheet',
+       version => '1.0',
+       description => [
+               "Reference sheet with all glyphs in common character encoding tables,",
+               "and an overview of Unicode ranges and UTF-8 bytes.",
+       ],
+       keywords => [qw'
+               charset codepage unicode ascii utf8 latin glyph character encoding
+               reference common overview table
+       '],
+       stylesheet => [qw'light'],
+       data => [qw'charset-unicode.inc.pl charset-utf8.inc.pl'],
+});
 
-:><!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN"
- "http://www.w3.org/TR/html4/loose.dtd">
-<html>
+my @tablist = split /[^\w-]+/, $Request || 'default';
 
-<head>
-<meta http-equiv="content-type" content="<:= $header{content_type} :>">
-<title>charset cheat sheet</title>
-<link rel="stylesheet" type="text/css" media="all" href="/base.css">
-</head>
-
-<body>
+:>
 <h1>Character encoding</h1>
 
 <:
-my $diinfo = do 'digraphs.inc.pl';
-my %di = map { $diinfo->{$_}->[0] => $_ } grep { ref $diinfo->{$_} }
-       keys %$diinfo;
-
-use Encode qw(decode resolve_alias);
-# generate character table(s)
-# (~16x faster than decoding in loop;
-#  substr strings is twice as fast as splitting to an array)
-my %ALIAS = (
-#      default => [qw(unicode utf-8 iso-8859-1 cp437 -cp1252- --iso-8859-15- -koi8-f)],
-       default => [qw(unicode- utf-8 iso-8859-1 -cp1252- --iso-8859-15- cp437 -cp850)],
-       0 => [qw(cp437 cp863)],
-       1 => [qw(iso-8859-1 cp1252 MacRoman cp850)],
-       2 => [qw(iso-8859-2 cp1250 cp852 MacCentralEurRoman MacCroatian MacRumanian)],
-       5 => [qw(koi8-f iso-8859-5 cp1251 MacCyrillic cp855 cp866)],
-       7 => [qw(iso-8859-7 cp1253 MacGreek cp737 cp869)],
-       8 => [qw(iso-8859-8 cp1255 MacHebrew cp862)],
-);
-my @request = map {
-       if (my $input = $_) {
-               my %row = (offset => 0);
-               my $endpoint = 255;
-               if ($input =~ s/^--//) {
-                       $row{offset} = $endpoint > 160 ? 160 : 48;
-               }
-               elsif ($input =~ s/^-//) {
-                       $row{offset} = $endpoint > 128 ? 128 : 32;
-               }
-               if ($input =~ s/-$//) {
-                       $endpoint = $row{offset} ? $row{offset} < 160 ? 159 : 191 : 127;
-               }
+use POSIX qw( ceil );
+use Shiar_Sheet::FormatChar;
+my $glyphs = Shiar_Sheet::FormatChar->new;
 
-               if ($input =~ /^U([0-9a-f]+)(?:-([0-9a-f]+))?/) {
-                       my $start = hex($1) << ($2 ? 4 : 8);
-                       my $end = $2 ? hex($2) << 4 : $start + 240;
-                       $row{table} = join '', map { chr } $start .. $end+15;
-                       utf8::upgrade($row{table});  # prevent latin1 output
-                       $row{set} = sprintf 'Unicode block U+%02Xxx', $start >> 8;
-               }
-               elsif ($input eq 'U') {
-                       $row{table} = ' ' x 512;
-                       $row{set} = 'Unicode planes';
-                       $row{cell} = do 'charset-ucplanes.inc.pl';
+sub tabinput {
+       # generate character table(s)
+       my $input = shift or return;
+
+       state $ALIAS = {
+               default    => [qw( unicode+0-192 utf-8 iso-8859-1 cp1252+128-159 iso-8859-15+160-191 cp437 cp850+128 )],
+               us         => [qw( cp437 cp863+128 AdobeStandardEncoding gsm0338+0-127 )],
+               ebcdic     => [qw( cp37 cp500  cp875  cp1026  cp1047  posix-bc )],
+               westeur    => [qw( iso-8859-1 iso-8859-15+160-191 cp1252+128-159 iso-8859-14+160 cp850+128 MacRoman+128 nextstep+128 hp-roman8+160 )],
+               centeur    => [qw( iso-8859-2 iso-8859-16+160 cp1250+128 cp852+128 MacCentralEurRoman+128 MacCroatian+128 MacRomanian+128 )], # MacRumanian only for DB
+               turkish    => [qw( iso-8859-3 iso-8859-9+128 cp857+128 cp1254+128 MacTurkish+128 )],
+               baltic     => [qw( iso-8859-4 iso-8859-13+160 cp775+128 cp1257+128 )],
+               nordic     => [qw( iso-8859-10 cp865+128 cp861+160-191 MacIcelandic+128 MacSami+160 )],
+               cyrillic   => [qw( koi8-f koi8-r+128-192 koi8-u+160-192 iso-8859-5+128 cp1251+128 MacCyrillic+128 cp855+128 cp866+128 )], # MacUkrainian is broken
+               arabic     => [qw( iso-8859-6 cp1006+160 cp864+128 cp1256+128 MacArabic )], # MacFarsi same as MacArabic?
+               greek      => [qw( iso-8859-7 cp1253+128 MacGreek+128 cp737+128 cp869+128 )],
+               hebrew     => [qw( iso-8859-8 cp1255+128 MacHebrew+128 cp862+128 )],
+               thai       => [qw( iso-8859-11 cp874+128-159 MacThai+128 )],
+               vietnamese => [qw( viscii cp1258 MacVietnamese )],
+               symbol     => [qw( symbol dingbats MacDingbats AdobeZdingbat AdobeSymbol )],
+               # iso-code shorthand
+               1 => 'westeur',
+               2 => 'centeur',
+               3 => 'turkish',
+               4 => 'baltic',
+               5 => 'cyrillic',
+               6 => 'arabic',
+               7 => 'greek',
+               8 => 'hebrew',
+               9 => 'turkish',
+               10 => 'nordic',
+               11 => 'thai',
+       };
+       if (my $follow = $ALIAS->{$input}) {
+               return map { tabinput($_) } ref $follow ? @{$follow} : $follow;
+       }
+
+       my %row = (offset => 0, cols => 16);
+       my $endpoint = 255;
+       my $params = $input =~ s/[+](.*)\z// ? $1 : undef;
+
+       if (defined $params and $params =~ m/^ (\d+) (-\d+)? /x) {
+               $row{offset} = $1;
+               $endpoint = -$2 if $2;
+       }
+       if ($row{offset}) {
+               $row{setnote} = 'over cp437' if $input eq 'cp850';
+               $row{setnote} = 'over iso-8859-1' if $input =~ /^iso-8859-|^cp125/;
+       }
+
+       if ($input =~ /^U([0-9a-f]+)(?:-([0-9a-f]+))?/) {
+               my $start = hex($1) << ($2 ? 4 : 8);
+               my $end = $2 ? hex($2) << 4 : $start + 240;
+               $row{table} = join '', map { chr } $start .. $end+15;
+               utf8::upgrade($row{table});  # prevent latin1 output
+               $row{set} = sprintf 'Unicode block U+%02Xxx', $start >> 8;
+       }
+       elsif ($input eq 'U') {
+               $row{table} = ' ' x 1024;
+               $row{set} = 'Unicode planes';
+               $row{cell} = do 'charset-ucplanes.inc.pl'
+                       or Alert('Table data could not be read', $@ || $!);
+               $row{cols} *= 2;
+       }
+       elsif ($row{set} = Encode::resolve_alias($input)) {
+               if ($row{set} eq 'Internal') {
+                       $row{table} = ' ' x ($endpoint < 255 ? 640 : 8192);
+                       $row{set} = 'Unicode BMP';
+                       $row{cell} = do 'charset-unicode.inc.pl'
+                               or Alert('Table data could not be read', $@ || $!);
                }
-               elsif ($row{set} = resolve_alias($input)) {
-                       if ($row{set} eq 'Internal') {
-                               $row{table} = ' ' x ($endpoint < 255 ? 640 : 4096);
-                               $row{set} = 'Unicode BMP';
-                               $row{cell} = do 'charset-unicode.inc.pl';
-                       }
-                       elsif ($row{set} eq 'utf-8-strict') {
-                               $row{table} = undef;
-                               $row{set} = 'UTF-8';
-                               $row{cell} = do 'charset-utf8.inc.pl';
-                       }
-                       else {
-                               $row{table} = decode($row{set}, pack 'C*', $row{offset} .. $endpoint);
-                       }
+               elsif ($row{set} eq 'utf-8-strict') {
+                       $row{table} = undef;
+                       $row{set} = 'UTF-8';
+                       $row{cell} = do 'charset-utf8.inc.pl'
+                               or Alert('Table data could not be read', $@ || $!);
                }
                else {
-                       print "<p>Encoding $input unknown</p>\n";
+                       $row{table} = Encode::decode($row{set}, pack 'C*', $row{offset} .. $endpoint);
+                               # (~16x faster than decoding in loop;
+                               #  substr strings is twice as fast as splitting to an array)
+
+                       if ($row{set} eq 'cp437') {
+                               substr($row{table}, 237, 1) = pack 'U*', 0x3D5; # phi sign
+                               substr($row{table}, 0, 32) = pack 'U*', map {hex} qw(
+                                       2007 263A 263B 2665 2666 2663 2660 2022
+                                       25D8 25CB 25D9 2642 2640 266A 266B 263C
+                                       25BA 25C4 2195 203C 00B6 00A7 25AC 21A8
+                                       2191 2193 2192 2190 221F 2194 25B2 25BC
+                               );
+                       }
                }
-               \%row;
        }
        else {
-               ();
+               Alert("Encoding <q>$input</q> unknown");
+               return;
        }
-} map { defined $ALIAS{$_} ? @{ $ALIAS{$_} } : $_ }
-       $ENV{PATH_INFO} =~ /\w/ ? split(m{[/+\s]}, $ENV{PATH_INFO}) : 'default';
+       return \%row;
+}
+my @request = map { tabinput($_) } @tablist;
+
 my $NOCHAR = chr 0xFFFD;
 
-for my $cp437 (grep {$request[$_]->{set} eq 'cp437'} 0 .. $#request) {
-       substr($request[$cp437]->{table}, 237, 1) = pack 'U*', 0x3D5; # phi sign
-       substr($request[$cp437]->{table}, 0, 32) = pack 'U*', map {hex} qw(
-               2007 263A 263B 2665 2666 2663 2660 2022 25D8 25CB 25D9 2642 2640 266A 266B 263C
-               25BA 25C4 2195 203C 00B6 00A7 25AC 21A8 2191 2193 2192 2190 221F 2194 25B2 25BC
-       );
-}
+sub range_cell {
+       my ($info, $offset) = @_;
+       my $table = $info->{cell} or return;
+       my $def = $table->{$offset} or return;
+       my ($len, $class, $name, $title) = @{$def};
 
-sub quote {
-       local $_ = shift;
-       s/"/&quot;/g;
-       s/</&lt;/g;
-       s/>/&gt;/g;
-       return $_;
-}
+       my $cols = $info->{cols};
+       my $colsize = $table->{colsize} || 1;
+       my $attr = '';
+       $len /= $colsize;
+       $name //= $len <= 2 ? 'res' : 'reserved';
 
-print "<ul>\n";
+       if (my $part = $offset/$colsize % $cols) {
+               # continued row
+               my $rest = $cols - $part;  # remaining
+               $rest = $len if $len < $rest; #TODO: optimise
+               if ($len -= $rest) {
+                       # continued on new row
+                       my @next = ($len * $colsize, "$class joinu");
+                       if ($len > $rest) {
+                               # minority remains
+                               push @next, $name, $title;
+                               $title ||= $name;
+                               $name = '';
+                       }
+                       else {
+                               # minority on next row
+                               push @next, '"', $title || $name;
+                       }
+                       $table->{$offset + $colsize*$rest} //= \@next;
+                       $class .= ' joind';
+               }
+               $len = $rest;
+       }
+       elsif (my $rows = int($len / $cols)) {
+               # multiple full rows
+               if ($len -= $rows * $cols) {
+                       # partial row remains
+                       $table->{$offset + $colsize*$rows * $cols} //= [$len*$colsize, "$class joinu", '', $title];
+                       $class .= ' joind';
+               }
+               $attr .= sprintf ' rowspan=%d', $rows;
+               $len = $cols;
+       }
+
+       $attr .= sprintf ' colspan=%d', $len unless $len == 1;
+       $attr .= $1 if $class and $class =~ s/( \w+="[^"]*")//;
+       $attr .= sprintf ' class="%s"', $class if $class;
+       $attr .= sprintf ' title="%s"', EscapeHTML($title) if $title;
+       return "<td$attr>$name";
+}
 
-my @nibble = (0..9, 'A'..'F');
 for my $row (@request) {
-       printf '<li><table class="glyphs%s">', !$row->{cell} && ' charmap';
-       printf '<caption>%s</caption>', $row->{set};
-       print '<col>' x 17;
+       my $cols = $row->{cols};
+       my $colsize = $row->{cell} && $row->{cell}->{colsize} || 1;
+       my $coldigits = ceil(log($colsize * $cols) / log(16));  # uniform length of hexadecimal header
+       my $rowdiv = 16 ** $coldigits;  # row divide for column digits
+       $rowdiv = 1 if $rowdiv != $cols * $colsize;  # divide only if all columns are matched
+       my $offset = 0;
+       my $endpoint = $offset + (length($row->{table}) || 256) * $colsize;
+
+       printf '<div class="section"><table class="glyphs%s">', !$row->{cell} && ' charmap';
+       my $title = $row->{set};
+       $title .= " <aside>($_)</aside>" for $row->{setnote} // ();
+       printf '<caption>%s</caption>', $title;
+       print '<col>' x ($cols + 1);
        for my $section (qw{thead}) {
-               print "<$section><tr><th>↱";
-               print '<th>', $_ for @nibble;
+               print "<$section><tr><th>", $rowdiv == 1 ? '+' : '↱';
+               printf '<th>%0*X', $coldigits, $_ * $colsize for 0 .. $cols - 1;
                print "\n";
        }
        print '<tbody>';
-       for my $msb (0 .. (length($row->{table}) || 256) - 1 >> 4) {
-               printf '<tr><th>%X', $msb + ($row->{offset} >> 4);
-               for my $lsb (0 .. $#nibble) {
+       while ($offset < $endpoint - 1) {
+               print '<tr><th>';
+               {
+                       if (my $rowmod = $offset % $rowdiv) {
+                               # offset in column units
+                               printf '<small>+%X</small>', $rowmod;
+                       }
+                       else {
+                               # divided row offset
+                               printf '%X', ($offset + $row->{offset}) / $rowdiv;
+                       }
+               }
+               for (1 .. $cols) {
                        if ($row->{cell}) {
-                               print $row->{cell}->(($msb<<4) + $lsb);
+                               print range_cell($row, $offset);
                                next;
                        }
 
-                       my $glyph = substr $row->{table}, ($msb<<4) + $lsb, 1;
+                       my $glyph = substr $row->{table}, $offset, 1;
                        if ($glyph eq $NOCHAR) {
                                print '<td>';
                                next;
                        }
 
-                       my $info = [ord $glyph];
-                       if (defined (my $mnem = $di{ord $glyph})) {
-                               $info = $diinfo->{$mnem};
-                       }
-                       else {
-                               require Unicode::UCD;
-                               my $fullinfo = Unicode::UCD::charinfo(ord $glyph);
-                               $info = [@$fullinfo{qw/code name category script string/}] if $fullinfo;
-                       }
-                       my ($codepoint, $name, $prop, $script, $string) = @$info;
-
-                       $glyph = quote($string || $glyph);
-                       my $desc = sprintf 'U+%04X%s', $codepoint, $name && " ($name)";
-                       my @class = ('X', grep {$_} $prop, $script);
-
-                       $glyph = "<span>$glyph</span>" if $prop eq 'Zs';
-
-                       printf "\n".'<td class="%s" title="%s">%s',
-                               join(' ', @class), quote($desc), $glyph;
+                       print "\n".$glyphs->glyph_cell($glyph);
+               }
+               continue {
+                       $offset += $colsize;
                }
                print "\n";
        }
-       print "</table>\n";
+       say '</table></div>';
 }
 
-print "</ul>\n";
-
 :>
 <hr>
 
@@ -199,7 +270,7 @@ print "</ul>\n";
        </table>
 
        <table class="glyphs"><tr>
-       <td class="X">unicode 5.0
+       <td class="X">unicode 7.0
        <td class="X Xr">proposed
        <td class="X Xd">deprecated
        <td class="">unassigned
@@ -207,12 +278,3 @@ print "</ul>\n";
        </table>
 </div>
 
-<p class="footer">
-       <a href="/" rel="home">sheet.shiar.nl</a>/charset.<a href="/source/charset.plp" rel="code">plp</a>
-       <a href="http://git.shiar.nl/sheet.git" rel="vcs-git" title="Git repository"><:= $VERSION :></a>
-       created by <a href="http://shiar.nl/" rel="author">Shiar</a> •
-       <a title="Licensed under the GNU Affero General Public License, version 3" rel="copyright"
-          href="http://www.fsf.org/licensing/licenses/agpl-3.0.html">AGPLv3</a>
-</p>
-
-</html>