X-Git-Url: http://git.shiar.nl/sheet.git/blobdiff_plain/652fa60a059b983b901b344ea400230206bff8ff..bc57bd1b3634422a37757e5a2d37fdb9565622fb:/charset.plp diff --git a/charset.plp b/charset.plp index fd8d2ad..0dd1537 100644 --- a/charset.plp +++ b/charset.plp @@ -1,88 +1,400 @@ -<: -use utf8; -use strict; -use warnings; -use open IO => ':utf8'; +<(common.inc.plp)><: + +my $mode = exists $get{compare}; +my @tablist = split m{/+}, $Request || 'default'; -our $VERSION = '1.0'; +Html({ + title => 'charset cheat sheet', + version => '1.1', + 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-encoding.inc.pl + charset-unicode.inc.pl charset-ucplanes.inc.pl charset-utf8.inc.pl + )], +}); -$header{content_type} = 'text/html; charset=utf-8'; +use List::Util qw( first pairmap pairfirst pairs ); -:> - +:> +

Character encodings

- -charset cheat sheet - - - +

+<: +if ($tablist[0] eq 'default') { + say "Overview of Unicode allocation and common latin code pages."; + say "Compare alternate charsets:"; +} +else { + say "Charset comparison:"; +} - -

Character encoding

+print join " •\n", ( + map { + join " ·\n", pairmap { + showlink($b || ucfirst $a, '/charset'.($a && "/$a?compare"), $a eq $Request); + } @{$_} + } + [ + iso => 'ISO', + win => 'Windows', + dos => 'DOS', + mac => 'Apple', + ebcdic => 'EBCDIC', + $tablist[0] eq 'default' ? () : ('' => 'common'), + ], + [ + westeur => 'West', + centeur => 'Central', + norteur => 'North European', + turkish => 0, + greek => 0, + cyrillic => 0, + hebrew => 0, + ], +); +:>. +

