locale(1)
=========

Name
----

locale - Create, edit and delete translation files for images,
documents and automation scripts.

Synopsis
--------

*centos-art.sh locale --help*::
    Print module's documentation.

*centos-art.sh locale --version*::
    Print module's version.

*centos-art.sh locale DIRECTORY [--update|--edit|--delete|--filter="REGEX"]*::
    Perform directory localization.

*centos-art.sh locale FILE [--update|--edit|--delete]*::
    Perform file localization.

Description
-----------

The *locale* produces translations files for images, documents and
automation scripts based on the LANG environment variable. In order to
produce locale-specific translation files, the current language
information set by the LANG environment variable must be different to
English (`en'). If the current language is English, the *locale*
module ends its execution with an error message. When the current
language is different to English, the *locale* looks for source files,
based on the arguments you passed through the command-line.

When the argument you provided is a ``DIRECTORY'', the *locale* module
looks for configuration files inside it and produces translation files
based on the *render-from* and *locale-from* variables set in there.
On the other hand, when a ``FILE'' is provided, it takes the file
extension (i.e., the characters after the last dot in the file name)
and looks recursively in the file's directory for all the files that
have the same file extension the ``FILE'' does, and builds the list of
source files that will be used to produce the translation files. In
this case, the translation files are stored in a ``Locales''
directory, at the same level of the ``FILE'' you provided as argument
to *locale* module's command-line.

Translation files are the files we use to store translatable strings.
These files can be either portable objects (`.po'), machine objects
(`.po') or portable object templates (`.pot'). Machine objects are
built from portable objects. Portable objects are built from portable
object templates (`.pot').  Portable object templates are built using
*xgettext* or *xml2po* programs, according to the source files you are
retrieving translatable strings from. From these files, portable
objects (`.po') are used by *render* module to produce both localized
images and localized documentation while machine objects (`.mo') are
used by *gettext* program to produce localized output messages from
automation scripts.

Options
-------

The *locale* module accepts the following options:

*--help*::
    Print module's documentation.
*--version*::
    Print module's version.
*--filter="REGEX"*::
    When ``DIRECTORY'' is passed as argument, this option reduces the
    number of section blocks inside configuration files the *locale*
    module will take for processing by using the ``REGEX'' value is a
    regular expression pattern to match one or more section names
    inside the configuration files found under ``DIRECTORY''. When
    ``FILE'' is passed as argument, in the other hand, it limits the
    number of files that will be set in the list of source files used
    to build the final translation files.
*--update*::
*--edit*::
*--delete*::

Localizing Image Files
----------------------

Hi

Localizing Documentation Files
------------------------------

Hi

Localizing Automation Scripts
-----------------------------

Hi

Author
------

Written by mailto:al@centos.org.cu[Alain Reguera Delgado]

Copyright
---------

Copyright (C) 2009-2013 The CentOS Project

This program is free software; you can redistribute it and/or modify
it under the terms of the GNU General Public License as published by
the Free Software Foundation; either version 2 of the License, or (at
your option) any later version.

This program is distributed in the hope that it will be useful, but
WITHOUT ANY WARRANTY; without even the implied warranty of
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
General Public License for more details.

You should have received a copy of the GNU General Public License
along with this program; if not, write to the Free Software
Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA.

See Also
--------

centos-art.sh(1), centos-art.sh-render(1), gettext(1)

// vim: set syntax=asciidoc: