charset: unabbreviated row labels if misaligned
[sheet.git] / charset.plp
index c9ef2b699501c55daf574b029e2316780d75d451..28c21c985c4e36ecb2c808ae7a6a029fd444b593 100644 (file)
-<:
-use utf8;
-use strict;
-use warnings;
-use open IO => ':utf8';
-
-our $VERSION = '1.0';
-
-$header{content_type} = 'text/html; charset=utf-8';
-
-:><!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN"
- "http://www.w3.org/TR/html4/loose.dtd">
-<html>
+<(common.inc.plp)><:
 
-<head>
-<title>charset cheat sheet</title>
-<meta http-equiv="content-type" content="utf-8">
-<link rel="stylesheet" type="text/css" media="all" href="/base.css">
-</head>
+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'],
+});
 
-<body>
+:>
 <h1>Character encoding</h1>
 
 <:
-my $diinfo = do 'digraphs.inc.pl';
-my %di = map { $diinfo->{$_}->[0] => $_ } grep { ref $diinfo->{$_} }
-       keys %$diinfo;
+use POSIX qw( ceil );
+use Shiar_Sheet::FormatChar;
+my $glyphs = Shiar_Sheet::FormatChar->new;
 
-use Encode qw(decode);
 # generate character table(s)
 # (~16x faster than decoding in loop;
 #  substr strings is twice as fast as splitting to an array)
-my @request = ('iso-8859-1', 'cp437');
-my @tables = map { decode($_, pack 'C*', 0..255) } @request;
+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, cols => 16);
+               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;
+               }
+               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} 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 {
+                               $row{table} = Encode::decode($row{set}, pack 'C*', $row{offset} .. $endpoint);
+                       }
+               }
+               else {
+                       Alert("Encoding <q>$input</q> unknown");
+               }
+               $row{set} ? \%row : ();
+       }
+       else {
+               ();
+       }
+} map { defined $ALIAS{$_} ? @{ $ALIAS{$_} } : $_ }
+       $Request =~ /\w/ ? split(m{[/+\s]}, $Request) : 'default';
 my $NOCHAR = chr 0xFFFD;
 
