(Partly consisting of text excerpted from the Pod.)

NAME

PerlIO::via::Unidecode -- a perlio layer for Unidecode

SYNOPSIS

      % cat utf8translit
      #!/usr/bin/perl
      use strict;
      use PerlIO::via::Unidecode;
      foreach my $f (@ARGV) {
        open IN, '<:encoding(utf8):via(Unidecode)', $f or die "$f -> $!\n";
        print while <IN>;
        close(IN);
      }
      __END__

      % od -x home_city.txt
      000000:  E5 8C 97 E4 BA B0 0D 0A

(that's the the Chinese characters for Beijing, in UTF8)

      % utf8translit home_city.txt
      Bei Jing

DESCRIPTION

PerlIO::via::Unidecode implements a PerlIO::via layer that applies Unidecode (Text::Unidecode) to data passed through it.

You can use PerlIO::via::Unidecode on already-Unicode data, as in the example in the SYNOPSIS; or you can combine it with other layers, as in this little program that converts KOI8R text into Unicode and then feeds it to Unidecode, which then outputs an ASCII transliteration:

      % cat transkoi8r
      #!/usr/bin/perl
      use strict;
      use PerlIO::via::Unidecode;
      foreach my $f (@ARGV) {
        open IN, '<:encoding(koi8-r):via(Unidecode)', $f or die $!;
        print while <IN>;
        close(IN);
      }
      __END__

[...]

SEE ALSO

Text::Unidecode

PerlIO::via

Encode and Encode::Supported

PerlIO::via::PinyinConvert

NOTES

Thanks for Jarkko Hietaniemi for help with this module and many other things besides.

COPYRIGHT AND DISCLAIMER

Copyright 2003, Sean M. Burke sburke@cpan.org, all rights reserved. This program is free software; you can redistribute it and/or modify it under the same terms as Perl itself.

The programs and documentation in this dist are distributed in the hope that they will be useful, but without any warranty; without even the implied warranty of merchantability or fitness for a particular purpose.

AUTHOR

Sean M. Burke sburke@cpan.org

INSTALLATION

You install PerlIO::via::Unidecode, as you would install any perl module library, by running these commands:

perl Makefile.PL
make
make test
make install

If you want to install a private copy of PerlIO::via::Unidecode in your home directory, then you should try to produce the initial Makefile with something like this command:

perl Makefile.PL LIB=~/perl

See perldoc perlmodinstall for more information on installing modules.

DOCUMENTATION

POD-format documentation is included in Unidecode.pm. POD is readable with the 'perldoc' utility. See ChangeLog for recent changes.

SUPPORT

Questions, bug reports, useful code bits, and suggestions for PerlIO::via::Unidecode should just be sent to me at sburke@cpan.org

AVAILABILITY

The latest version of PerlIO::via::Unidecode is available from the Comprehensive Perl Archive Network (CPAN). Visit <http://www.perl.com/CPAN/> to find a CPAN site near you.