(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 ; 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 ; 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 to find a CPAN site near you.