The London Perl and Raku Workshop takes place on 26th Oct 2024. If your company depends on Perl, please consider sponsoring and/or attending.

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
Common RON, not reversible, Romanian without diacritics as commonly used
Common DEU, not reversible, German umlauts

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

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.