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