NAME

Lingua::Translit::Tables - provides transliteration tables

SYNOPSIS

  use Lingua::Translit::Tables qw/:checks/;

  my $truth;

  $truth = translit_supported("ISO 9");
  $truth = translit_reverse_supported("ISO 9");

  use Lingua::Translit::Tables qw/:list/;

  translit_list_supported();

DESCRIPTION

This module is primary used to provide transliteration tables for Lingua::Translit and therefore allows to separate data and algorithm.

Beyond that, it provides routines to check if a given transliteration is supported and allows to print a simple list of supported transliterations along with some meta information.

EXPORTS

No symbols are exported by default.

Use either the routine's name or one of the following tags to import symbols to your namespace.

all

Import all routines.

checks

Import all routines that allow to check if a given transliteration is supported: translit_supported() and translit_reverse_supported().

list

Import translit_list_supported(). (Convenience tag)

ROUTINES

translit_supported(translit_name)

Returns true (1), iff translit_name is supported. False (0) otherwise.

translit_reverse_supported(translit_name)

Returns true (1), iff translit_name is supported and allows reverse transliteration. False (0) otherwise.

translit_list_supported()

Prints a list of all supported transliterations to STDOUT, providing the following information:

  * Name
  * Reversibility
  * Description

The same information is provided in this document as well:

SUPPORTED TRANSLITERATIONS

ISO 843, not reversible, ISO 843:1997, Greek to Latin

ISO 9, reversible, ISO 9:1995, Cyrillic to Latin

Greeklish, not reversible, Greeklish (Phonetic), Greek to Latin

DIN 31634, not reversible, DIN 31634:1982, Greek to Latin

DIN 1460 BUL, reversible, DIN 1460:1982, Cyrillic to Latin, Bulgarian

Common RON, not reversible, Romanian without diacritics as commonly used

Common DEU, not reversible, German without umlauts

Common CES, not reversible, Czech without diacritics

Common POL, not reversible, Unaccented Polish

Common Classical MON, reversible, Classical Mongolian to Latin

Streamlined System BUL, not reversible, The Streamlined System: 2006, Cyrillic to Latin, Bulgarian

Common SLV, not reversible, Slovenian without diacritics

Common SLK, not reversible, Slovak without diacritics

EXTENDING

If you want to extend the list of supported transliterations, have a look at the xml/ directory within the distribution tarball. It contains XML definitions of transliteration tables and a template file template you may want to use and xml2dump, a tool to convert these into the proper format as used by Lingua::Translit::Tables.

Contact the authors at perl@lingua-systems.com if you feel the desire to contribute your table to the official distribution.

BUGS

None known.

Please report bugs to perl@lingua-systems.com.

SEE ALSO

Lingua::Translit

CREDITS

Thanks to Dr. Daniel Eiwen, Romanisches Seminar, Universitaet Koeln for his help on Romanian transliteration.

Thanks to Bayanzul Lodoysamba <baynaa@users.sourceforge.net> for contributing the "Common Classical Mongolian" transliteration table.

AUTHORS

Alex Linke <alinke@lingua-systems.com>

Rona Linke <rlinke@lingua-systems.com>

LICENSE AND COPYRIGHT

Copyright (c) 2008, Alex Linke and Rona Linke. All rights reserved.

This module is free software. It may be used, redistributed and/or modified under the terms of either the GPL v2 or the Artistic license.