NAME

MKDoc::Core::Language - Language class for the MKDoc::Core framework

SUMMARY

The list of languages supported by MKDoc::Core is defined in two config files.

These two config files are loaded from (by order of preference):

$ENV{SITE_DIR}/Language/
$ENV{MKDOC_DIR}/Language/
@INC/MKDoc/Core/Language/languages/

The two file are the following:

languages.conf - All the languages to support, including those from right to left
languages_rtl.conf - Just the languages which are written from right to left

Methods / API

$class->new ($iso_code);

Instantiates a new MKDoc::Core::Language object for $iso_code.

Returns undef if $iso_code is not defined in the languages.conf file.

$self->code();

Returns the iso code of a given language object, e.g:

my $lang = new MKDoc::Core::Language ('en');
print $lang->code(); # should print 'en'

$self->label();

Returns the label associated with a given language object, e.g:

my $lang = new MKDoc::Core::Language ('en');
print $lang->label(); # should print 'English'

$thing->code_list()

Returns a list of ISO codes of all languages, sorted by the Unicode value of their associated label.

$self->align();

In order to do proper multilingual HTML formatting, you need to have a sensible value for the XHTML align="left|right" attribute.

If the language is written left to right, this method returns 'left'.

If the language is written right to left, this method returns 'right'.

$self->align_opposite();

In order to do proper multilingual HTML formatting, you need to have a sensible value for the XHTML align="left|right" attribute.

This method does the exact opposite as $self->align(), i.e.

If the language is written left to right, this method returns 'right'.

If the language is written right to left, this method returns 'left'.

$self->dir()

In order to do proper multilingual HTML formatting, you need to have a sensible value for the XHTML dir="ltr|rtl" attribute.

If the language is written left to right, this method returns 'ltr'.

If the language is written right to left, this method returns 'rtl'.

AUTHOR

Copyright 2003 - MKDoc Holdings Ltd.

Author: Jean-Michel Hiver <jhiver@mkdoc.com>

This module is free software and is distributed under the same license as Perl itself. Use it at your own risk.

SEE ALSO

Petal: http://search.cpan.org/author/JHIVER/Petal/
MKDoc: http://www.mkdoc.com/

Help us open-source MKDoc. Join the mkdoc-modules mailing list:

mkdoc-modules@lists.webarch.co.uk