charset.plp

   1 <(common.inc.plp)><:
   2
   3 Html({
   4         title => 'charset cheat sheet',
   5         version => '1.0',
   6         description => [
   7                 "Reference sheet with all glyphs in common character encoding tables,",
   8                 "and an overview of Unicode ranges and UTF-8 bytes.",
   9         ],
  10         keywords => [qw'
  11                 charset codepage unicode ascii utf8 latin glyph character encoding
  12                 reference common overview table
  13         '],
  14         stylesheet => [qw'light'],
  15         data => [qw'charset-unicode.inc.pl charset-utf8.inc.pl'],
  16 });
  17
  18 :>
  19 <h1>Character encoding</h1>
  20
  21 <:
  22 use Shiar_Sheet::FormatChar;
  23 my $glyphs = Shiar_Sheet::FormatChar->new;
  24 my @nibble = (0..9, 'A'..'F');
  25 my $nibsize = 1;
  26
  27 # generate character table(s)
  28 # (~16x faster than decoding in loop;
  29 #  substr strings is twice as fast as splitting to an array)
  30 my %ALIAS = (
  31 #       default => [qw(unicode utf-8 iso-8859-1 cp437 -cp1252- --iso-8859-15- -koi8-f)],
  32         default => [qw(unicode- utf-8 iso-8859-1 -cp1252- --iso-8859-15- cp437 -cp850)],
  33         0 => [qw(cp437 -cp863)],
  34         1 => [qw(iso-8859-1 -cp1252 -MacRoman -cp850)],
  35         2 => [qw(iso-8859-2 -cp1250 -cp852 -MacCentralEurRoman -MacCroatian -MacRumanian)],
  36         5 => [qw(koi8-f -iso-8859-5 -cp1251 -MacCyrillic -cp855 -cp866)],
  37         7 => [qw(iso-8859-7 -cp1253 -MacGreek -cp737 -cp869)],
  38         8 => [qw(iso-8859-8 -cp1255 -MacHebrew -cp862)],
  39 );
  40 my @request = map {
  41         if (my $input = $_) {
  42                 my %row = (offset => 0);
  43                 my $endpoint = 255;
  44                 if ($input =~ s/^--//) {
  45                         $row{offset} = $endpoint > 160 ? 160 : 48;
  46                 }
  47                 elsif ($input =~ s/^-//) {
  48                         $row{offset} = $endpoint > 128 ? 128 : 32;
  49                 }
  50                 if ($input =~ s/-$//) {
  51                         $endpoint = $row{offset} ? $row{offset} < 160 ? 159 : 191 : 127;
  52                 }
  53                 if ($row{offset}) {
  54                         $row{setnote} = 'over cp437' if $input eq 'cp850';
  55                         $row{setnote} = 'over iso-8859-1' if $input =~ /^iso-8859-|^cp125/;
  56                 }
  57
  58                 if ($input =~ /^U([0-9a-f]+)(?:-([0-9a-f]+))?/) {
  59                         my $start = hex($1) << ($2 ? 4 : 8);
  60                         my $end = $2 ? hex($2) << 4 : $start + 240;
  61                         $row{table} = join '', map { chr } $start .. $end+15;
  62                         utf8::upgrade($row{table});  # prevent latin1 output
  63                         $row{set} = sprintf 'Unicode block U+%02Xxx', $start >> 8;
  64                 }
  65                 elsif ($input eq 'U') {
  66                         $row{table} = ' ' x 1024;
  67                         $row{set} = 'Unicode planes';
  68                         $row{cell} = do 'charset-ucplanes.inc.pl'
  69                                 or Alert('Table data could not be read', $@ || $!);
  70                         @nibble = (map { $_.0, $_.8 } 0 .. 7);
  71                         $nibsize = 8;
  72                 }
  73                 elsif ($row{set} = Encode::resolve_alias($input)) {
  74                         if ($row{set} eq 'Internal') {
  75                                 $row{table} = ' ' x ($endpoint < 255 ? 640 : 8192);
  76                                 $row{set} = 'Unicode BMP';
  77                                 $row{cell} = do 'charset-unicode.inc.pl'
  78                                         or Alert('Table data could not be read', $@ || $!);
  79                         }
  80                         elsif ($row{set} eq 'utf-8-strict') {
  81                                 $row{table} = undef;
  82                                 $row{set} = 'UTF-8';
  83                                 $row{cell} = do 'charset-utf8.inc.pl'
  84                                         or Alert('Table data could not be read', $@ || $!);
  85                         }
  86                         else {
  87                                 $row{table} = Encode::decode($row{set}, pack 'C*', $row{offset} .. $endpoint);
  88                         }
  89                 }
  90                 else {
  91                         Alert("Encoding <q>$input</q> unknown");
  92                 }
  93                 $row{set} ? \%row : ();
  94         }
  95         else {
  96                 ();
  97         }
  98 } map { defined $ALIAS{$_} ? @{ $ALIAS{$_} } : $_ }
  99         $Request =~ /\w/ ? split(m{[/+\s]}, $Request) : 'default';
 100 my $NOCHAR = chr 0xFFFD;
 101
 102 for my $cp437 (grep {$request[$_]->{set} eq 'cp437'} 0 .. $#request) {
 103         substr($request[$cp437]->{table}, 237, 1) = pack 'U*', 0x3D5; # phi sign
 104         substr($request[$cp437]->{table}, 0, 32) = pack 'U*', map {hex} qw(
 105                 2007 263A 263B 2665 2666 2663 2660 2022 25D8 25CB 25D9 2642 2640 266A 266B 263C
 106                 25BA 25C4 2195 203C 00B6 00A7 25AC 21A8 2191 2193 2192 2190 221F 2194 25B2 25BC
 107         );
 108 }
 109
 110 sub range_cell {
 111         my ($table, $offset) = @_;
 112         my $def = $table->{$offset} or return;
 113         my ($len, $class, $name, $title) = @{$def};
 114
 115         my $attr = '';
 116         $len /= $nibsize;
 117         $name //= $len <= 2 ? 'res' : 'reserved';
 118
 119         if (my $part = $offset/$nibsize % @nibble) {
 120                 # continued row
 121                 my $cols = @nibble - $part;  # remaining
 122                 $cols = $len if $len < $cols; #TODO: optimise
 123                 if ($len -= $cols) {
 124                         # continued on new row
 125                         $table->{$offset + $nibsize*$cols} //= [$len*$nibsize, "$class joinu", $name, $title];
 126                         $name = '';
 127                         $class .= ' joind';
 128                 }
 129                 $len = $cols;
 130         }
 131         elsif (my $rows = int($len / @nibble)) {
 132                 # multiple full rows
 133                 if ($len -= $rows * @nibble) {
 134                         # partial row remains
 135                         $table->{$offset + $nibsize*$rows * @nibble} //= [$len*$nibsize, "$class joinu", '', $title];
 136                         $class .= ' joind';
 137                 }
 138                 $attr .= sprintf ' rowspan=%d', $rows;
 139                 $len = scalar @nibble;
 140         }
 141
 142         $attr .= sprintf ' colspan=%d', $len unless $len == 1;
 143         $attr .= $1 if $class and $class =~ s/( \w+="[^"]*")//;
 144         $attr .= sprintf ' class="%s"', $class if $class;
 145         $attr .= sprintf ' title="%s"', EscapeHTML($title) if $title;
 146         return "<td$attr>$name";
 147 }
 148
 149 for my $row (@request) {
 150         printf '<div class="section"><table class="glyphs%s">', !$row->{cell} && ' charmap';
 151         my $title = $row->{set};
 152         $title .= " <aside>($_)</aside>" for $row->{setnote} // ();
 153         printf '<caption>%s</caption>', $title;
 154         print '<col>' x (@nibble + 1);
 155         for my $section (qw{thead}) {
 156                 print "<$section><tr><th>↱";
 157                 print '<th>', $_ for @nibble;
 158                 print "\n";
 159         }
 160         print '<tbody>';
 161         for my $msb (0 .. ((length($row->{table}) || 256) - 1) / @nibble) {
 162                 printf '<tr><th>%X', ($msb + int($row->{offset} / @nibble)) * @nibble * $nibsize;
 163                 for my $lsb (0 .. $#nibble) {
 164                         my $val = ( ($msb * @nibble) + $lsb ) * $nibsize;
 165                         if ($row->{cell}) {
 166                                 if (ref $row->{cell} eq 'CODE') {
 167                                         print $row->{cell}->($val);
 168                                         next;
 169                                 }
 170                                 print range_cell($row->{cell}, $val);
 171                                 next;
 172                         }
 173
 174                         my $glyph = substr $row->{table}, $val, 1;
 175                         if ($glyph eq $NOCHAR) {
 176                                 print '<td>';
 177                                 next;
 178                         }
 179
 180                         print "\n".$glyphs->glyph_cell($glyph);
 181                 }
 182                 print "\n";
 183         }
 184         say '</table></div>';
 185 }
 186
 187 :>
 188 <hr>
 189
 190 <div class="legend">
 191         <table class="glyphs"><tr>
 192         <td class="X Cc">control
 193         <td class="X Zs"><span>whitespace</span>
 194         <td class="X Mn">diacritic<table class="glyphs"><tr>
 195                 <td class="X Sk">letter
 196                 </table>
 197         <td class="X Po">punctuation<table class="glyphs"><tr>
 198                 <td class="X Pf">quote
 199                 </table>
 200         <td class="X So">symbol<table class="glyphs"><tr>
 201                 <td class="X Sm">math
 202                 <td class="X Sc">currency
 203                 </table>
 204         <td class="X No">numeric
 205         <td class="X Greek">greek<table class="glyphs"><tr>
 206                 <td class="X Latin">latin
 207                 <td class="X Cyrillic">cyrillic
 208                 </table>
 209         <td class="X Aramaic">aramaic<table class="glyphs"><tr>
 210                 <td class="X Brahmic">brahmic
 211                 <td class="X Arabic">arabic
 212                 </table>
 213         <td class="X Syllabic">syllabic<table class="glyphs"><tr>
 214                 <td class="X African">african
 215                 <td class="X Hiragana">japanese
 216                 <td class="X Han">cjk
 217                 <td class="X Bopomofo">chinese
 218                 </table>
 219         <td class="X Alpha">alphabetic
 220         </table>
 221
 222         <table class="glyphs"><tr>
 223         <td class="X">unicode 7.0
 224         <td class="X Xr">proposed
 225         <td class="X Xd">deprecated
 226         <td class="">unassigned
 227         <td class="X Xi">invalid
 228         </table>
 229 </div>
 230