/ 
WWW-Translate-interNOSTRUM-0.02
River stage zero No dependents
/ WWW::Translate::interNOSTRUM

NAME

WWW::Translate::interNOSTRUM - Catalan < > Spanish machine translation

VERSION

Version 0.02 November 7, 2006

SYNOPSIS

use WWW::Translate::interNOSTRUM; 
my $engine = WWW::Translate::interNOSTRUM->new();

my $translated_string = $engine->translate($string);

# default language pair is Catalan -> Spanish
# change to Spanish -> Catalan:
$engine->from_into('es-ca');

# check current language pair:
my $current_langpair = $engine->from_into();

# default output format is 'plain_text'
# change to 'marked_text':
$engine->output_format('marked_text');

# check current output format:
my $current_format = $engine->output_format();

DESCRIPTION

interNOSTRUM is a Catalan < > Spanish machine translation engine developed by the Department of Software and Computing Systems of the University of Alicante in Spain. This module provides an OO interface to the interNOSTRUM engine web server.

interNOSTRUM provides approximate translations of Catalan into Spanish and Spanish into Catalan. It generates both the central variant of Oriental Catalan (the standard variant used in Catalonia) and, optionally, Valencian forms, which follow the recommendations published in the guide http://www.ua.es/spv/assessorament/criteris.pdf. For more information on the Catalan variants, please see the References below.

CONSTRUCTOR

new()

Creates and returns a new WWW::Translate::interNOSTRUM object.

my $engine = WWW::Translate::interNOSTRUM->new();

WWW::Translate::interNOSTRUM recognizes the following parameters:

  • lang_pair

    The valid values of this parameter are:

    • es-ca

      Spanish into Standard Catalan

    • es-va

      Spanish into Valencian

    • ca-es

      Standard Catalan or Valencian into Spanish

    Default value: 'ca-es'.

  • output

    The valid values of this parameter are:

    • plain_text

      Returns the translation as plain text.

    • marked_text

      Returns the translation with the unknown words marked with an asterisk.

    Default value: 'plain_text'

The default parameter values can be overridden when creating a new interNOSTRUM engine object:

my %options = (
                lang_pair => 'es-ca',
                output => 'marked_text',
              );
my $engine = WWW::Translate::interNOSTRUM->new(%options);

METHODS

$engine->translate($string)

Returns the translation of $string generated by interNOSTRUM. $string must be a string of ANSI text, and can contain up to 16,384 characters. If the encoding of the source text isn't Latin-1, you must convert it to Latin-1 before sending it to the MT engine. You can use the Encode module for this task.

$engine->from_into($lang_pair)

Changes the engine language pair to $lang_pair. When called with no argument, it returns the value of the current engine language pair:

$current_langpair = $engine->from_into();

$engine->output_format($format)

Changes the engine output format to $format. When called with no argument, it returns the value of the current engine output format:

$current_format = $engine->output_format();

DEPENDENCIES

WWW::Mechanize 1.20 or higher.

REFERENCES

interNOSTRUM website:

http://www.internostrum.com/welcome.php

Department of Software and Computing Systems (University of Alicante):

http://www.dlsi.ua.es/index.cgi?id=eng

For more information on the variants of Catalan, see:

http://en.wikipedia.org/wiki/Catalan_language

ACKNOWLEDGEMENTS

Many thanks to Mikel Forcada Zubizarreta, coordinator of the interNOSTRUM project, who kindly answered my questions during the development of this module.

AUTHOR

Enrique Nell, <perl_nell@telefonica.net>

COPYRIGHT AND LICENSE

Copyright (C) 2006 by Enrique Nell.

This library is free software; you can redistribute it and/or modify it under the same terms as Perl itself.