@subsection Goals

@itemize

@item ...

@end itemize

@subsection Description

This command looks for @samp{.sh} files inside Bash directory and

extracts translatable strings from files, using @command{xgettext}

command, in order to create a portable object template

(@file{centos-art.sh.pot}) file for them.

With the @file{centos-art.sh.pot} file up to date, the

@command{centos-art} command removes the temporal list of files sotred

inside @file{/tmp} directory and checks the current language of your

user's session to create a portable object file for it, in the

location @file{$CLI_LANG/$CLI_LANG.po}. 

The @var{CLI_LANG} variable discribes the locale language used to

output messages inside @command{centos-art} command. The locale

language used inside @command{centos-art} command is taken from the

@env{LANG} environment variable.  The @var{CLI_LANG} variable has the

@samp{LL_CC} format, where @samp{LL} is a language code from the

ISO-639 standard, and @samp{CC} a country code from the ISO-3166

standard.

The @env{LANG} environment variable is set when you do log in to your

system. If you are using a graphical session, change language to your

native language and do login. That would set and exoprt the @env{LANG}

environment variable to the correct value. On the other side, if you

are using a text session edit your @file{~/.bash_profile} file to set

and export the @env{LANG} environment variable to your native locale

as defines the @command{locale -a} command output; do logout, and do

login again.

At this point, the @env{LANG} environment variable has the appropriate

value you need, in order to translate @command{centos-art.sh} messages

to your native language (the one set in @env{LANG} environment

variable). 

With the @file{$CLI_LANG/$CLI_LANG.po} file up to date, the

@command{centos-art} opens it for you to update translation strings.

The @command{centos-art} command uses the value of @var{EDITOR}

environment variable to determine your favorite text editor. If no

value is defined on @var{EDITOR}, the @file{/usr/bin/vim} text editor

is used as default.

When you finishd PO file edition and quit text editor, the

@command{centos-art} command creates the related machine object in the

location @file{$CLI_LANG/LC_MESSAGES/$TEXTDOMAIN.mo}.

At this point, all translations you made in the PO file should be

available to your language when runing @command{centos-art.sh} script. 

In order to make the @command{centos-art.sh} internationalization, the

@command{centos-art.sh} script was modified as described in the

@command{gettext} info documentation (@command{info gettext}).  You

can find such modifications in the following files:

@itemize

@item @file{trunk/Scripts/Bash/initFunctions.sh}

@item @file{trunk/Scripts/Bash/Functions/Help/cli_localeMessages.sh}

@item @file{trunk/Scripts/Bash/Functions/Help/cli_localeMessagesStatus.sh}

@end itemize

@itemize

@item ...

@end itemize

@subsection Usage

@table @samp

@item centos-art locale --edit

Use this command to translate command-line interface output messages

in the current system locale you are using (as specified in @env{LANG}

environment variable).

@item centos-art locale --list

Use this command to see the command-line interface locale report.

@end table

@subsection See also

@menu

@end menu