NAME
Template::Plugin::Translit::RU - Filter converting cyrillic text into transliterated one and back.
SYNOPSIS
Use as filters.
[% USE Translit::RU 'translit' 'detranslit' %]
[% FILTER translit( 'koi' ) %]
...
This text would stay unchanged because it is not cyrillic.
...
[% END %]Use as object. First argument - text for conversion. Second optional argument - charset ('koi' is default).
[% USE plTranslit = Translit::RU %]
[% plTranslit.translit( 'without cyrillic text is useless' ) %]
[% plTranslit.detranslit( 'kirilitca', 'win' ) %]DESCRIPTION
Template::Plugin::Translit::RU is Template Toolkit filter which allows to convert cyrillic text into transliterated latin text. Currently two most popular charsets are supported - koi8-r and windows-1251. Also back conversion supported.
SUPPORTED CHARSETS
Currently Template::Plugin::Translit::RU supports 2 main cyrillic charsets koi8-r and windows-1251.
Charset arguments could take such values:
'koi', 'koi8-r', 'koi8r', 'koi8' - for koi8-r charset.
'win', 'windows-1251', 'cp1251' - for windows-1251 charset.
KNOWN PROBLEMS
In some cases there is no exact correspondence between source cyrillic word and result of cyrillic->translit->cyrillic conversion (CTC-conversion). Although one of the aims of this module is to find such correspondence, this is difficult without making transliterated text bad understandable. Currently 1 main problem is known:
Case loss while conversion of hard and soft signs (UPPER source after CTC become lower). This could take place if you make CTC-conversion with UPPER case words. Fortunately there are no words which starts with signs.
SEE ALSO
AUTHOR
Igor Lobanov, <liol@cpan.org>
COPYRIGHT
Copyright (C) 2004 Igor Lobanov. All Rights Reserved.
This module is free software; you can redistribute it and/or modify it under the same terms as Perl itself.