MAKE-LINGUA-IDENTIFY-LANGUAGE(1)

NAME
make-lingua-identify-language - creates language modules for Lingua::Identify

SYNOPSIS
  make-lingua-identify-language Language-Tag Language-Name file1 [file2 ...]

or

  make-lingua-identify-language -d TAG1-LANGUAGE1/ [TAG2-LANGUAGE2/ ...]

or

  make-lingua-identify

DESCRIPTION
Creates language modules to be used by Lingua::Identify.

After creating the modules, you still have to install them.

Please note that this script is still at an early stage. Please do not even look at the code...

Without parameters, make-lingua-identify-language assumes mode -d and goes through all the directories in the current one. This is useful to be used in a directory where you something like this:

  .
  |-- en-english
  |   `-- english.txt
  |-- fr-french
  |   `-- french1.txt
  |   `-- french2.txt
  `-- pt-portuguese
      `-- portuguese.txt

  OPTIONS

  -d
Directory mode. Each parameter passed should be a directory whose name must be of the form tag-name (e.g., en-english/ ). Each of the directories passed should contain text files that can be used to train Lingua::Identify.

  -D
Debug mode. Only for development.

  -h
Display help and exit.

  -v
Show version and exit.

  -verbose
Verbose mode.

  -locale="<locale>"
Set a specific locale. This way your text will be all lowercased before analysed.

META.yml
"META.yml" files are not parsed as other files, they are ignored.

In directory mode ("-d" switch), "META.yml" files are checked for info on languages codes and sets.

Here's a simple "META.yml" for you to put in your directories:

  two_letter_code:   pt
  three_letter_code: por
  sets:
    spoken_in_portugal

With that, the language will be identified with the two letter code "pt" or the three letter code "por"; it will also be in the set ":spoken_in_portugal".

CONTRIBUTING WITH NEW LANGUAGES
Please do not contribute with modules you made yourself. It's easier to contribute with unprocessed text, because that allows for new versions of Lingua::Identify not having to drop languages down in case I can't contact you by that time.

Use make-lingua-identify-language to create a new module for your own personal use, if you must, but try to contribute with unprocessed text rather than those modules.

SEE ALSO
Lingua::Identify(3), langident(1)

A linguist and/or a shrink.

The latest CVS version of "Lingua::Identify" (which includes make-lingua-identify) can be attained at http://natura.di.uminho.pt/natura/viewcvs.cgi/Lingua/Identify/

ISO 639 Language Codes, at http://www.w3.org/WAI/ER/IG/ert/iso639.htm

AUTHOR
Jose Alves de Castro, <cog@cpan.org>

COPYRIGHT AND LICENSE
Copyright 2004-2005 by Jose Alves de Castro

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