LANGIDENT(1)

NAME
langident - identifies the language files are written in

SYNOPSIS
  langident [OPTIONS] file1 [file2 ...]

DESCRIPTION
Identifies the language files are written in using Perl module Lingua::Identify.

  OPTIONS

  -a
Show all results (not just the most probable language).

  -c
Show confidence level for most probable language (it will be the first value right after the most probable language).

  -d
Debug (development only).

  -E ENCODING
Select an input encoding. Defaults to UTF-8.

  # use ISO-8859-1 (latin1)
  langident -E ISO-8859-1 file

  -e METHODS
Select the method(s) to use. There are three ways of doing this:

  # simply using a method
  langident -e ngrams3 file

  # using several methods (separate them with a comma)
  langident -e prefixes3,suffixes3

  # using several methods and assign different weights to each of them
  langident -e smallwords=2,prefixes=1,ngrams3=1.3

The available methods are the following: smallwords, prefixes1, prefixes2, prefixes3, prefixes4, suffixes1, suffixes2, suffixes3, suffixes4, ngrams1, ngrams2, ngrams3 and ngrams4.

  -h
Display help message and exit.

  -l
List all available languages and exit.

  -m NUMBER
Set maximum number of results (languages) to display (shows the N most probable languages, by descending order of probability).

Overrides the -a switch.

  -o LANGUAGES
Only work with specified languages.

  # identify between Portuguese and English only
  langident -o pt,en *

  -p
Also show percentages.

  -s SIZE
Maximum size to examine.

  -v
Show version and exit.

EXAMPLES
Use methods ngrams2 and ngrams1, assigning the double of importance to ngrams2 (-e switch); output will include the three most probable languages (-m switch) with its percentages (-p switch) and also the confidence level (-c switch) of the first result.

  $ langident -e ngrams2=2,ngrams1 -c -p -m 3 README
  README:en 65.7209505939491 7.8971987481393 ga 4.11905889385895 tr 4.08487011400505
  $

TO DO

•   Add a switch to ignore HTML tags (and maybe other formats too)

SEE ALSO
Lingua::Identify(3), Text::ExtractWords(3), Text::Ngram(3), Text::Affixes(3).

A linguist and/or a shrink.

The latest CVS version of "Lingua::Identify" (which includes langident) 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 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.