html-webhacc/WebHACC/Output.pm

package WebHACC::Output;
use strict;

require IO::Handle;
use Scalar::Util qw/refaddr/;

my $htescape = sub ($) {
  my $s = $_[0];
  $s =~ s/&/&amp;/g;
  $s =~ s/</&lt;/g;
  $s =~ s/>/&gt;/g;
  $s =~ s/"/&quot;/g;
  $s =~ s{([\x00-\x09\x0B-\x1F\x7F-\xA0\x{FEFF}\x{FFFC}-\x{FFFF}])}{
    sprintf '<var>U+%04X</var>', ord $1;
  }ge;
  return $s;
};

my $htescape_value = sub ($) {
  my $s = $_[0];
  $s =~ s/&/&amp;/g;
  $s =~ s/</&lt;/g;
  $s =~ s/>/&gt;/g;
  $s =~ s/"/&quot;/g;
  return $s;
};

sub new ($) {
  require WebHACC::Input;
  return bless {nav => [], section_rank => 1,
                input => WebHACC::Input->new}, shift;
} # new

sub input ($;$) {
  if (@_ > 1) {
    if (defined $_[1]) {
      $_[0]->{input} = $_[1];
    } else {
      $_[0]->{input} = WebHACC::Input->new;
    }
  }
  
  return $_[0]->{input};
} # input

sub handle ($;$) {
  if (@_ > 1) {
    if (defined $_[1]) {
      $_[0]->{handle} = $_[1];
    } else {
      delete $_[0]->{handle};
    }
  }
  
  return $_[0]->{handle};
} # handle

sub has_error ($;$) {
  if (@_ > 1) {
    if (defined $_[1]) {
      $_[0]->{has_error} = 1;
    } else {
      delete $_[0]->{has_error};
    }
  }
  
  return $_[0]->{has_error};
} # has_error

sub set_utf8 ($) {
  binmode shift->{handle}, ':utf8';
} # set_utf8

sub set_flush ($) {
  shift->{handle}->autoflush (1);
} # set_flush

sub unset_flush ($) {
  shift->{handle}->autoflush (0);
} # unset_flush

sub html ($$) {
  shift->{handle}->print (shift);
} # html

sub text ($$) {
  shift->html ($htescape->(shift));
} # text

sub url ($$%) {
  my ($self, $url, %opt) = @_;
  $self->html (q[<code class=uri>&lt;]);
  $self->link ($url, %opt, url => $url);
  $self->html (q[></code>]);
} # url

sub start_tag ($$%) {
  my ($self, $tag_name, %opt) = @_;
  $self->html ('<' . $htescape_value->($tag_name)); # escape for safety
  if (exists $opt{id}) {
    my $id = $self->input->id_prefix . $opt{id};
    $self->html (' id="' . $htescape_value->($id) . '"');
    delete $opt{id};
  }
  for (keys %opt) {    # for safety
    $self->html (' ' . $htescape_value->($_) . '="' .
                 $htescape_value->($opt{$_}) . '"');
  }
  $self->html ('>');
} # start_tag

sub end_tag ($$) {
  shift->html ('</' . $htescape_value->(shift) . '>');
} # end_tag