-for my $cp437 (grep {$request[$_] eq 'cp437'} 0 .. $#request) {
-       substr($tables[$cp437], 237, 1) = pack 'U*', 0x3D5; # phi sign
-       substr($tables[$cp437], 0, 32) = pack 'U*', map {hex} qw(
+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 quote {
-       local $_ = shift;
-       s/"/&quot;/g;
-       s/</&lt;/g;
-       s/>/&gt;/g;
-       return $_;
-}
+sub range_cell {
+       my ($info, $offset) = @_;
+       my $table = $info->{cell} or return;
+       my $def = $table->{$offset} or return;
+       my ($len, $class, $name, $title) = @{$def};
 
-print "<ul>\n";
+       my $cols = $info->{cols};
+       my $colsize = $table->{colsize} || 1;
+       my $attr = '';
+       $len /= $colsize;
+       $name //= $len <= 2 ? 'res' : 'reserved';
 
-my @nibble = (0..9, 'A'..'F');
-for my $tablenum (0 .. $#tables) {
-       print '<li><table class="glyphs">';
-       printf '<caption>%s</caption>', $request[$tablenum];
-       print '<col>';
-       for my $section (qw{thead}) {
-               print "<$section><tr><th>↱";
-               print '<th>', $_ for @nibble;
-               print "\n";
-       }
-       print '<tbody>';
-       for my $msb (0 .. $#nibble) {
-               print '<tr><th>', $nibble[$msb];
-               for my $lsb (0 .. $#nibble) {
-                       my $glyph = substr $tables[$tablenum], ($msb<<4) + $lsb, 1;
-                       if ($glyph eq $NOCHAR) {
-                               print '<td>';
-                               next;
+       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 = '';
                        }
-                       my $info = [ord $glyph];
-                       if (defined (my $mnem = $di{ord $glyph})) {
-                               $info = $diinfo->{$mnem};
+                       else {
+                               # minority on next row
+                               push @next, '"', $title || $name;
                        }
-                       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;
+                       $table->{$offset + $colsize*$rest} //= \@next;
+                       $class .= ' joind';
                }
-               print "\n";
+               $len = $rest;
        }
-       print "</table>\n";
+       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";
 }
 
-{
-       print '<li><table class="glyphs"><caption>UTF-8</caption><col>';
+for my $row (@request) {
+       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>';
-       print '<tr rowspan="8">';
-       for my $msb (0 .. $#nibble) {
-               print '<tr><th>', $nibble[$msb];
-               for my $lsb (0 .. $#nibble) {
-                       my $value = ($msb<<4) + $lsb;
-                       if ($value <= 0x7F) {
-                               print '<td rowspan="8" colspan="16" class="X di-a"',
-                                     ' title="U+0000 – U+007F">Single byte ASCII'
-                                       if $value == 0;
-                       }
-                       elsif ($value <= 0xBF) {
-                               print '<td rowspan="4" colspan="16" class="X di-d"',
-                                     '>Multi-byte continuation'
-                                       if $value == 0x80;
-                       }
-                       elsif ($value <= 0xC1) {
-                               print '<td colspan="2" class="X di-b" style="border-right:none; border-bottom:none"',
-                                     ' title="U+0000 – U+007F">(Overl.)'
-                                       if $value == 0xC0;
-                       }
-                       elsif ($value <= 0xDF) {
-                               print '<td rowspan="2" colspan="14" class="X di-prop" style="border-left:none"',
-                                     ' title="U+0080 – U+03FF">2-byte sequence start'
-                                       if $value == 0xC2;
-                               print '<td rowspan="1" colspan="16" class="X di-prop" style="border-top:none"',
-                                     ' title="U+0400 – U+07FF">'
-                                       if $value == 0xD0;
-                       }
-                       elsif ($value <= 0xEF) {
-                               print '<td colspan="16" class="X di-prop"',
-                                     ' title="U+0800 – U+FFFF">3-byte sequence start'
-                                       if $value == 0xE0;
-                       }
-                       elsif ($value <= 0xF4) {
-                               print '<td colspan="5" class="X di-prop" style="border-right:none"',
-                                     ' title="U+1·0000 – U+10·FFFF">4-byte sequence'
-                                       if $value == 0xF0;
-                       }
-                       elsif ($value <= 0xF7) {
-                               print '<td colspan="3" class="X di-b" style="border-left:none"',
-                                     ' title="U+11·0000 – U+1FF·FFFF">(Overflow)'
-                                       if $value == 0xF5;
+       while ($offset < $endpoint - 1) {
+               print '<tr><th>';
+               {
+                       if (my $rowmod = $offset % $rowdiv) {
+                               # offset in column units
+                               printf '<small>+%X</small>', $rowmod;
                        }
-                       elsif ($value <= 0xFB) {
-                               print '<td colspan="4" class="X di-b"',
-                                     ' title="U+200·0000 – U+3FFF·FFFF">5-byte'
-                                       if $value == 0xF8;
-                       }
-                       elsif ($value <= 0xFD) {
-                               print '<td colspan="2" class="X di-b"',
-                                     ' title="U+4000·0000 – 7FFFF·FFFF">6-byte'
-                                       if $value == 0xFC;
+                       else {
+                               # divided row offset
+                               printf '%X', ($offset + $row->{offset}) / $rowdiv;
                        }
-                       elsif ($value <= 0xFF) {
-                               print '<td colspan="2" class="di-invalid">Invalid'
-                                       if $value == 0xFE;
+               }
+               for (1 .. $cols) {
+                       if ($row->{cell}) {
+                               print range_cell($row, $offset);
+                               next;
                        }
-                       else {
-                               print "\n".'<td class="X">?';
+
+                       my $glyph = substr $row->{table}, $offset, 1;
+                       if ($glyph eq $NOCHAR) {
+                               print '<td>';
+                               next;
                        }
+
+                       print "\n".$glyphs->glyph_cell($glyph);
+               }
+               continue {
+                       $offset += $colsize;
                }
                print "\n";
        }
-       print "</table>\n";
+       say '</table></div>';
 }
 
-print "</ul>\n";
-
 :>
 <hr>
 
-<p class="footer">
-       <a href="http://sheet.shiar.nl/" rel="home">sheet.shiar.nl</a>/charset
-       <a href="git://git.shiar.nl/sheet" rel="vcs-git" title="Git repository"><:= "v$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> •
-       last update <:
-               use Time::Format qw(time_format);
-               print time_format('yyyy-mm-dd', (stat $ENV{SCRIPT_FILENAME})[9]);
-       :>
-</p>
-
-</html>
+<div class="legend">
+       <table class="glyphs"><tr>
+       <td class="X Cc">control
+       <td class="X Zs"><span>whitespace</span>
+       <td class="X Mn">diacritic<table class="glyphs"><tr>
+               <td class="X Sk">letter
+               </table>
+       <td class="X Po">punctuation<table class="glyphs"><tr>
+               <td class="X Pf">quote
+               </table>
+       <td class="X So">symbol<table class="glyphs"><tr>
+               <td class="X Sm">math
+               <td class="X Sc">currency
+               </table>
+       <td class="X No">numeric
+       <td class="X Greek">greek<table class="glyphs"><tr>
+               <td class="X Latin">latin
+               <td class="X Cyrillic">cyrillic
+               </table>
+       <td class="X Aramaic">aramaic<table class="glyphs"><tr>
+               <td class="X Brahmic">brahmic
+               <td class="X Arabic">arabic
+               </table>
+       <td class="X Syllabic">syllabic<table class="glyphs"><tr>
+               <td class="X African">african
+               <td class="X Hiragana">japanese
+               <td class="X Han">cjk
+               <td class="X Bopomofo">chinese
+               </table>
+       <td class="X Alpha">alphabetic
+       </table>
+
+       <table class="glyphs"><tr>
+       <td class="X">unicode 7.0
+       <td class="X Xr">proposed
+       <td class="X Xd">deprecated
+       <td class="">unassigned
+       <td class="X Xi">invalid
+       </table>
+</div>
+