<: -my $diinfo = do 'digraphs.inc.pl'; -my %di = map { $diinfo->{$_}->[0] => $_ } grep { ref $diinfo->{$_} } - keys %$diinfo; - -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 @tables = map { decode($_, pack 'C*', 0..255) } 'iso-8859-1', 'cp437'; -my $NOCHAR = chr 0xFFFD; +use POSIX qw( ceil ); +use Shiar_Sheet::FormatChar; +my $glyphs = Shiar_Sheet::FormatChar->new; +my @request; + +my $charsets = do 'charset-encoding.inc.pl' + or Alert('Encoding metadata could not be read', $@ || $!); + +sub tabinput { + # generate character table(s) + my $input = shift or return; + my $params = $input =~ s/[+](.*)\z// ? $1 : undef; + my $charset = $charsets->{lc $input} || {}; + + if (ref $charset ne 'HASH') { + $params and Alert("Parameters ignored for $input", + "Cannot apply $params to multiple charsets.", + ); + tabinput($_) for ref $charset ? @{$charset} : $charset; + return; + } + + state $visible = {'' => 1}; # all present tables + my %row = (offset => 0, cols => 16); + + if (not defined $params) { + my @parents = @{ $charset->{inherit} || [] }; + + if (my ($parent, $part) = pairfirst { defined $visible->{$a} } @parents) { + $row{parent} = $parent; + $params = $part; + $params = 80 unless $visible->{$parent} + or ($input eq 'MacCroatian' and defined $visible->{MacRomanian}); + } + elsif (defined $visible->{ascii}) { + $row{parent} = $parents[0]; + $params = $parents[1] // 80; + $params = 80 if hex $params >= 0x80; # ascii offset at most + } + elsif (@parents) { + $row{parent} = $parents[0]; + $params = $parents[1] if hex $parents[1] == 0; # apply ascii end + } + $visible->{$_} //= 0 for $row{parent} || (); + } + + for my $param (split /[+]+/, $params // '') { + if ($param eq 'realsize') { + $row{realsize}++; + } + elsif ($param =~ m{ \A cols = (\d+) \z }x) { + $row{cols} = $1; + } + elsif ($param =~ m{ \A (? \p{AHex}+) (?: [-] (? \p{AHex}+) )? \z }x) { + if (defined $row{endpoint}) { + # extend earlier range + my $skip = int(($row{endpoint} || $row{startpoint}) / $row{cols}); + for ($skip + 1 .. (hex($+{start}) / $row{cols}) - 1) { + $row{skip}->{ $_ * $row{cols} - $row{startpoint} }++; + } + } + else { + $row{startpoint} = hex $+{start}; + } + $row{endpoint} = hex($+{end} || 0); + } + else { + Alert("Unknown option $param for charset $input"); + } + } + + if ($charset->{setup}) { + eval { $charset->{setup}->(\%row) } + or Alert("Incomplete setup of $input", $@); + } + $row{endpoint} ||= 0xFF; + + if (defined $row{table} or defined $row{cell}) { + $row{set} //= $input; + } + elsif ($row{set} = Encode::resolve_alias($input)) { + $row{offset} = delete $row{startpoint}; + if ($charset->{varchar}) { + # array of possibly multiple characters per code point + $row{table} = [ + map { Encode::decode($row{set}, pack 'C*', $_) } $row{offset} .. $row{endpoint} + ]; + } + else { + # ~16x faster than decoding in loop; + # substr strings is twice as fast as splitting to an array + $row{table} = Encode::decode($row{set}, pack 'C*', $row{offset} .. $row{endpoint}); + } + + $row{endpoint} -= $row{offset}; + $visible->{ascii}++; # assume common base + } + else { + Alert("Encoding $input unknown"); + return; + } + + if (my $replace = $charset->{replace}) { + while (my ($offset, $sub) = each %{$replace}) { + $offset -= $row{offset}; + + if (ref $row{table} eq 'ARRAY') { + $row{table}->[$offset] = $sub + if $offset >= 0 and $offset <= $row{endpoint}; + next; + } -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( - 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 - ); + my $length = length $sub; + + if ($offset < 0) { + $offset > -$length or next; # at least one character after start + # trim leftmost part to start at offset + substr($sub, 0, -$offset) = ''; + $length += $offset; + $offset = 0; + } + + if ((my $excess = $row{endpoint} - $offset - $length + 1) < 0) { + $excess > -$length or next; + # trim rightmost part to prevent overflow + substr($sub, $excess) = ''; + $length += $excess; + } + + substr($row{table}, $offset, $length) = $sub; + } + } + + push @request, \%row; + $visible->{ $row{set} } = 1 if $row{table}; } +tabinput($_) for @tablist; + +my $NOCHAR = chr 0xFFFD; -sub quote { - local $_ = shift; - s/"/"/g; - s//>/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}; + + my $cols = $info->{cols}; + my $colsize = $table->{colsize} || 1; + my $attr = ''; + $len /= $colsize; + $name //= $len <= 2 ? 'res' : 'reserved'; + + if (my $part = ($offset/$colsize - $info->{startpoint}) % $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"); + my $separate = $cols - $len > $rest; # columns not on next row + if ($len > $rest) { + # minority remains + push @next, $name, $title; + $title ||= $name; + $name = $separate && '…'; + } + else { + # minority on next row + push @next, $separate && '"', $title || $name; + } + $table->{$offset + $colsize*$rest} //= \@next; + $class .= ' joind'; + } + $len = $rest; + } + elsif (my $rows = int($len / $cols)) { + # multiple full rows + my $rowsize = $colsize * $cols; + if ($len -= $rows * $cols) { + # partial row remains + $table->{$offset + $rowsize * $rows} //= [$len*$colsize, "$class joinu", '', $title]; + $class .= ' joind'; + } + + unless ($info->{realsize}) { + # coalesce multiple rows + while ($rows > 3) { + $info->{skip}->{$offset += $rowsize}++; + $rows--; + } + if ($rows > 2) { + $info->{skip}->{$offset += $rowsize} = 0; + } + } + + $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 "$name\n"; } -my @nibble = (0..9, 'A'..'F'); -for my $table (@tables) { - print ''; - for my $section (qw{thead tfoot}) { - print "<$section>
↳"; - print '', $_ for @nibble; - print " \n"; +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 = $row->{startpoint} * $colsize || 0; + + printf '
', !$row->{cell} && ' charmap'; + my $title = $row->{set}; + $title .= " " + for $row->{parent} || (); + printf '', $title; + print '' x ($cols + 1); + for my $section (qw{thead}) { + print "<$section>'; - for my $msb (0 .. $#nibble) { - print '
%s
", $rowdiv == 1 ? '+' : '↱'; + printf '%0*X', $coldigits, $_ * $colsize for 0 .. $cols - 1; + print "\n"; } + print '
', $nibble[$msb]; - for my $lsb (0 .. $#nibble) { - my $glyph = substr $table, ($msb<<4) + $lsb, 1; - if ($glyph eq $NOCHAR) { - print ''; - next; + while ($offset <= $row->{endpoint} * $colsize) { + if ($row->{skip}->{$offset}) { + $offset += $cols * $colsize; + next; + } + + print '
'; + if (defined $row->{skip}->{$offset}) { + print '⋮'; + } + else { + if (my $rowmod = $offset % $rowdiv) { + # offset in column units + printf '+%X', $rowmod; } - my $info = [ord $glyph]; - if (defined (my $mnem = $di{ord $glyph})) { - $info = $diinfo->{$mnem}; + else { + # divided row offset + printf '%X', ($offset + $row->{offset}) / $rowdiv; } - my ($codepoint, $name, $prop, $script, $string) = @$info; + } + say ''; - $glyph = quote($string || $glyph); - my $desc = sprintf 'U+%04X%s', $codepoint, $name && " ($name)"; - my @class = ('X', grep {$_} $prop, $script); + for (1 .. $cols) { + if ($row->{cell}) { + print range_cell($row, $offset); + next; + } - $glyph = "$glyph" if $prop eq 'Zs'; + my $cp = $offset + $row->{offset}; + my $glyph = ref $row->{table} eq 'ARRAY' ? $row->{table}->[$offset] : + substr $row->{table}, $offset, 1; + my ($cell, $name, $class) = !defined $glyph || $glyph eq $NOCHAR ? () : + $glyphs->glyph_html($glyph); + + if ($mode) { + state $visible = {}; + $class = ( + $cp == ord $glyph ? 'l4' : + $row->{parent} && $glyph eq + Encode::decode($row->{parent}, pack 'C', $cp) ? 'l3' : + !$class ? undef : + $visible->{$glyph} ? 'l2' : + 'l1' + ); + $visible->{$glyph}++; + } - printf "\n".'%s', - join(' ', @class), quote($desc), $glyph; + say sprintf $class ? '%s' : '', + $name, $class, $cell; + } + continue { + $offset += $colsize; } - print "\n", $nibble[$msb], "\n"; } - print "
\n"; + say '
'; } +:> +
+ +
+ <: if ($mode) { :> +
unicode + inherited + existing + original + unassigned +<: } else { :> + control + whitespace + diacritic +
letter +
+
punctuation +
quote +
+
symbol +
math + currency +
+
numeric + greek +
latin + cyrillic +
+
aramaic +
brahmic + arabic +
+
syllabic +
african + japanese + cjk + chinese +
+
alphabetic +
+ + +
unicode 7.0 + proposed + deprecated + unassigned + invalid +<: } :>
+
+