sub start_section ($%) {
  my ($self, %opt) = @_;

  my $class = 'section';
  if (defined $opt{role}) {
    if ($opt{role} eq 'parse-errors') {
      $opt{id} ||= 'parse-errors';
      $opt{title} ||= 'Parse Errors Section';
      $opt{short_title} ||= 'Parse Errors';
      $class .= ' errors';
      delete $opt{role};
    } elsif ($opt{role} eq 'structure-errors') {
      $opt{id} ||= 'document-errors';
      $opt{title} ||= 'Structural Errors';
      $opt{short_title} ||= 'Struct. Errors';
      $class .= ' errors';
      delete $opt{role};
    } elsif ($opt{role} eq 'transfer-errors') {
      $opt{id} ||= 'transfer-errors';
      $opt{title} ||= 'Transfer Errors';
      $opt{short_title} ||= 'Trans. Errors';
      $class .= ' errors';
      delete $opt{role};
    } elsif ($opt{role} eq 'reformatted') {
      $opt{id} ||= 'document-tree';
      $opt{title} ||= 'Reformatted Document Source';
      $opt{short_title} ||= 'Reformatted';
      $class .= ' dump';
      delete $opt{role}
    } elsif ($opt{role} eq 'tree') {
      $opt{id} ||= 'document-tree';
      $opt{title} ||= 'Document Tree';
      $opt{short_title} ||= 'Tree';
      $class .= ' dump';
      delete $opt{role};
    } elsif ($opt{role} eq 'structure') {
      $opt{id} ||= 'document-structure';
      $opt{title} ||= 'Document Structure';
      $opt{short_title} ||= 'Structure';
      $class .= ' dump';
      delete $opt{role};
    } elsif ($opt{role} eq 'subdoc') {
      $class .= ' subdoc';
      delete $opt{role};
    } elsif ($opt{role} eq 'source') {
      $opt{id} ||= 'source-string';
      $opt{title} ||= 'Document Source';
      $opt{short_title} ||= 'Source';
      $class .= ' source';
      delete $opt{role};
    } elsif ($opt{role} eq 'result') {
      $opt{id} ||= 'result-summary';
      $opt{title} ||= 'Result';
      $class .= ' result';
      delete $opt{role};
    }
  }

  $self->{section_rank}++;
  $self->html (qq[<div class="$class"]);
  if (defined $opt{id}) {
    my $prefix = $self->input->id_prefix;
    $opt{parent_id} ||= $prefix;
    my $id = $prefix . $opt{id};
    $self->html (' id="' . $htescape->($id) . '">');
    if ($self->{section_rank} == 2 or length $opt{parent_id}) {
      my $st = $opt{short_title} || $opt{title};
      push @{$self->{nav}},
          [$id => $st => $opt{text}] if $self->{section_rank} == 2;
      
      $self->start_tag ('script');
      $self->html (qq[ addSectionLink ('$id', ']);
      $self->nl_text ($st, text => $opt{text});
      if (defined $opt{parent_id}) {
        $self->html (q[', '] . $opt{parent_id});
      }
      $self->html (q[') ]);
      $self->end_tag ('script');
    }
  } else {
    $self->html ('>');
  }
  my $section_rank = $self->{section_rank};
  $section_rank = 6 if $section_rank > 6;
  $self->html ('<h' . $section_rank . '>');
  $self->nl_text ($opt{title}, text => $opt{text});
  $self->html ('</h' . $section_rank . '>');
} # start_section

sub end_section ($) {
  my $self = shift;
  $self->html ('</div>');
  $self->{handle}->flush;
  $self->{section_rank}--;
} # end_section

sub start_error_list ($%) {
  my ($self, %opt) = @_;

  if (defined $opt{role}) {
    if ($opt{role} eq 'parse-errors') {
      $opt{id} ||= 'parse-errors-list';
      delete $opt{role};
    } elsif ($opt{role} eq 'structure-errors') {
      $opt{id} ||= 'document-errors-list';
      delete $opt{role};
    } elsif ($opt{role} eq 'transfer-errors') {
      $opt{id} ||= 'transfer-errors-list';
      delete $opt{role};
    }
  }

  $self->start_tag ('dl', %opt);

  delete $self->{has_error}; # reset
} # start_error_list

sub end_error_list ($%) {
  my ($self, %opt) = @_;

  my $no_error_message = 'No error found.';

  if (defined $opt{role}) {
    if ($opt{role} eq 'parse-errors') {
      $self->end_tag ('dl');
      ## NOTE: For parse error list, the |add_source_to_parse_error_list|
      ## method is invoked at the end of |generate_source_string_section|,
      ## since that generation method is invoked after the error list
      ## is generated.
      $no_error_message = 'No parse error found.';
    } elsif ($opt{role} eq 'structure-errors') {
      $self->end_tag ('dl');
      $self->add_source_to_parse_error_list ('document-errors-list');
      $no_error_message = 'No structural error found.';
    } elsif ($opt{role} eq 'transfer-errors') {
      $self->end_tag ('dl');
      $no_error_message = 'No transfer error found.';
    } else {
      $self->end_tag ('dl');
    }
  } else {
    $self->end_tag ('dl');
  }

  unless ($self->{has_error}) {
    $self->start_tag ('p', class => 'no-errors');
    $self->nl_text ($no_error_message);
  }
} # end_error_list

sub add_source_to_parse_error_list ($$) {
  my $self = shift;

  $self->script (q[addSourceToParseErrorList ('] . $self->input->id_prefix .
                 q[', '] . shift () . q[')]);
} # add_source_to_parse_error_list

sub start_code_block ($) {
  shift->html ('<pre><code>');
} # start_code_block

sub end_code_block ($) {
  shift->html ('</code></pre>');
} # end_code_block

sub code ($$;%) {
  my ($self, $content, %opt) = @_;
  $self->start_tag ('code', %opt);
  $self->text ($content);
  $self->html ('</code>');
} # code

sub script ($$;%) {
  my ($self, $content, %opt) = @_;
  $self->start_tag ('script', %opt);
  $self->html ($content);
  $self->html ('</script>');
} # script

sub dt ($$;%) {
  my ($self, $content, %opt) = @_;
  $self->start_tag ('dt', %opt);
  $self->nl_text ($content, text => $opt{text});
} # dt

sub select ($$%) {
  my ($self, $options, %opt) = @_;

  my $selected = $opt{selected};
  delete $opt{selected};

  $self->start_tag ('select', %opt);
  
  my @options = @$options;
  while (@options) {
    my $opt = shift @options;
    if ($opt->{options}) {
      $self->html ('<optgroup label="');
      $self->nl_text ($opt->{label});
      $self->html ('">');
      unshift @options, @{$opt->{options}}, {end_options => 1};
    } elsif ($opt->{end_options}) {
      $self->end_tag ('optgroup');
    } else {
      $self->start_tag ('option', value => $opt->{value},
                        ((defined $selected and $opt->{value} eq $selected)
                             ? (selected => '') : ()));
      $self->nl_text (defined $opt->{label} ? $opt->{label} : $opt->{value});
    }
  }

  $self->end_tag ('select');
} # select

sub link ($$%) {
  my ($self, $content, %opt) = @_;
  $self->start_tag ('a', %opt, href => $opt{url});
  $self->text ($content);
  $self->html ('</a>');
} # link

sub xref ($$%) {
  my ($self, $content, %opt) = @_;
  $self->html ('<a href="#' . $htescape->($self->input->id_prefix . $opt{target}) . '">');
  $self->nl_text ($content, text => $opt{text});
  $self->html ('</a>');
} # xref

sub xref_text ($$%) {
  my ($self, $content, %opt) = @_;
  $self->html ('<a href="#' . $htescape->($self->input->id_prefix . $opt{target}) . '">');
  $self->text ($content);
  $self->html ('</a>');
} # xref

sub link_to_webhacc ($$%) {
  my ($self, $content, %opt) = @_;
  $opt{url} = './?uri=' . $self->encode_url_component ($opt{url});
  $self->link ($content, %opt);
} # link_to_webhacc

my $get_node_path = sub ($) {
  my $node = shift;
  my @r;
  while (defined $node) {
    my $rs;
    if ($node->node_type == 1) {
      $rs = $node->node_name;
      $node = $node->parent_node;
    } elsif ($node->node_type == 2) {
      $rs = '@' . $node->node_name;
      $node = $node->owner_element;
    } elsif ($node->node_type == 3) {
      $rs = '"' . $node->data . '"';
      $node = $node->parent_node;
    } elsif ($node->node_type == 9) {
      @r = ('') unless @r;
      $rs = '';
      $node = $node->parent_node;
    } else {
      $rs = '#' . $node->node_type;
      $node = $node->parent_node;
    }
    unshift @r, $rs;
  }
  return join '/', @r;
}; # $get_node_path

my $get_object_path = sub ($) {
  my $node = shift;
  my @r;
  while (defined $node) {
    my $ref = ref $node;
    $ref =~ /([^:]+)$/;
    my $rs = $1;
    my $node_name = $node->node_name;
    if (defined $node_name) {
      $rs .= ' <code>' . $htescape->($node_name) . '</code>';
    }
    $node = undef;
    unshift @r, $rs;
  }
  return join '/', @r;
}; # $get_object_path

sub node_link ($$) {
  my ($self, $node) = @_;
  if ($node->isa ('Message::IF::Node')) {
    $self->xref_text ($get_node_path->($node),
                      target => 'node-' . refaddr $node);
  } else {
    $self->html ($get_object_path->($node));
  }
} # node_link

{
  my $Msg = {};

sub load_text_catalog ($$) {
  my $self = shift;

  my $lang = shift; # MUST be a canonical lang name
  my $file_name = qq[cc-msg.$lang.txt];
  $lang = 'en' unless -f $file_name;
  $self->{primary_language} = $lang;
  
  open my $file, '<:utf8', $file_name or die "$0: $file_name: $!";
  while (<$file>) {
    if (s/^([^;]+);([^;]*);//) {
      my ($type, $cls, $msg) = ($1, $2, $_);
      $msg =~ tr/\x0D\x0A//d;
      $Msg->{$type} = [$cls, $msg];
    }
  }
} # load_text_catalog

sub nl_text ($$;%) {
  my ($self, $type, %opt) = @_;
  my $node = $opt{node};

  if (defined $Msg->{$type}) {
    my $msg = $Msg->{$type}->[1];
    if ($msg =~ /<var>/) {
      $msg =~ s{<var>{\@([A-Za-z0-9:_.-]+)}</var>}{
        UNIVERSAL::can ($node, 'get_attribute_ns')
            ? $htescape->($node->get_attribute_ns (undef, $1)) : ''
      }ge;
      $msg =~ s{<var>{\@}</var>}{
        UNIVERSAL::can ($node, 'value') ? $htescape->($node->value) : ''
      }ge;
      $msg =~ s{<var>{text}</var>}{
        defined $opt{text} ? $htescape->($opt{text}) : ''
      }ge;
      $msg =~ s{<var>{value}</var>}{
        defined $opt{value} ? $htescape->($opt{value}) : ''
      }ge;
      $msg =~ s{<var>{octets}</var>}{
        if (defined $opt{octets}) {
          join ', ', map {sprintf '0x%02X', ord $_} split //, ${$opt{octets}};
        } else {
          '';
        }
      }ge;
      $msg =~ s{<var>{char}</var>}{
        defined $opt{char} ? $htescape->(${$opt{char}}) : ''
      }ge;
      $msg =~ s{<var>{char:hexref}</var>}{
        if (defined $opt{char}) {
          join '', map {sprintf '&amp;#x%02X;', ord $_} split //, ${$opt{char}};
        } else {
          '';
        }
      }ge;
      $msg =~ s{<var>{local-name}</var>}{
        UNIVERSAL::can ($node, 'manakai_local_name')
            ? $htescape->($node->manakai_local_name) : ''
      }ge;
      $msg =~ s{<var>{element-local-name}</var>}{
        (UNIVERSAL::can ($node, 'owner_element') and $node->owner_element)
            ? $htescape->($node->owner_element->manakai_local_name) : ''
      }ge;
    }
    $self->html ($msg);
  } else {
    $self->text ($type);
  }
} # nl_text

}

sub nav_list ($) {
  my $self = shift;
  $self->html (q[<ul class="navigation" id="nav-items">]);
  for (@{$self->{nav}}) {
    $self->html (qq[<li><a href="#@{[$htescape->($_->[0])]}">]);
    $self->nl_text ($_->[1], text => $_->[2]);
    $self->html ('</a>');
  }
  $self->html ('</ul>');
} # nav_list

sub http_header ($) {
  shift->html (qq[Content-Type: text/html; charset=utf-8\n\n]);
} # http_header

sub http_error ($$) {
  my $self = shift;
  my $code = 0+shift;
  my $text = {
    404 => 'Not Found',
  }->{$code};
  $self->html (qq[Status: $code $text\nContent-Type: text/html ; charset=us-ascii\n\n$code $text]);
} # http_error

sub html_header ($) {
  my $self = shift;
  $self->html (q[<!DOCTYPE html>]);
  $self->start_tag ('html', lang => $self->{primary_language});
  $self->html (q[<head><title>]);
  $self->nl_text (q[WebHACC:Title]);
  $self->html (q[</title>
<link rel="stylesheet" href="../cc-style.css" type="text/css">
<script src="../cc-script.js"></script>
</head>
<body onclick=" return onbodyclick (event) " onload=" onbodyload () ">
<h1>]);
  $self->nl_text (q[WebHACC:Heading]);
  $self->html (q[</h1><script> insertNavSections () </script>]);
} # html_header

sub generate_input_section ($$) {
  my ($out, $cgi) = @_;

  require Encode;
  my $decode = sub ($) {
    if (defined $_[0]) {
      return Encode::decode ('utf-8', $_[0]);
    } else {
      return undef;
    }
  }; # $decode

  my $options = sub ($) {
    my $context = shift;

    $out->html (q[<div class="details default"><p class=legend onclick="nextSibling.style.display = nextSibling.style.display == 'block' ? 'none' : 'block'; parentNode.className = nextSibling.style.display == 'none' ? 'details' : 'details open'" tabindex=0>]);
    $out->nl_text (q[Options]);
    $out->start_tag ('div');

    if ($context eq 'url') {
      $out->start_tag ('p');
      $out->start_tag ('label');
      $out->start_tag ('input', type => 'checkbox', name => 'error-page',
                       value => 1,
                       ($cgi->get_parameter ('error-page')
                            ? (checked => '') : ()));
      $out->nl_text ('Check error page');
      $out->end_tag ('label');
    }
 
    $out->start_tag ('p');
    $out->start_tag ('label');
    $out->nl_text (q[Content type]);
    $out->text (': ');
    $out->select ([
      {value => '', label => 'As specified'},
      {value => 'application/atom+xml'},
      {value => 'text/cache-manifest'},
      {value => 'text/css'},
      {value => 'text/x-h2h'},
      {value => 'text/html'},
      {value => 'text/x-webidl'},
      {value => 'application/xhtml+xml'},
      {value => 'application/xml'},
      {value => 'text/xml'},
    ], name => 'i', selected => scalar $cgi->get_parameter ('i'));
    $out->end_tag ('label');

    if ($context ne 'text') {
      $out->start_tag ('p');
      $out->start_tag ('label');
      $out->nl_text (q[Charset]);
      $out->text (q[: ]);
      $out->select ([
        {value => '', label => 'As specified'},
        {label => 'Japanese charsets', options => [
          {value => 'Windows-31J'},
          {value => 'Shift_JIS'},
          {value => 'x-sjis'},
          {value => 'EUC-JP'},
          {value => 'x-euc-jp'},
          {value => 'ISO-2022-JP'},
          {value => 'ISO-2022-JP-1'},
          {value => 'ISO-2022-JP-2'},
        ]},
        {label => 'Latin charsets', options => [
          {value => 'Windows-1250'},
          {value => 'Windows-1252'},
          {value => 'Windows-1254'},
          {value => 'Windows-1257'},
          {value => 'Windows-1258'},
          {value => 'ISO-8859-1'},
          {value => 'ISO-8859-2'},
          {value => 'ISO-8859-3'},
          {value => 'ISO-8859-4'},
          {value => 'ISO-8859-9'},
          {value => 'ISO-8859-10'},
          {value => 'ISO-8859-13'},
          {value => 'ISO-8859-14'},
          {value => 'ISO-8859-15'},
          {value => 'ISO-8859-16'},
          {value => 'US-ASCII'},
        ]},
        {label => 'Greek charsets', options => [
          {value => 'Windows-1253'},
          {value => 'ISO-8859-7'},
        ]},
        {label => 'Cyrillic charsets', options => [
          {value => 'Windows-1251'},
          {value => 'ISO-8859-5'},
        ]},
        {label => 'Arabic charsets', options => [
          {value => 'Windows-1256'},
          {value => 'ISO-8859-6'},
        ]},
        {label => 'Hebrew charsets', options => [
          {value => 'Windows-1255'},
          {value => 'ISO-8859-8'},
        ]},
        {label => 'Thai charsets', options => [
          {value => 'Windows-874'},
          {value => 'ISO-8859-11'},
          {value => 'TIS-620'},
        ]},
        {label => 'Chinese charsets', options => [
          {value => 'Big5'},
          {value => 'x-x-big5'},
          {value => 'Big5-HKSCS'},
          {value => 'GBK'},
          {value => 'GB2312'},
          {value => 'GB_2312-80'},
          {value => 'ISO-2022-CN'},
          {value => 'ISO-2022-CN-EXT'},
        ]},
        {label => 'Korean charsets', options => [
          {value => 'Windows-949'},
          {value => 'EUC-KR'},
          {value => 'KS_C_5601-1987'},
          {value => 'ISO-2022-KR'},
        ]},
        {label => 'Unicode charsets', options => [
          {value => 'UTF-8'},
          {value => 'UTF-8n'},
          {value => 'UTF-16'}, 
          {value => 'UTF-16BE'},
          {value => 'UTF-16LE'},
       ]},
      ], name => 'charset',
      selected => scalar $cgi->get_parameter ('charset'));
      $out->end_tag ('label');
    }

    if ($context eq 'text') {
      $out->start_tag ('p');
      $out->start_tag ('label');
      $out->nl_text ('Setting innerHTML');
      $out->text (': ');
      $out->start_tag ('input', name => 'e',
                       value => $decode->(scalar $cgi->get_parameter ('e')));
      $out->end_tag ('label');
    }

    $out->html (q[</div></div>]);
  }; # $options

  $out->start_section (id => 'input', title => 'Input');
  $out->html (q[<script> insertNavSections ('input') </script>]);

  $out->start_section (id => 'input-url', title => 'By URL',
                       parent_id => 'input');
  $out->start_tag ('form', action => './#result-summary',
                   'accept-charset' => 'utf-8',
                   method => 'get');
  $out->start_tag ('input', type => 'hidden', name => '_charset_');

  $out->start_tag ('p');
  $out->start_tag ('label');
  $out->nl_text ('URL');
  $out->text (': ');
  $out->start_tag ('input',
                   name => 'uri',
                   type => 'url',
                   value => $decode->(scalar $cgi->get_parameter ('uri')));
  $out->end_tag ('label');

  $out->start_tag ('p');
  $out->start_tag ('button', type => 'submit');
  $out->nl_text ('Check');
  $out->end_tag ('button');

  $options->('url');

  $out->end_tag ('form');
  $out->end_section;

  ## TODO: File upload

  $out->start_section (id => 'input-text', title => 'By direct input',
                       parent_id => 'input');
  $out->start_tag ('form', action => './#result-summary',
                   'accept-charset' => 'utf-8',
                   method => 'post');
  $out->start_tag ('input', type => 'hidden', name => '_charset_');

  $out->start_tag ('p');
  $out->start_tag ('label');
  $out->nl_text ('Document source to check');
  $out->text (': ');
  $out->start_tag ('br');
  $out->start_tag ('textarea',
                   name => 's');
  my $s = $decode->($cgi->get_parameter ('s'));
  $out->html ($htescape_value->($s)) if defined $s;
  $out->end_tag ('textarea');
  $out->end_tag ('label');

  $out->start_tag ('p');
  $out->start_tag ('button', type => 'submit', 
                   onclick => 'form.method = form.s.value.length > 512 ? "post" : "get"');
  $out->nl_text ('Check');
  $out->end_tag ('button');

  $options->('text');

  $out->end_tag ('form');
  $out->end_section;

  $out->script (q[
    if (!document.webhaccNavigated &&
        document.getElementsByTagName ('textarea')[0].value.length > 0) {
      showTab ('input-text');
      document.webhaccNavigated = false;
    }
  ]);

  $out->end_section;
} # generate_input_section

sub encode_url_component ($$) {
  shift;
  require Encode;
  my $s = Encode::encode ('utf8', shift);
  $s =~ s/([^0-9A-Za-z_.~-])/sprintf '%%%02X', ord $1/ge;
  return $s;
} # encode_url_component

1;
1	package WebHACC::Output;
2	use strict;
3
4	require IO::Handle;
5	use Scalar::Util qw/refaddr/;
6
7	my $htescape = sub ($) {
8	my $s = $_[0];
9	$s =~ s/&/&/g;
10	$s =~ s/</</g;
11	$s =~ s/>/>/g;
12	$s =~ s/"/"/g;
13	$s =~ s{([\x00-\x09\x0B-\x1F\x7F-\xA0\x{FEFF}\x{FFFC}-\x{FFFF}])}{
14	sprintf '<var>U+%04X</var>', ord $1;
15	}ge;
16	return $s;
17	};
18
19	my $htescape_value = sub ($) {
20	my $s = $_[0];
21	$s =~ s/&/&/g;
22	$s =~ s/</</g;
23	$s =~ s/>/>/g;
24	$s =~ s/"/"/g;
25	return $s;
26	};
27
28	sub new ($) {
29	require WebHACC::Input;
30	return bless {nav => [], section_rank => 1,
31	input => WebHACC::Input->new}, shift;
32	} # new
33
34	sub input ($;$) {
35	if (@_ > 1) {
36	if (defined $_[1]) {
37	$_[0]->{input} = $_[1];
38	} else {
39	$_[0]->{input} = WebHACC::Input->new;
40	}
41	}
42
43	return $_[0]->{input};
44	} # input
45
46	sub handle ($;$) {
47	if (@_ > 1) {
48	if (defined $_[1]) {
49	$_[0]->{handle} = $_[1];
50	} else {
51	delete $_[0]->{handle};
52	}
53	}
54
55	return $_[0]->{handle};
56	} # handle
57
58	sub has_error ($;$) {
59	if (@_ > 1) {
60	if (defined $_[1]) {
61	$_[0]->{has_error} = 1;
62	} else {
63	delete $_[0]->{has_error};
64	}
65	}
66
67	return $_[0]->{has_error};
68	} # has_error
69
70	sub set_utf8 ($) {
71	binmode shift->{handle}, ':utf8';
72	} # set_utf8
73
74	sub set_flush ($) {
75	shift->{handle}->autoflush (1);
76	} # set_flush
77
78	sub unset_flush ($) {
79	shift->{handle}->autoflush (0);
80	} # unset_flush
81
82	sub html ($$) {
83	shift->{handle}->print (shift);
84	} # html
85
86	sub text ($$) {
87	shift->html ($htescape->(shift));
88	} # text
89
90	sub url ($$%) {
91	my ($self, $url, %opt) = @_;
92	$self->html (q[<code class=uri><]);
93	$self->link ($url, %opt, url => $url);
94	$self->html (q[></code>]);
95	} # url
96
97	sub start_tag ($$%) {
98	my ($self, $tag_name, %opt) = @_;
99	$self->html ('<' . $htescape_value->($tag_name)); # escape for safety
100	if (exists $opt{id}) {
101	my $id = $self->input->id_prefix . $opt{id};
102	$self->html (' id="' . $htescape_value->($id) . '"');
103	delete $opt{id};
104	}
105	for (keys %opt) { # for safety
106	$self->html (' ' . $htescape_value->($_) . '="' .
107	$htescape_value->($opt{$_}) . '"');
108	}
109	$self->html ('>');
110	} # start_tag
111
112	sub end_tag ($$) {
113	shift->html ('</' . $htescape_value->(shift) . '>');
114	} # end_tag
115
116	sub start_section ($%) {
117	my ($self, %opt) = @_;
118
119	my $class = 'section';
120	if (defined $opt{role}) {
121	if ($opt{role} eq 'parse-errors') {
122	$opt{id} \|\|= 'parse-errors';
123	$opt{title} \|\|= 'Parse Errors Section';
124	$opt{short_title} \|\|= 'Parse Errors';
125	$class .= ' errors';
126	delete $opt{role};
127	} elsif ($opt{role} eq 'structure-errors') {
128	$opt{id} \|\|= 'document-errors';
129	$opt{title} \|\|= 'Structural Errors';
130	$opt{short_title} \|\|= 'Struct. Errors';
131	$class .= ' errors';
132	delete $opt{role};
133	} elsif ($opt{role} eq 'transfer-errors') {
134	$opt{id} \|\|= 'transfer-errors';
135	$opt{title} \|\|= 'Transfer Errors';
136	$opt{short_title} \|\|= 'Trans. Errors';
137	$class .= ' errors';
138	delete $opt{role};
139	} elsif ($opt{role} eq 'reformatted') {
140	$opt{id} \|\|= 'document-tree';
141	$opt{title} \|\|= 'Reformatted Document Source';
142	$opt{short_title} \|\|= 'Reformatted';
143	$class .= ' dump';
144	delete $opt{role}
145	} elsif ($opt{role} eq 'tree') {
146	$opt{id} \|\|= 'document-tree';
147	$opt{title} \|\|= 'Document Tree';
148	$opt{short_title} \|\|= 'Tree';
149	$class .= ' dump';
150	delete $opt{role};
151	} elsif ($opt{role} eq 'structure') {
152	$opt{id} \|\|= 'document-structure';
153	$opt{title} \|\|= 'Document Structure';
154	$opt{short_title} \|\|= 'Structure';
155	$class .= ' dump';
156	delete $opt{role};
157	} elsif ($opt{role} eq 'subdoc') {
158	$class .= ' subdoc';
159	delete $opt{role};
160	} elsif ($opt{role} eq 'source') {
161	$opt{id} \|\|= 'source-string';
162	$opt{title} \|\|= 'Document Source';
163	$opt{short_title} \|\|= 'Source';
164	$class .= ' source';
165	delete $opt{role};
166	} elsif ($opt{role} eq 'result') {
167	$opt{id} \|\|= 'result-summary';
168	$opt{title} \|\|= 'Result';
169	$class .= ' result';
170	delete $opt{role};
171	}
172	}
173
174	$self->{section_rank}++;
175	$self->html (qq[<div class="$class"]);
176	if (defined $opt{id}) {
177	my $prefix = $self->input->id_prefix;
178	$opt{parent_id} \|\|= $prefix;
179	my $id = $prefix . $opt{id};
180	$self->html (' id="' . $htescape->($id) . '">');
181	if ($self->{section_rank} == 2 or length $opt{parent_id}) {
182	my $st = $opt{short_title} \|\| $opt{title};
183	push @{$self->{nav}},
184	[$id => $st => $opt{text}] if $self->{section_rank} == 2;
185
186	$self->start_tag ('script');
187	$self->html (qq[ addSectionLink ('$id', ']);
188	$self->nl_text ($st, text => $opt{text});
189	if (defined $opt{parent_id}) {
190	$self->html (q[', '] . $opt{parent_id});
191	}
192	$self->html (q[') ]);
193	$self->end_tag ('script');
194	}
195	} else {
196	$self->html ('>');
197	}
198	my $section_rank = $self->{section_rank};
199	$section_rank = 6 if $section_rank > 6;
200	$self->html ('<h' . $section_rank . '>');
201	$self->nl_text ($opt{title}, text => $opt{text});
202	$self->html ('</h' . $section_rank . '>');
203	} # start_section
204
205	sub end_section ($) {
206	my $self = shift;
207	$self->html ('</div>');
208	$self->{handle}->flush;
209	$self->{section_rank}--;
210	} # end_section
211
212	sub start_error_list ($%) {
213	my ($self, %opt) = @_;
214
215	if (defined $opt{role}) {
216	if ($opt{role} eq 'parse-errors') {
217	$opt{id} \|\|= 'parse-errors-list';
218	delete $opt{role};
219	} elsif ($opt{role} eq 'structure-errors') {
220	$opt{id} \|\|= 'document-errors-list';
221	delete $opt{role};
222	} elsif ($opt{role} eq 'transfer-errors') {
223	$opt{id} \|\|= 'transfer-errors-list';
224	delete $opt{role};
225	}
226	}
227
228	$self->start_tag ('dl', %opt);
229
230	delete $self->{has_error}; # reset
231	} # start_error_list
232
233	sub end_error_list ($%) {
234	my ($self, %opt) = @_;
235
236	my $no_error_message = 'No error found.';
237
238	if (defined $opt{role}) {
239	if ($opt{role} eq 'parse-errors') {
240	$self->end_tag ('dl');
241	## NOTE: For parse error list, the \|add_source_to_parse_error_list\|
242	## method is invoked at the end of \|generate_source_string_section\|,
243	## since that generation method is invoked after the error list
244	## is generated.
245	$no_error_message = 'No parse error found.';
246	} elsif ($opt{role} eq 'structure-errors') {
247	$self->end_tag ('dl');
248	$self->add_source_to_parse_error_list ('document-errors-list');
249	$no_error_message = 'No structural error found.';
250	} elsif ($opt{role} eq 'transfer-errors') {
251	$self->end_tag ('dl');
252	$no_error_message = 'No transfer error found.';
253	} else {
254	$self->end_tag ('dl');
255	}
256	} else {
257	$self->end_tag ('dl');
258	}
259
260	unless ($self->{has_error}) {
261	$self->start_tag ('p', class => 'no-errors');
262	$self->nl_text ($no_error_message);
263	}
264	} # end_error_list
265
266	sub add_source_to_parse_error_list ($$) {
267	my $self = shift;
268
269	$self->script (q[addSourceToParseErrorList ('] . $self->input->id_prefix .
270	q[', '] . shift () . q[')]);
271	} # add_source_to_parse_error_list
272
273	sub start_code_block ($) {
274	shift->html ('<pre><code>');
275	} # start_code_block
276
277	sub end_code_block ($) {
278	shift->html ('</code></pre>');
279	} # end_code_block
280
281	sub code ($$;%) {
282	my ($self, $content, %opt) = @_;
283	$self->start_tag ('code', %opt);
284	$self->text ($content);
285	$self->html ('</code>');
286	} # code
287
288	sub script ($$;%) {
289	my ($self, $content, %opt) = @_;
290	$self->start_tag ('script', %opt);
291	$self->html ($content);
292	$self->html ('</script>');
293	} # script
294
295	sub dt ($$;%) {
296	my ($self, $content, %opt) = @_;
297	$self->start_tag ('dt', %opt);
298	$self->nl_text ($content, text => $opt{text});
299	} # dt
300
301	sub select ($$%) {
302	my ($self, $options, %opt) = @_;
303
304	my $selected = $opt{selected};
305	delete $opt{selected};
306
307	$self->start_tag ('select', %opt);
308
309	my @options = @$options;
310	while (@options) {
311	my $opt = shift @options;
312	if ($opt->{options}) {
313	$self->html ('<optgroup label="');
314	$self->nl_text ($opt->{label});
315	$self->html ('">');
316	unshift @options, @{$opt->{options}}, {end_options => 1};
317	} elsif ($opt->{end_options}) {
318	$self->end_tag ('optgroup');
319	} else {
320	$self->start_tag ('option', value => $opt->{value},
321	((defined $selected and $opt->{value} eq $selected)
322	? (selected => '') : ()));
323	$self->nl_text (defined $opt->{label} ? $opt->{label} : $opt->{value});
324	}
325	}
326
327	$self->end_tag ('select');
328	} # select
329
330	sub link ($$%) {
331	my ($self, $content, %opt) = @_;
332	$self->start_tag ('a', %opt, href => $opt{url});
333	$self->text ($content);
334	$self->html ('</a>');
335	} # link
336
337	sub xref ($$%) {
338	my ($self, $content, %opt) = @_;
339	$self->html ('<a href="#' . $htescape->($self->input->id_prefix . $opt{target}) . '">');
340	$self->nl_text ($content, text => $opt{text});
341	$self->html ('</a>');
342	} # xref
343
344	sub xref_text ($$%) {
345	my ($self, $content, %opt) = @_;
346	$self->html ('<a href="#' . $htescape->($self->input->id_prefix . $opt{target}) . '">');
347	$self->text ($content);
348	$self->html ('</a>');
349	} # xref
350
351	sub link_to_webhacc ($$%) {
352	my ($self, $content, %opt) = @_;
353	$opt{url} = './?uri=' . $self->encode_url_component ($opt{url});
354	$self->link ($content, %opt);
355	} # link_to_webhacc
356
357	my $get_node_path = sub ($) {
358	my $node = shift;
359	my @r;
360	while (defined $node) {
361	my $rs;
362	if ($node->node_type == 1) {
363	$rs = $node->node_name;
364	$node = $node->parent_node;
365	} elsif ($node->node_type == 2) {
366	$rs = '@' . $node->node_name;
367	$node = $node->owner_element;
368	} elsif ($node->node_type == 3) {
369	$rs = '"' . $node->data . '"';
370	$node = $node->parent_node;
371	} elsif ($node->node_type == 9) {
372	@r = ('') unless @r;
373	$rs = '';
374	$node = $node->parent_node;
375	} else {
376	$rs = '#' . $node->node_type;
377	$node = $node->parent_node;
378	}
379	unshift @r, $rs;
380	}
381	return join '/', @r;
382	}; # $get_node_path
383
384	my $get_object_path = sub ($) {
385	my $node = shift;
386	my @r;
387	while (defined $node) {
388	my $ref = ref $node;
389	$ref =~ /([^:]+)$/;
390	my $rs = $1;
391	my $node_name = $node->node_name;
392	if (defined $node_name) {
393	$rs .= ' <code>' . $htescape->($node_name) . '</code>';
394	}
395	$node = undef;
396	unshift @r, $rs;
397	}
398	return join '/', @r;
399	}; # $get_object_path
400
401	sub node_link ($$) {
402	my ($self, $node) = @_;
403	if ($node->isa ('Message::IF::Node')) {
404	$self->xref_text ($get_node_path->($node),
405	target => 'node-' . refaddr $node);
406	} else {
407	$self->html ($get_object_path->($node));
408	}
409	} # node_link
410
411	{
412	my $Msg = {};
413
414	sub load_text_catalog ($$) {
415	my $self = shift;
416
417	my $lang = shift; # MUST be a canonical lang name
418	my $file_name = qq[cc-msg.$lang.txt];
419	$lang = 'en' unless -f $file_name;
420	$self->{primary_language} = $lang;
421
422	open my $file, '<:utf8', $file_name or die "$0: $file_name: $!";
423	while (<$file>) {
424	if (s/^([^;]+);([^;]*);//) {
425	my ($type, $cls, $msg) = ($1, $2, $_);
426	$msg =~ tr/\x0D\x0A//d;
427	$Msg->{$type} = [$cls, $msg];
428	}
429	}
430	} # load_text_catalog
431
432	sub nl_text ($$;%) {
433	my ($self, $type, %opt) = @_;
434	my $node = $opt{node};
435
436	if (defined $Msg->{$type}) {
437	my $msg = $Msg->{$type}->[1];
438	if ($msg =~ /<var>/) {
439	$msg =~ s{<var>{\@([A-Za-z0-9:_.-]+)}</var>}{
440	UNIVERSAL::can ($node, 'get_attribute_ns')
441	? $htescape->($node->get_attribute_ns (undef, $1)) : ''
442	}ge;
443	$msg =~ s{<var>{\@}</var>}{
444	UNIVERSAL::can ($node, 'value') ? $htescape->($node->value) : ''
445	}ge;
446	$msg =~ s{<var>{text}</var>}{
447	defined $opt{text} ? $htescape->($opt{text}) : ''
448	}ge;
449	$msg =~ s{<var>{value}</var>}{
450	defined $opt{value} ? $htescape->($opt{value}) : ''
451	}ge;
452	$msg =~ s{<var>{octets}</var>}{
453	if (defined $opt{octets}) {
454	join ', ', map {sprintf '0x%02X', ord $_} split //, ${$opt{octets}};
455	} else {
456	'';
457	}
458	}ge;
459	$msg =~ s{<var>{char}</var>}{
460	defined $opt{char} ? $htescape->(${$opt{char}}) : ''
461	}ge;
462	$msg =~ s{<var>{char:hexref}</var>}{
463	if (defined $opt{char}) {
464	join '', map {sprintf '&#x%02X;', ord $_} split //, ${$opt{char}};
465	} else {
466	'';
467	}
468	}ge;
469	$msg =~ s{<var>{local-name}</var>}{
470	UNIVERSAL::can ($node, 'manakai_local_name')
471	? $htescape->($node->manakai_local_name) : ''
472	}ge;
473	$msg =~ s{<var>{element-local-name}</var>}{
474	(UNIVERSAL::can ($node, 'owner_element') and $node->owner_element)
475	? $htescape->($node->owner_element->manakai_local_name) : ''
476	}ge;
477	}
478	$self->html ($msg);
479	} else {
480	$self->text ($type);
481	}
482	} # nl_text
483
484	}
485
486	sub nav_list ($) {
487	my $self = shift;
488	$self->html (q[<ul class="navigation" id="nav-items">]);
489	for (@{$self->{nav}}) {
490	$self->html (qq[<li><a href="#@{[$htescape->($_->[0])]}">]);
491	$self->nl_text ($_->[1], text => $_->[2]);
492	$self->html ('</a>');
493	}
494	$self->html ('</ul>');
495	} # nav_list
496
497	sub http_header ($) {
498	shift->html (qq[Content-Type: text/html; charset=utf-8\n\n]);
499	} # http_header
500
501	sub http_error ($$) {
502	my $self = shift;
503	my $code = 0+shift;
504	my $text = {
505	404 => 'Not Found',
506	}->{$code};
507	$self->html (qq[Status: $code $text\nContent-Type: text/html ; charset=us-ascii\n\n$code $text]);
508	} # http_error
509
510	sub html_header ($) {
511	my $self = shift;
512	$self->html (q[<!DOCTYPE html>]);
513	$self->start_tag ('html', lang => $self->{primary_language});
514	$self->html (q[<head><title>]);
515	$self->nl_text (q[WebHACC:Title]);
516	$self->html (q[</title>
517	<link rel="stylesheet" href="../cc-style.css" type="text/css">
518	<script src="../cc-script.js"></script>
519	</head>
520	<body onclick=" return onbodyclick (event) " onload=" onbodyload () ">
521	<h1>]);
522	$self->nl_text (q[WebHACC:Heading]);
523	$self->html (q[</h1><script> insertNavSections () </script>]);
524	} # html_header
525
526	sub generate_input_section ($$) {
527	my ($out, $cgi) = @_;
528
529	require Encode;
530	my $decode = sub ($) {
531	if (defined $_[0]) {
532	return Encode::decode ('utf-8', $_[0]);
533	} else {
534	return undef;
535	}
536	}; # $decode
537
538	my $options = sub ($) {
539	my $context = shift;
540
541	$out->html (q[<div class="details default"><p class=legend onclick="nextSibling.style.display = nextSibling.style.display == 'block' ? 'none' : 'block'; parentNode.className = nextSibling.style.display == 'none' ? 'details' : 'details open'" tabindex=0>]);
542	$out->nl_text (q[Options]);
543	$out->start_tag ('div');
544
545	if ($context eq 'url') {
546	$out->start_tag ('p');
547	$out->start_tag ('label');
548	$out->start_tag ('input', type => 'checkbox', name => 'error-page',
549	value => 1,
550	($cgi->get_parameter ('error-page')
551	? (checked => '') : ()));
552	$out->nl_text ('Check error page');
553	$out->end_tag ('label');
554	}
555
556	$out->start_tag ('p');
557	$out->start_tag ('label');
558	$out->nl_text (q[Content type]);
559	$out->text (': ');
560	$out->select ([
561	{value => '', label => 'As specified'},
562	{value => 'application/atom+xml'},
563	{value => 'text/cache-manifest'},
564	{value => 'text/css'},
565	{value => 'text/x-h2h'},
566	{value => 'text/html'},
567	{value => 'text/x-webidl'},
568	{value => 'application/xhtml+xml'},
569	{value => 'application/xml'},
570	{value => 'text/xml'},
571	], name => 'i', selected => scalar $cgi->get_parameter ('i'));
572	$out->end_tag ('label');
573
574	if ($context ne 'text') {
575	$out->start_tag ('p');
576	$out->start_tag ('label');
577	$out->nl_text (q[Charset]);
578	$out->text (q[: ]);
579	$out->select ([
580	{value => '', label => 'As specified'},
581	{label => 'Japanese charsets', options => [
582	{value => 'Windows-31J'},
583	{value => 'Shift_JIS'},
584	{value => 'x-sjis'},
585	{value => 'EUC-JP'},
586	{value => 'x-euc-jp'},
587	{value => 'ISO-2022-JP'},
588	{value => 'ISO-2022-JP-1'},
589	{value => 'ISO-2022-JP-2'},
590	]},
591	{label => 'Latin charsets', options => [
592	{value => 'Windows-1250'},
593	{value => 'Windows-1252'},
594	{value => 'Windows-1254'},
595	{value => 'Windows-1257'},
596	{value => 'Windows-1258'},
597	{value => 'ISO-8859-1'},
598	{value => 'ISO-8859-2'},
599	{value => 'ISO-8859-3'},
600	{value => 'ISO-8859-4'},
601	{value => 'ISO-8859-9'},
602	{value => 'ISO-8859-10'},
603	{value => 'ISO-8859-13'},
604	{value => 'ISO-8859-14'},
605	{value => 'ISO-8859-15'},
606	{value => 'ISO-8859-16'},
607	{value => 'US-ASCII'},
608	]},
609	{label => 'Greek charsets', options => [
610	{value => 'Windows-1253'},
611	{value => 'ISO-8859-7'},
612	]},
613	{label => 'Cyrillic charsets', options => [
614	{value => 'Windows-1251'},
615	{value => 'ISO-8859-5'},
616	]},
617	{label => 'Arabic charsets', options => [
618	{value => 'Windows-1256'},
619	{value => 'ISO-8859-6'},
620	]},
621	{label => 'Hebrew charsets', options => [
622	{value => 'Windows-1255'},
623	{value => 'ISO-8859-8'},
624	]},
625	{label => 'Thai charsets', options => [
626	{value => 'Windows-874'},
627	{value => 'ISO-8859-11'},
628	{value => 'TIS-620'},
629	]},
630	{label => 'Chinese charsets', options => [
631	{value => 'Big5'},
632	{value => 'x-x-big5'},
633	{value => 'Big5-HKSCS'},
634	{value => 'GBK'},
635	{value => 'GB2312'},
636	{value => 'GB_2312-80'},
637	{value => 'ISO-2022-CN'},
638	{value => 'ISO-2022-CN-EXT'},
639	]},
640	{label => 'Korean charsets', options => [
641	{value => 'Windows-949'},
642	{value => 'EUC-KR'},
643	{value => 'KS_C_5601-1987'},
644	{value => 'ISO-2022-KR'},
645	]},
646	{label => 'Unicode charsets', options => [
647	{value => 'UTF-8'},
648	{value => 'UTF-8n'},
649	{value => 'UTF-16'},
650	{value => 'UTF-16BE'},
651	{value => 'UTF-16LE'},
652	]},
653	], name => 'charset',
654	selected => scalar $cgi->get_parameter ('charset'));
655	$out->end_tag ('label');
656	}
657
658	if ($context eq 'text') {
659	$out->start_tag ('p');
660	$out->start_tag ('label');
661	$out->nl_text ('Setting innerHTML');
662	$out->text (': ');
663	$out->start_tag ('input', name => 'e',
664	value => $decode->(scalar $cgi->get_parameter ('e')));
665	$out->end_tag ('label');
666	}
667
668	$out->html (q[</div></div>]);
669	}; # $options
670
671	$out->start_section (id => 'input', title => 'Input');
672	$out->html (q[<script> insertNavSections ('input') </script>]);
673
674	$out->start_section (id => 'input-url', title => 'By URL',
675	parent_id => 'input');
676	$out->start_tag ('form', action => './#result-summary',
677	'accept-charset' => 'utf-8',
678	method => 'get');
679	$out->start_tag ('input', type => 'hidden', name => '_charset_');
680
681	$out->start_tag ('p');
682	$out->start_tag ('label');
683	$out->nl_text ('URL');
684	$out->text (': ');
685	$out->start_tag ('input',
686	name => 'uri',
687	type => 'url',
688	value => $decode->(scalar $cgi->get_parameter ('uri')));
689	$out->end_tag ('label');
690
691	$out->start_tag ('p');
692	$out->start_tag ('button', type => 'submit');
693	$out->nl_text ('Check');
694	$out->end_tag ('button');
695
696	$options->('url');
697
698	$out->end_tag ('form');
699	$out->end_section;
700
701	## TODO: File upload
702
703	$out->start_section (id => 'input-text', title => 'By direct input',
704	parent_id => 'input');
705	$out->start_tag ('form', action => './#result-summary',
706	'accept-charset' => 'utf-8',
707	method => 'post');
708	$out->start_tag ('input', type => 'hidden', name => '_charset_');
709
710	$out->start_tag ('p');
711	$out->start_tag ('label');
712	$out->nl_text ('Document source to check');
713	$out->text (': ');
714	$out->start_tag ('br');
715	$out->start_tag ('textarea',
716	name => 's');
717	my $s = $decode->($cgi->get_parameter ('s'));
718	$out->html ($htescape_value->($s)) if defined $s;
719	$out->end_tag ('textarea');
720	$out->end_tag ('label');
721
722	$out->start_tag ('p');
723	$out->start_tag ('button', type => 'submit',
724	onclick => 'form.method = form.s.value.length > 512 ? "post" : "get"');
725	$out->nl_text ('Check');
726	$out->end_tag ('button');
727
728	$options->('text');
729
730	$out->end_tag ('form');
731	$out->end_section;
732
733	$out->script (q[
734	if (!document.webhaccNavigated &&
735	document.getElementsByTagName ('textarea')[0].value.length > 0) {
736	showTab ('input-text');
737	document.webhaccNavigated = false;
738	}
739	]);
740
741	$out->end_section;
742	} # generate_input_section
743
744	sub encode_url_component ($$) {
745	shift;
746	require Encode;
747	my $s = Encode::encode ('utf8', shift);
748	$s =~ s/([^0-9A-Za-z_.~-])/sprintf '%%%02X', ord $1/ge;
749	return $s;
750	} # encode_url_component
751
752	1;