index: bump version to 1.7
[sheet.git] / digraphs.plp
index 5192c250d9a2a9f0206f6ed74d59d7b87b121a91..4c45044c97f122ba8c0e3feeb3ba078c42aecb1a 100644 (file)
@@ -1,34 +1,42 @@
 <(common.inc.plp)><:
-       our $VERSION = 'v1.0';
+use 5.010;  # state
 
-:><!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN"
- "http://www.w3.org/TR/html4/loose.dtd">
-<html>
+Html({
+       title => 'digraph cheat sheet',
+       version => 'v1.1',
+       description => [
+               "Complete table of digraph characters from RFC-1345.",
+       ],
+       keywords => [qw'
+               digraph mnemonic compose composition pair
+               character char glyph table unicode vim
+       '],
+       stylesheet => [qw'light'],
+       data => [qw( digraphs.inc.pl )],
+});
 
-<head>
-<meta http-equiv="content-type" content="<:= $header{content_type} :>">
-<title>digraph cheat sheet</title>
-<:= stylesheet(qw'light') :>
-</head>
-
-<body id="digraphs">
+:>
 <h1>RFC-1345 Digraphs</h1>
 
-<p>i^k in <a href="/">Vim</a>.
-Also see <a href="/unicode">common digraphs</a>.</p>
+<p>Character mnemonics
+following composition key ⎄:
+i^k in <a href="/vi">Vim</a>,
+^u^\ in <a href="/readline">Emacs</a>,
+^a^v in <a href="/screen">Screen</a>.
+Also see <a href="/unicode">common Unicode</a>.</p>
 
-<p class="aside">Unofficial <span class="Xz">proposals</span>
+<p class="aside">Unofficial <span class="u-prop ex">proposals</span>
 are available as <a href="/digraphs.vim">ex commands</a>.</p>
 
 <:
-my $di = do 'digraphs.inc.pl';
-
-sub quote {
-       local $_ = shift;
-       s/"/&quot;/g;
-       s/</&lt;/g;
-       s/>/&gt;/g;
-       return $_;
+my $di = do 'digraphs.inc.pl'
+       or die "Error loading digraphs data: ", $@ // $!;
+
+if (exists $get{v}) {
+       # show characters for inverted mnemonics (vim alternatives)
+       $di->{ substr($_, 1, 1) . substr($_, 0, 1) } ||=
+               [ $di->{$_}->[0], '', 'l0 ex', '', $di->{$_}->[4] ]
+               for grep { ref $di->{$_} } keys %{$di};
 }
 
 my @chars = (
@@ -38,27 +46,62 @@ my @chars = (
        ['a'..'m'], ['n'..'z'],
 );
 my @chars2 = (['_'], @chars);  # trailing character (extended set)
+my @columns = !exists $get{split} ? \@chars2 :
+       ([@chars2[0, 1, 3, 4, 6]], [@chars2[2, 5, 7]]);
+
+if (exists $get{xorg}) {
+       my $xorg = do 'data/digraphs-xorg.inc.pl'
+               or die "Error loading Xorg data: ", $@ // $!;
+       $_ = [ord $_] for values %{$xorg};
+       $xorg->{$_}->[2] = # class = compatibility
+               $di->{$_} ? $di->{$_}->[0] != $xorg->{$_}->[0] ? 'l1' :  # conflict
+               $di->{$_}->[2] =~ /\bu-di\b/ ? 'l5' : 'l3' : 'l2'  # rfc|any|none
+               for keys %{$xorg};
+
+       for my $cp (map {$_->[0]} values %{$xorg}) {
+               next if (state $seen = {})->{$cp}++;  # List::MoreUtils::uniq
+
+               # find multiple equivalent mnemonics
+               my @equiv = grep {$cp eq $_->[0]}
+                       map {$xorg->{$_}} sort keys %{$xorg}; # values ordered by mnem.
+
+               # search for the most compatible match
+               my ($compat) = sort {
+                       $equiv[$b]->[2] cmp $equiv[$a]->[2]  # highest level
+                       || $b <=> $a  # fallback to last mnemonic
+               } 0 .. $#equiv;
+
+               # reclassify all but one as level 0 (omitted)
+               splice @equiv, $compat // -1, 1, ();
+               $_->[2] = 'l0 ex' for @equiv;
+       }
 
+       $chars2[0] = [qw( # ^ _ ` ~ )];
+       @chars = @chars2;
+       $di = $xorg;
+}
+
+for my $colchars (@columns) {
 print '<table class="glyphs dimap"><col>';
-print qq'<colgroup span="$_">' for map {scalar @$_} @chars2;
+print qq'<colgroup span="$_">' for map {scalar @$_} @{$colchars};
 print "</colgroup><col>\n";
 for my $section (qw{thead tfoot}) {
        print "<$section><tr><th>↳";
-       print '<th>', quote($_) for map {@$_} @chars2;
+       print '<th>', EscapeHTML($_) for map {@$_} @{$colchars};
        print "<th>&nbsp;\n";
 }
 for my $c1group (@chars) {
        print '<tbody>';
        for my $c1 (@$c1group) {
-               print '<tr><th>', quote($c1);
-               for my $c2 (map {@$_} @chars2) {
+               print '<tr><th>', EscapeHTML($c1);
+               for my $c2 (map {@$_} @$colchars) {
                        my $mnem = $c1 . $c2;
                        if (not defined $di->{$mnem}) {
                                print '<td>';
                                next;
                        }
                        if (ref $di->{$mnem} ne 'ARRAY') {
-                               printf '<td class="X Xr" title="%s">', quote($mnem);
+                               printf '<td class="X Xr" title="%s">', EscapeHTML($mnem);
                                next;
                        }
                        my ($codepoint, $name, $prop, $script, $string) = @{ $di->{$mnem} };
@@ -68,23 +111,37 @@ for my $c1group (@chars) {
                        my $desc = $mnem . ($name && " ($name)");
                        my @class = ('X', grep {$_} $prop, $script);
 
-                       $glyph = quote($glyph);
-                       $glyph = "<span>$glyph</span>" if $prop eq 'Zs';
+                       $glyph = EscapeHTML($glyph);
+                       $glyph = "<span>$glyph</span>" if $script =~ /\bZs\b/;
 
                        printf "\n".'<td class="%s" title="%s">%s',
-                               join(' ', @class), quote($desc), $glyph;
+                               join(' ', @class), EscapeHTML($desc), $glyph;
                }
-               print "\n<th>", quote($c1), "\n";
+               print "\n<th>", EscapeHTML($c1), "\n";
        }
 }
 print "</table>\n";
+print '<hr>' if exists $get{split};
+}
+
+if (exists $get{xorg}) {
 :>
+<div class="legend">
+       <table class="glyphs"><tr>
+       <td class="X l5">matching RFC-1345
+       <td class="X l3">matching proposal
+       <td class="X l2">unique to Xorg
+       <td class="X l1">conflict
+       <td class="X l0 ex">duplicate
+       </table>
+</div>
+<: } else { :>
 <div class="legend">
        <table class="glyphs"><tr>
        <td class="X Cc">control
-       <td class="X Zs"><span>spacing</span>
-       <td class="X Mn">modifier
-       <td class="X Sk">spacing modifier
+       <td class="X Zs"><span>space</span>
+       <td class="X Mn">combining
+       <td class="X Sk">spacing&nbsp;modifier
        <td class="X Pf">quote
        <td class="X Po">punctuation
        <td class="X So">symbol
@@ -105,18 +162,10 @@ print "</table>\n";
        <td class="X">unicode
        <td class="X Xl">latin1
        <td class="X Xa">ascii
-       <td class="X Xz">proposed
+       <td class="X u-prop">vim extension
+       <td class="X u-prop ex">proposal
+       <td class="X ex">not in vim
        </table>
 </div>
 
-<p class="footer">
-       <a href="/" rel="home">sheet.shiar.nl</a>/digraphs.<a href="/source/digraphs.plp"
-        rel="code" title="Written in Perl">plp</a>
-       <a href="http://git.shiar.nl/sheet.git/history/HEAD:/digraphs.plp"
-        rel="vcs-git" title="Git repository"><:= $VERSION :></a>
-       created by <a href="http://shiar.nl/" rel="author">Shiar</a> •
-       <a href="http://www.fsf.org/licensing/licenses/agpl-3.0.html" rel="copyright"
-        title="Licensed under the GNU Affero General Public License, version 3">AGPLv3</a>
-</p>
-
-</html>
+<: }