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 $cols = 16;  # columns
  25 my $colsize = 1;  # increment per column
  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                         $colsize = 8;
  71                 }
  72                 elsif ($row{set} = Encode::resolve_alias($input)) {
  73                         if ($row{set} eq 'Internal') {
  74                                 $row{table} = ' ' x ($endpoint < 255 ? 640 : 8192);
  75                                 $row{set} = 'Unicode BMP';
  76                                 $row{cell} = do 'charset-unicode.inc.pl'
  77                                         or Alert('Table data could not be read', $@ || $!);
  78                         }
  79                         elsif ($row{set} eq 'utf-8-strict') {
  80                                 $row{table} = undef;
  81                                 $row{set} = 'UTF-8';
  82                                 $row{cell} = do 'charset-utf8.inc.pl'
  83                                         or Alert('Table data could not be read', $@ || $!);
  84                         }
  85                         else {
  86                                 $row{table} = Encode::decode($row{set}, pack 'C*', $row{offset} .. $endpoint);
  87                         }
  88                 }
  89                 else {
  90                         Alert("Encoding <q>$input</q> unknown");
  91                 }
  92                 $row{set} ? \%row : ();
  93         }
  94         else {
  95                 ();
  96         }
  97 } map { defined $ALIAS{$_} ? @{ $ALIAS{$_} } : $_ }
  98         $Request =~ /\w/ ? split(m{[/+\s]}, $Request) : 'default';
  99 my $NOCHAR = chr 0xFFFD;
 100
 101 for my $cp437 (grep {$request[$_]->{set} eq 'cp437'} 0 .. $#request) {
 102         substr($request[$cp437]->{table}, 237, 1) = pack 'U*', 0x3D5; # phi sign
 103         substr($request[$cp437]->{table}, 0, 32) = pack 'U*', map {hex} qw(
 104                 2007 263A 263B 2665 2666 2663 2660 2022 25D8 25CB 25D9 2642 2640 266A 266B 263C
 105                 25BA 25C4 2195 203C 00B6 00A7 25AC 21A8 2191 2193 2192 2190 221F 2194 25B2 25BC
 106         );
 107 }
 108
 109 sub range_cell {
 110         my ($table, $offset) = @_;
 111         my $def = $table->{$offset} or return;
 112         my ($len, $class, $name, $title) = @{$def};
 113
 114         my $attr = '';
 115         $len /= $colsize;
 116         $name //= $len <= 2 ? 'res' : 'reserved';
 117
 118         if (my $part = $offset/$colsize % $cols) {
 119                 # continued row
 120                 my $rest = $cols - $part;  # remaining
 121                 $rest = $len if $len < $rest; #TODO: optimise
 122                 if ($len -= $rest) {
 123                         # continued on new row
 124                         my @next = ($len * $colsize, "$class joinu");
 125                         if ($len > $rest) {
 126                                 # minority remains
 127                                 push @next, $name, $title;
 128                                 $title ||= $name;
 129                                 $name = '';
 130                         }
 131                         else {
 132                                 # minority on next row
 133                                 push @next, '"', $title || $name;
 134                         }
 135                         $table->{$offset + $colsize*$rest} //= \@next;
 136                         $class .= ' joind';
 137                 }
 138                 $len = $rest;
 139         }
 140         elsif (my $rows = int($len / $cols)) {
 141                 # multiple full rows
 142                 if ($len -= $rows * $cols) {
 143                         # partial row remains
 144                         $table->{$offset + $colsize*$rows * $cols} //= [$len*$colsize, "$class joinu", '', $title];
 145                         $class .= ' joind';
 146                 }
 147                 $attr .= sprintf ' rowspan=%d', $rows;
 148                 $len = $cols;
 149         }
 150
 151         $attr .= sprintf ' colspan=%d', $len unless $len == 1;
 152         $attr .= $1 if $class and $class =~ s/( \w+="[^"]*")//;
 153         $attr .= sprintf ' class="%s"', $class if $class;
 154         $attr .= sprintf ' title="%s"', EscapeHTML($title) if $title;
 155         return "<td$attr>$name";
 156 }
 157
 158 for my $row (@request) {
 159         printf '<div class="section"><table class="glyphs%s">', !$row->{cell} && ' charmap';
 160         my $title = $row->{set};
 161         $title .= " <aside>($_)</aside>" for $row->{setnote} // ();
 162         printf '<caption>%s</caption>', $title;
 163         print '<col>' x ($cols + 1);
 164         my $coldigits = $colsize * $cols <= 16 ? 1 : 2;  # uniform length of hexadecimal header
 165         for my $section (qw{thead}) {
 166                 print "<$section><tr><th>↱";
 167                 printf '<th>%0*X', $coldigits, $_ * $colsize for 0 .. $cols - 1;
 168                 print "\n";
 169         }
 170         print '<tbody>';
 171         for my $msb (0 .. ((length($row->{table}) || 256) - 1) / $cols) {
 172                 printf '<tr><th>%X', ($msb + int($row->{offset} / $cols)) * $cols * $colsize;
 173                 for my $lsb (0 .. $cols - 1) {
 174                         my $val = ( ($msb * $cols) + $lsb ) * $colsize;
 175                         if ($row->{cell}) {
 176                                 if (ref $row->{cell} eq 'CODE') {
 177                                         print $row->{cell}->($val);
 178                                         next;
 179                                 }
 180                                 print range_cell($row->{cell}, $val);
 181                                 next;
 182                         }
 183
 184                         my $glyph = substr $row->{table}, $val, 1;
 185                         if ($glyph eq $NOCHAR) {
 186                                 print '<td>';
 187                                 next;
 188                         }
 189
 190                         print "\n".$glyphs->glyph_cell($glyph);
 191                 }
 192                 print "\n";
 193         }
 194         say '</table></div>';
 195 }
 196
 197 :>
 198 <hr>
 199
 200 <div class="legend">
 201         <table class="glyphs"><tr>
 202         <td class="X Cc">control
 203         <td class="X Zs"><span>whitespace</span>
 204         <td class="X Mn">diacritic<table class="glyphs"><tr>
 205                 <td class="X Sk">letter
 206                 </table>
 207         <td class="X Po">punctuation<table class="glyphs"><tr>
 208                 <td class="X Pf">quote
 209                 </table>
 210         <td class="X So">symbol<table class="glyphs"><tr>
 211                 <td class="X Sm">math
 212                 <td class="X Sc">currency
 213                 </table>
 214         <td class="X No">numeric
 215         <td class="X Greek">greek<table class="glyphs"><tr>
 216                 <td class="X Latin">latin
 217                 <td class="X Cyrillic">cyrillic
 218                 </table>
 219         <td class="X Aramaic">aramaic<table class="glyphs"><tr>
 220                 <td class="X Brahmic">brahmic
 221                 <td class="X Arabic">arabic
 222                 </table>
 223         <td class="X Syllabic">syllabic<table class="glyphs"><tr>
 224                 <td class="X African">african
 225                 <td class="X Hiragana">japanese
 226                 <td class="X Han">cjk
 227                 <td class="X Bopomofo">chinese
 228                 </table>
 229         <td class="X Alpha">alphabetic
 230         </table>
 231
 232         <table class="glyphs"><tr>
 233         <td class="X">unicode 7.0
 234         <td class="X Xr">proposed
 235         <td class="X Xd">deprecated
 236         <td class="">unassigned
 237         <td class="X Xi">invalid
 238         </table>
 239 </div>
 240