Blame Identity/Manual/repository-html/repository_2.48.html

728c6d
728c6d
<html>
728c6d
728c6d
organization, and administration of CentOS Artwork Repository.
728c6d
728c6d
Copyright C 2009-2011 Alain Reguera Delgado
728c6d
728c6d
Permission is granted to copy, distribute and/or modify this document
728c6d
under the terms of the GNU Free Documentation License, Version 1.2 or
728c6d
any later version published by the Free Software Foundation; with no
728c6d
Invariant Sections, no Front-Cover Texts, and no Back-Cover Texts. A
728c6d
copy of the license is included in the section entitled GNU Free
728c6d
Documentation License.  
728c6d
-->
728c6d
728c6d
728c6d
Written by: Lionel Cons <Lionel.Cons@cern.ch> (original author)
728c6d
            Karl Berry  <karl@freefriends.org>
728c6d
            Olaf Bachmann <obachman@mathematik.uni-kl.de>
728c6d
            and many others.
728c6d
Maintained by: Many creative people <dev@texi2html.cvshome.org>
728c6d
Send bugs and suggestions to <users@texi2html.cvshome.org>
728c6d
728c6d
-->
728c6d
<head>
728c6d
<title>CentOS Artwork Repository: 2.48 The trunk/Locales Directory</title>
728c6d
728c6d
<meta name="description" content="CentOS Artwork Repository: 2.48 The trunk/Locales Directory">
728c6d
<meta name="keywords" content="CentOS Artwork Repository: 2.48 The trunk/Locales Directory">
728c6d
<meta name="resource-type" content="document">
728c6d
<meta name="distribution" content="global">
728c6d
<meta name="Generator" content="texi2html 1.76">
728c6d
<meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
728c6d
<style type="text/css">
728c6d
728c6d
/* CSS
728c6d
 *
728c6d
 * repository.css -- This file provides visual style for repository
728c6d
 * documentation manual in HTML format, as output by Texi2html
728c6d
 * program.
728c6d
 *
728c6d
 * Copyright (C) 2009-2011 Alain Reguera Delgado
728c6d
 *
728c6d
 * This program is free software; you can redistribute it and/or
728c6d
 * modify it under the terms of the GNU General Public License as
728c6d
 * published by the Free Software Foundation; either version 2 of the
728c6d
 * License, or (at your option) any later version.
728c6d
 * 
728c6d
 * This program is distributed in the hope that it will be useful, but
728c6d
 * WITHOUT ANY WARRANTY; without even the implied warranty of
728c6d
 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
728c6d
 * General Public License for more details.
728c6d
 *
728c6d
 * You should have received a copy of the GNU General Public License
728c6d
 * along with this program; if not, write to the Free Software
728c6d
 * Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307
728c6d
 * USA.
728c6d
 * ----------------------------------------------------------------------
728c6d
 * $Id$
728c6d
 * ----------------------------------------------------------------------
728c6d
 */
728c6d
728c6d
@import url("/home/centos/artwork/trunk/Identity/Webenv/Css/base.css");
728c6d
@import url("/home/centos/artwork/trunk/Identity/Webenv/Css/base-app.css");
728c6d
728c6d
a.summary-letter {text-decoration: none}
728c6d
pre.display {font-family: serif}
728c6d
pre.format {font-family: serif}
728c6d
pre.menu-comment {font-family: serif}
728c6d
pre.menu-preformatted {font-family: serif}
728c6d
pre.smalldisplay {font-family: serif; font-size: smaller}
728c6d
pre.smallexample {font-size: smaller}
728c6d
pre.smallformat {font-family: serif; font-size: smaller}
728c6d
pre.smalllisp {font-size: smaller}
728c6d
span.sansserif {font-family:sans-serif; font-weight:normal;}
728c6d
ul.toc {list-style: none}
728c6d
-->
728c6d
</style>
728c6d
728c6d
728c6d
</head>
728c6d
728c6d
<body lang="en" bgcolor="#FFFFFF" text="#000000" link="#0000FF" vlink="#800080" alink="#FF0000">
728c6d
728c6d
728c6d
[ < ]
728c6d
[ > ]
728c6d
   
728c6d
[Contents]
728c6d
[Index]
728c6d
[ ? ]
728c6d
728c6d
728c6d
728c6d

2.48 The <tt>`trunk/Locales'</tt> Directory

728c6d
728c6d

The <tt>`trunk/Locales'</tt> directory exists to store the translation

728c6d
messages used to produce content in different languages.
728c6d

728c6d

Translation messages are organized using the directory structure of

728c6d
the component being translated. For example, if we want to provide
728c6d
translation messages for <tt>`trunk/Manuals/Repository'</tt>, then the
728c6d
<tt>`trunk/Locales/Manuals/Repository'</tt> directory needs to be created.
728c6d

728c6d

Once the locale directory exists for the component we want to provide

728c6d
translation messages for, it is necessary to create the translation
728c6d
files where translation messages are. The translation files follows
728c6d
the concepts of xml2po and GNU gettext tools.
728c6d

728c6d

The basic translation process is as follow: first, translatable

728c6d
strings are extracted from files and a portable object template (.pot)
728c6d
is created or updated with the information. Using the portable object
728c6d
template, a portable object (.po) is created or updated for translator
728c6d
to locale the messages retrived.  Finally, a machine object (.mo) is
728c6d
created from portable object to sotore the translated messages.
728c6d

728c6d

Inside the repository there are two ways to retrive translatable

728c6d
strings from files. The first one is through xml2po command
728c6d
and the second through xgettext command. The xml2po
728c6d
is used to retrive translatable strings from XML files (e.g., Scalable
728c6d
Vector Graphics, DocBook, etc.) and the xgettext command is
728c6d
used to retrive translatable strings from shell scripts files (e.g.,
728c6d
the files that make the centos-art.sh command-line
728c6d
interface).
728c6d

728c6d

When translatable strings are retrived from XML files, using the

728c6d
xml2po command, there is no need to create the machine
728c6d
object as we do when translatable strings ar retrived from shell
728c6d
files, using the xgettext command. The xml2po
728c6d
produces a temporal machine object in order to create a translated XML
728c6d
file. Once the translated XML file has been created the machine object
728c6d
is no longer needed. On the other hand, the machine object produced by
728c6d
the xgettext command is required by the system in order for
728c6d
the show shell script localized messages.
728c6d

728c6d

Another difference between xml2po and xgettext we

728c6d
need to be aware of is the directory structure used to store machine
728c6d
objects. In xml2po, the machine object is created in the
728c6d
current working directory as <tt>`.xml2po.mo'</tt> and can be safetly
728c6d
removed once the translated XML file has been created. In the case of
728c6d
xgettext, the machine object needs to be stored in the
728c6d
<tt>`$TEXTDOMAIN/$LOCALE/LL_MESSAGES/$TEXTDOMAIN.mo'</tt> file in order
728c6d
for the system to interpret it and should not be removed since it is
728c6d
the file that contain the translation messages themselves.
728c6d

728c6d

Automation of localization tasks is achived through the locale

728c6d
functionality of command-line interface.
728c6d

728c6d
728c6d
728c6d
728c6d
728c6d
[Contents]
728c6d
[Index]
728c6d
[ ? ]
728c6d
728c6d

728c6d
 <font size="-1">
728c6d
  This document was generated on March, 30 2011 using texi2html 1.76.
728c6d
 </font>
728c6d
 
728c6d
728c6d

728c6d
</body>
728c6d
</html>