Blame Manuals/en/Html/Repository/repository_54.html

4c79b5
4c79b5
<html>
6414c4
09d4f2
6414c4
Copyright C 2009, 2010, 2011  Alain Reguera Delgado
4c79b5
4c79b5
Permission is granted to copy, distribute and/or modify this document
4c79b5
under the terms of the GNU Free Documentation License, Version 1.2 or
4c79b5
any later version published by the Free Software Foundation; with no
4c79b5
Invariant Sections, no Front-Cover Texts, and no Back-Cover Texts. A
4c79b5
copy of the license is included in the section entitled GNU Free
4c79b5
Documentation License.  
4c79b5
-->
6414c4
4c79b5
4c79b5
Written by: Lionel Cons <Lionel.Cons@cern.ch> (original author)
4c79b5
            Karl Berry  <karl@freefriends.org>
4c79b5
            Olaf Bachmann <obachman@mathematik.uni-kl.de>
4c79b5
            and many others.
4c79b5
Maintained by: Many creative people <dev@texi2html.cvshome.org>
4c79b5
Send bugs and suggestions to <users@texi2html.cvshome.org>
4c79b5
4c79b5
-->
4c79b5
<head>
6414c4
<title>The CentOS Artwork Repository: 3.51 trunk/Translations</title>
4c79b5
6414c4
<meta name="description" content="The CentOS Artwork Repository: 3.51 trunk/Translations">
6414c4
<meta name="keywords" content="The CentOS Artwork Repository: 3.51 trunk/Translations">
4c79b5
<meta name="resource-type" content="document">
4c79b5
<meta name="distribution" content="global">
4c79b5
<meta name="Generator" content="texi2html 1.76">
4c79b5
<meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
4c79b5
<style type="text/css">
4c79b5
1e9202
@import "/home/centos/artwork/trunk/Identity/Models/Css/Texi2html/common.css";
4c79b5
4c79b5
a.summary-letter {text-decoration: none}
4c79b5
pre.display {font-family: serif}
4c79b5
pre.format {font-family: serif}
4c79b5
pre.menu-comment {font-family: serif}
4c79b5
pre.menu-preformatted {font-family: serif}
4c79b5
pre.smalldisplay {font-family: serif; font-size: smaller}
4c79b5
pre.smallexample {font-size: smaller}
4c79b5
pre.smallformat {font-family: serif; font-size: smaller}
4c79b5
pre.smalllisp {font-size: smaller}
4c79b5
span.sansserif {font-family:sans-serif; font-weight:normal;}
4c79b5
ul.toc {list-style: none}
4c79b5
-->
4c79b5
</style>
4c79b5
4c79b5
4c79b5
</head>
4c79b5
4c79b5
<body lang="en" bgcolor="#FFFFFF" text="#000000" link="#0000FF" vlink="#800080" alink="#FF0000">
4c79b5
4c79b5
6414c4
[ < ]
6414c4
[ > ]
4c79b5
   
4c79b5
[ << ]
4c79b5
[ Up ]
6414c4
[ >> ]
4c79b5
   
4c79b5
   
4c79b5
   
4c79b5
   
4c79b5
[Top]
4c79b5
[Contents]
6414c4
[Index]
4c79b5
[ ? ]
4c79b5
6414c4
6414c4
6414c4

3.51 trunk/Translations

6aec21
fe989b
6414c4
081970

3.51.1 Goals

6aec21
6414c4

The <tt>`trunk/Translations'</tt> directory exists to:

6414c4

008ee0
    6414c4
  • Organize translation files.
  • 6414c4
  • Organize translation templates used to produce translation files.
  • 008ee0
    fe989b
    008ee0
    6414c4
    273af8

    3.51.2 Description

    60c152
    6414c4

    When you create artwork for CentOS distribution you find that some

    6414c4
    artworks need to be created for different major releases of CentOS
    6414c4
    distribution and inside each major release they need to be created for
    6414c4
    different locales. To get an approximate idea of how many files we are
    6414c4
    talking about, consider the followig approximate statistic:
    6414c4

    035049
      6414c4
    • Inside CentOS distribution, there are around 30 images to
    • 6414c4
      rebrand.(2)
      6414c4
      6414c4
    • There are near to four major releases of CentOS distribution to
    • 6414c4
      rebrand in parallel development.(3) 
      6414c4
      6414c4
    • Each CentOS distribution in parallel development supports more
    • 6414c4
      than two hundreds locales.(4)
      035049
      e37211
      6414c4

      In order to aliviate maintainance of artwork production for such

      6414c4
      environment, we divided artwork production in three production lines:
      6414c4

      6414c4
        6414c4
      1. See section trunk/Identity/Themes/Models, to define artworks
      2. 6414c4
        characteristics (e.g., dimensions, position on the screen, etc.).
        6414c4
      3. See section trunk/Identity/Themes/Motifs, to define artworks visual
      4. 6414c4
        styles (e.g., the look and feel).
        6414c4
      5. Translations, to define which major releases and locales
      6. 6414c4
        artworks are produced for. 
        6414c4
        6414c4
        6414c4

        Inside CentOS Artwork Repository, the artworks' translation production

        6414c4
        line is stored under <tt>`trunk/Translations'</tt> directory.
        6414c4

        6414c4

        Inside <tt>`trunk/Translations'</tt> directory, we use "translation

        6414c4
        entries" to organize artworks' "translation files" and artworks'
        6414c4
        "translation templates".
        6414c4

        6414c4
        6414c4
        6414c4

        3.51.2.1 Translation Entries

        6414c4
        6414c4

        Translation entries exists for each artwork you want to produce.

        6414c4
        Translation entries can be empty directories, or directories
        6414c4
        containing translation files and translation templates.  
        6414c4

        6414c4

        When translation entries are empty directories, the identity entry is

        6414c4
        used as reference to create file names and directories layout for
        6414c4
        rendered files.  In this case, the centos-art script takes
        6414c4
        one design template and outputs one non-translated file for each
        6414c4
        design template available.  This configuration is mainly used to
        6414c4
        produce non-translatable artworks like themes' backgrounds.
        6414c4

        6414c4

        When translation entries contain translation files, the translation

        6414c4
        entry implements the CentOS release schema and is used as reference to
        6414c4
        create file names and directories layout for translated artworks. In
        6414c4
        this case, the centos-art script applies one translation
        6414c4
        file to one design template to create one translated instance which is
        6414c4
        used to output one translated file. When the translated file is
        6414c4
        rendered, the centos-art script remove the previous instance
        6414c4
        and takes the next file in the list of translation files to repate the
        6414c4
        whole process once again, and so on for all files in the list. This
        6414c4
        configuration is mainly used to produce translatable artworks like
        6414c4
        Anaconda's progress slide images.
        6414c4

        6414c4

        To find out correspondence between translation entries and identity

        6414c4
        entries, you need to look the path of both translation entries and
        6414c4
        identity entries. For example, if you are using the Modern's artisitic
        6414c4
        motif, the identity entry for Anaconda progress artwork is:
        6414c4

        6414c4
        trunk/Identity/Themes/Motifs/Modern/Distro/Anaconda/Progress
        6414c4
        6414c4

        and its translation entry is:

        6414c4

        6414c4
        trunk/Translations/Identity/Themes/Distro/Anaconda/Progress
        6414c4
        6414c4

        Note how the <tt>`Translations/'</tt> directory prefixes <tt>`Identity/'</tt>

        6414c4
        directory, also how static values (e.g., Identity, Themes, Distro,
        6414c4
        etc.) in the identity's entry path remain in translation's entry path,
        6414c4
        and how variable values like theme names (e.g., Modern) are stript out
        6414c4
        from translation's entry path. The same convenction can be applied to
        6414c4
        other identity entries in order to determine their translation
        6414c4
        entries, or to other translation entries to determine their identity
        6414c4
        entries.
        6414c4

        6414c4
        info

        Note

        Translation entries related to identity entries under

        6414c4
        <tt>`trunk/Identity/Themes/Motifs'</tt> do not use <tt>`Motifs/'</tt> in the
        6414c4
        path.  We've done this because <tt>`trunk/Identity/Themes/Models'</tt>
        6414c4
        structure, the other structure under <tt>`trunk/Identity/Themes'</tt>,
        6414c4
        doesn't require translation paths so far. So in the sake of saving
        6414c4
        characters space when building translation entries for
        6414c4
        <tt>`trunk/Identity/Themes/Motifs'</tt> structure, we organize Motifs
        6414c4
        translation entries under <tt>`trunk/Translations/Identity/Themes/'</tt>
        6414c4
        directly. 
        6414c4

        6414c4

        If for some reason <tt>`trunk/Identity/Themes/Models'</tt> structure

        6414c4
        requires translation entries, we need to re-oraganize the current
        6414c4
        directory structure accordingly.
        6414c4

        6414c4
        6414c4

        Translation entries, as described above, can be re-used by similar

        6414c4
        identity entries. For example the following identity entries:
        6414c4

        6414c4
        trunk/Identity/Themes/Motifs/Modern/Distro/Anaconda/Progress/
        6414c4
        trunk/Identity/Themes/Motifs/TreeFlower/Distro/Anaconda/Progress/
        6414c4
        trunk/Identity/Themes/Motifs/Mettle/Distro/Anaconda/Progress/
        6414c4
        6414c4

        are all valid identity entries able to re-use translation files inside

        6414c4
        Anaconda progress translation entry (the one shown in our example
        6414c4
        above). This way, you can create several identity entries and maintain
        6414c4
        just one translation entry for all of them.  Once you change the
        6414c4
        translation files inside the common translation entry, changes inside
        6414c4
        identity entries will take effect inside the next you render them.
        6414c4

        6414c4

        Trying to make things plain and simple: inside CentOS Artwork

        6414c4
        Repository, graphic designers can concentrate their efforts in
        6414c4
        artworks look and feel (the identity entries), and translators in
        6414c4
        artworks translations (the translation entries).
        6414c4

        6414c4
        6414c4
        6414c4

        3.51.2.2 Translation Markers

        6414c4

        6414c4
        6414c4

        6414c4

        Translation markers are used in "Theme Model Designs" and

        6414c4
        "Translation Files" as replacement patterns to commit content
        6414c4
        translation.  When you are rendering content using
        6414c4
        centos-art script inisde <tt>`trunk/Identity'</tt> structure,
        6414c4
        artistic motifs and translation files are applied to model designs to
        6414c4
        produce translated content as result. In order to have the appropriate
        6414c4
        translation in content rendered, markers defintion in translation
        6414c4
        files should match markers in model designs exactly. 
        6414c4

        6414c4
        6414c4

        Translation Markers

        6414c4
        6414c4

        Figure 3.22: The image rendering flow.

        6414c4
        6414c4

        6414c4

        Translation markers can be whatever text you want, but as convenction

        6414c4
        we use the following to represent releases of CentOS distribution:
        6414c4

        6414c4
        6414c4
        <samp>`=MINOR_RELEASE='</samp>
        6414c4

        Replace with minor release of CentOS distribution. In the schema M.N, the minor

        6414c4
        release is represented by the N letter.
        6414c4

        6414c4
        <samp>`=MAJOR_RELEASE='</samp>
        6414c4

        Replace with major release of CentOS distribution. In the schema M.N,

        6414c4
        the major release is represented by the M letter.
        6414c4

        6414c4
        <samp>`=RELEASE='</samp>
        6414c4

        Replace the full release of CentOS distribution. It is

        6414c4
        <samp>`=MAJOR_RELEASE=.=MINOR_RELEASE='</samp> basically. 
        6414c4

        6414c4
        6414c4
        6414c4

        Specific translation markers convenctions are described inside

        6414c4
        specific translation entries. Read translation entries documentation
        6414c4
        to know more about supported translation markers.
        6414c4

        6414c4

        Translation markers standardization creates a common point of

        6414c4
        reference for translators and graphic designers. To have translation
        6414c4
        markers well defined makes possible that translators and graphic
        6414c4
        designers can work together but independently one another.
        6414c4

        6414c4
        6414c4
        6414c4

        3.51.2.3 Translation Files

        6414c4
        6414c4

        Translation files are text files with sed's commands inside,

        6414c4
        replacement commands mainly. As convenction, translation file names
        6414c4
        end in <samp>`.sed'</samp>. Translation files are used by centos-art
        6414c4
        script to produce translated artworks for specific major releases of
        6414c4
        CentOS Distribution. There are common translation files, specific
        6414c4
        translation, and template translation files.
        6414c4

        6414c4

        For example, the Firstboot artwork of CentOS distribution uses the

        6414c4
        images <tt>`splash-small.png'</tt> and <tt>`firstboot-left.png'</tt> as based
        6414c4
        to control its visual style. The <tt>`splash-small.png'</tt> image
        6414c4
        contains, in its graphic design, the release number information of
        6414c4
        CentOS distribution. So the <tt>`splash-small.png'</tt> is
        6414c4
        release-specific. In the other hand, the <tt>`firstboot-left.png'</tt>
        6414c4
        doesn't contain release number information. So the
        6414c4
        <tt>`firstboot-left.png'</tt> is not release-specific.
        6414c4

        6414c4

        If we want to produce Firstboot artwork for different major releases

        6414c4
        of CentOS distribution, using a monolithic visual identity, all
        6414c4
        Firstboot images should have the same visual style and, at the same
        6414c4
        time, the release-specific information in the release-specific images. 
        6414c4

        6414c4
        info

        Note

        The monolithic visual identity is implemented using

        6414c4
        theme models (see section trunk/Identity/Themes/Models) and artistic
        6414c4
        motifs (see section trunk/Identity/Themes/Motifs).
        6414c4

        6414c4
        6414c4

        Assuming that both theme models and theme motifs are ready for using,

        6414c4
        the initial translation entry to produce Firstboot artworks would look
        6414c4
        like the following:
        6414c4

        6414c4
        trunk/Translations/Identity/Themes/Distro/BootUp/Firstboot/
        6414c4
        |-- Tpl
        6414c4
        |   `-- splash-small.sed
        6414c4
        `-- firstboot-left.sed
        6414c4
        6414c4

        With the translation entry above, centos-art command is able

        6414c4
        to produce the image <tt>`firstboot-left.png'</tt> only. To produce
        6414c4
        <tt>`splash-small.png'</tt> images for major releases (e.g., 3, 4, 5, and
        6414c4
        6) of CentOS distribution we need to produce the release-specific
        6414c4
        translation files using the centos-art script as following:
        6414c4

        6414c4
        centos-art render --entry=/home/centos/artwork/trunk/Translations/Identity/Themes/BootUp/Firstboot --filter='3,4,5,6'
        6414c4
        6414c4

        The above command produces the following translation entiry:

        6414c4

        6414c4
        trunk/Translations/Identity/Themes/Distro/BootUp/Firstboot/
        6414c4
        |-- 3
        6414c4
        |   `-- splash-small.sed
        6414c4
        |-- 4
        6414c4
        |   `-- splash-small.sed
        6414c4
        |-- 5
        6414c4
        |   `-- splash-small.sed
        6414c4
        |-- 6
        6414c4
        |   `-- splash-small.sed
        6414c4
        |-- Tpl
        6414c4
        |   `-- splash-small.sed
        6414c4
        `-- firstboot-left.sed
        6414c4
        6414c4

        At this point centos-art is able to produce the Firstboot

        6414c4
        artwork images for major releases of CentOS distribution. To add new
        6414c4
        release-specific translation files, run the translation rendering
        6414c4
        command with the release number you want to produce translation files
        6414c4
        for in the <samp>`--filter='release-number''</samp> argument.
        6414c4

        6414c4
        6414c4
        6414c4

        3.51.2.4 Template Translation Files

        6414c4
        6414c4

        Template translation files are translation files stored inside

        6414c4
        translation template directory. Template translation files are used by
        6414c4
        centos-art script to produce specific translation files
        6414c4
        only. Template translation files may be empty or contain
        6414c4
        sed's replacement commands. If template translation files
        6414c4
        are empty files, the final specifc translation file built from it
        6414c4
        contains release-specific replacement commands only. For example,
        6414c4
        see the following translation entry:
        6414c4

        6414c4
        trunk/Translations/Identity/Themes/Distro/BootUp/Firstboot/
        6414c4
        |-- 3
        6414c4
        |   `-- splash-small.sed
        6414c4
        |-- 4
        6414c4
        |   `-- splash-small.sed
        6414c4
        |-- 5
        6414c4
        |   `-- splash-small.sed
        6414c4
        |-- 6
        6414c4
        |   `-- splash-small.sed
        6414c4
        |-- Tpl
        6414c4
        |   `-- splash-small.sed    <-- template translation file.
        6414c4
        `-- firstboot-left.sed
        6414c4
        6414c4

        In the above exmaple, the <tt>`splash-small.sed'</tt> file is a template

        6414c4
        translation file and looks like:
        6414c4

        6414c4
        # -------------------------------------
        6414c4
        # $Id: splash-small.sed 94 2010-09-18 10:59:42Z al $
        6414c4
        # -------------------------------------
        6414c4
        6414c4

        In the above template translation file there are three comments lines,

        6414c4
        but when you render it, the centos-art adds the
        6414c4
        release-specific replacement commands. In our Firstboot example, after
        6414c4
        rendering Firstboot translation entry, the <tt>`splash-small.sed'</tt>
        6414c4
        translation file specific to CentOS 5, looks like the following:
        6414c4

        6414c4
        # Warning: Do not modify this file directly. This file is created
        6414c4
        # automatically using 'centos-art' command line interface.  Any change
        6414c4
        # you do in this file will be lost the next time you update
        6414c4
        # translation files using 'centos-art' command line interface. If you
        6414c4
        # want to improve the content of this translation file, improve its
        6414c4
        # template file instead and run the 'centos-art' command line
        6414c4
        # interface later to propagate your changes.
        6414c4
        # -------------------------------------
        6414c4
        # $Id: splash-small.sed 94 2010-09-18 10:59:42Z al $
        6414c4
        # -------------------------------------
        6414c4
        6414c4
        # Release number information.
        6414c4
        s!=RELEASE=!=MAJOR_RELEASE=.=MINOR_RELEASE=!g
        6414c4
        s!=MINOR_RELEASE=!0!g
        6414c4
        s!=MAJOR_RELEASE=!5!g
        6414c4
        6414c4

        If template translation files are not empty, replacement commands

        6414c4
        inside template translation files are preserved inside
        6414c4
        release-specific translation files.  For example, consider the English
        6414c4
        template translation file of Anaconda progress welcome slide.  The
        6414c4
        translation template directory structure looks like the following:
        6414c4

        6414c4
        trunk/Translations/Identity/Themes/Distro/Anaconda/Progress/
        6414c4
        `-- Tpl
        6414c4
            `-- en
        6414c4
                `-- 01-welcome.sed
        6414c4
        6414c4

        and if we render translation files for CentOS 4 and CentOS 5 major

        6414c4
        releases, the translation entry would look like the following:
        6414c4

        6414c4
        trunk/Translations/Identity/Themes/Distro/Anaconda/Progress/
        6414c4
        |-- 4
        6414c4
        |   `-- en
        6414c4
        |       `-- 01-welcome.sed
        6414c4
        |-- 5
        6414c4
        |   `-- en
        6414c4
        |       `-- 01-welcome.sed
        6414c4
        `-- Tpl
        6414c4
            `-- en
        6414c4
                `-- 01-welcome.sed
        6414c4
        6414c4
        info

        Note

        Release-specific translation directories preserve

        6414c4
        template translation directory structure and file names.
        6414c4

        6414c4
        6414c4

        In the example above, the template translation file looks like the

        6414c4
        following:
        6414c4

        6414c4
        # ------------------------------------------------------------
        6414c4
        # $Id: 01-welcome.sed 94 2010-09-18 10:59:42Z al $
        6414c4
        # ------------------------------------------------------------
        6414c4
        s/=TITLE=/Welcome to CentOS =MAJOR_RELEASE= !/
        6414c4
        s/=TEXT1=/Thank you for installing CentOS =MAJOR_RELEASE=./
        6414c4
        s/=TEXT2=/CentOS is an enterprise-class Linux Distribution derived from sources freely provided to the public by a prominent North American Enterprise Linux vendor./
        6414c4
        s/=TEXT3=/CentOS conforms fully with the upstream vendors redistribution policy and aims to be 100% binary compatible. CentOS mainly changes packages to remove upstream vendor branding and artwork./
        6414c4
        s/=TEXT4=//
        6414c4
        s/=TEXT5=//
        6414c4
        s/=TEXT6=//
        6414c4
        s!=URL=!http://www.centos.org/!
        6414c4
        6414c4

        and, after render the translation entry, specific translation files

        6414c4
        look like the following:
        6414c4

        6414c4
        # Warning: Do not modify this file directly. This file is created
        6414c4
        # automatically using 'centos-art' command line interface.  Any change
        6414c4
        # you do in this file will be lost the next time you update
        6414c4
        # translation files using 'centos-art' command line interface. If you
        6414c4
        # want to improve the content of this translation file, improve its
        6414c4
        # template file instead and run the 'centos-art' command line
        6414c4
        # interface later to propagate your changes.
        6414c4
        # ------------------------------------------------------------
        6414c4
        # $Id: 01-welcome.sed 94 2010-09-18 10:59:42Z al $
        6414c4
        # ------------------------------------------------------------
        6414c4
        6414c4
        s/=TITLE=/Welcome to CentOS =MAJOR_RELEASE= !/
        6414c4
        s/=TEXT1=/Thank you for installing CentOS =MAJOR_RELEASE=./
        6414c4
        s/=TEXT2=/CentOS is an enterprise-class Linux Distribution derived from sources freely provided to the public by a prominen t North American Enterprise Linux vendor./
        6414c4
        s/=TEXT3=/CentOS conforms fully with the upstream vendors redistribution policy and aims to be 100% binary compatible. Cent OS mainly changes packages to remove upstream vendor branding and artwork./
        6414c4
        s/=TEXT4=//
        6414c4
        s/=TEXT5=//
        6414c4
        s/=TEXT6=//
        6414c4
        s!=URL=!http://www.centos.org/!
        6414c4
        6414c4
        # Release number information.
        6414c4
        s!=RELEASE=!=MAJOR_RELEASE=.=MINOR_RELEASE=!g
        6414c4
        s!=MINOR_RELEASE=!0!g
        6414c4
        s!=MAJOR_RELEASE=!5!g
        6414c4
        6414c4

        In the example above, relevant lines begin with the <samp>`s'</samp> word

        6414c4
        followed by a separation character (e.g., <samp>`/'</samp>, <samp>`!'</samp>, etc.).
        6414c4
        These lines have the following format:
        6414c4

        6414c4
        s/REGEXP/REPLACEMENT/FLAGS
        6414c4
        6414c4

        The <samp>`/'</samp> characters may be uniformly replaced by any other single

        6414c4
        character within any given s command.  The <samp>`/'</samp>
        6414c4
        character (or whatever other character is used in its stead) can
        6414c4
        appear in the REGEXP or REPLACEMENT only if it is preceded by a
        6414c4
        <samp>`\'</samp> character.
        6414c4

        6414c4

        The s command is probably the most important in

        6414c4
        sed and has a lot of different options.  Its basic concept
        6414c4
        is simple: the s command attempts to match the pattern space
        6414c4
        against the supplied REGEXP; if the match is successful, then that
        6414c4
        portion of the pattern space which was matched is replaced with
        6414c4
        REPLACEMENT.
        6414c4

        6414c4

        In the context of our translation files, the REGEXP is where you

        6414c4
        define translation markers and REPLACEMENT where you define the
        6414c4
        translation text you want to have after artworks rendering.  Sometimes
        6414c4
        we use the FLAG component with the <samp>`g'</samp> command to apply the
        6414c4
        replacements globally.
        6414c4

        6414c4
        Info

        Tip

        More information about how to use sed's

        6414c4
        replacement commands and flags is available in sed's
        6414c4
        documentation manual. To read sed's documentation manual type the
        6414c4
        following command: 
        6414c4

        info sed
        6414c4
        6414c4
        6414c4

        Inside translation files, you can use translation markers not only

        6414c4
        inside the REGEXP but in the REPLACEMENT too. In order for this
        6414c4
        configuration to work, the REPLACEMENT of translation markers needs to
        6414c4
        be define after its definition. For example, see in the
        6414c4
        release-specific translation file above, how the
        6414c4
        <samp>`s!=MAJOR_RELASE=!5!g'</samp> replacement command is defined
        6414c4
        after <samp>`=MAJOR_RELASE='</samp> translation marker definition in
        6414c4
        the REPLACEMENT of <samp>`=TITLE='</samp> translation marker replacement
        6414c4
        command.
        6414c4

        6414c4
        6414c4
        6414c4

        3.51.2.5 Common Translation Files

        6414c4
        6414c4

        Common translation files contain common translations or no

        6414c4
        translation at all for their related artworks.  They are in the root
        6414c4
        directory of the translation entry. Common translation files create
        6414c4
        common artworks for all major releases of CentOS Distribution. 
        6414c4

        6414c4

        Translation entries, with common translation files inside, look like

        6414c4
        the following:
        6414c4

        6414c4
        trunk/Translations/Identity/Themes/Distro/BootUp/Firstboot/
        6414c4
        |-- 3
        6414c4
        |   `-- splash-small.sed
        6414c4
        |-- 4
        6414c4
        |   `-- splash-small.sed
        6414c4
        |-- 5
        6414c4
        |   `-- splash-small.sed
        6414c4
        |-- 6
        6414c4
        |   `-- splash-small.sed
        6414c4
        |-- Tpl
        6414c4
        |   `-- splash-small.sed
        6414c4
        `-- firstboot-left.sed      <-- common translation file.
        6414c4
        6414c4
        6414c4
        6414c4

        3.51.2.6 Specific Translation Files

        6414c4
        6414c4

        Specific translation files contain specific translations for their

        6414c4
        related artworks. Specific translation files are not in the root
        6414c4
        directory of the translation entry, but inside directories which
        6414c4
        describe the type of translation they are doing. Specific translation
        6414c4
        files are produced automatically using the centos-art
        6414c4
        script.
        6414c4

        6414c4
        trunk/Translations/Identity/Themes/Distro/BootUp/Firstboot/
        6414c4
        |-- 3
        6414c4
        |   `-- splash-small.sed    <-- CentOS 3 specific translation file.
        6414c4
        |-- 4
        6414c4
        |   `-- splash-small.sed    <-- CentOS 4 specific translation file.
        6414c4
        |-- 5
        6414c4
        |   `-- splash-small.sed    <-- CentOS 5 specific translation file.
        6414c4
        |-- 6
        6414c4
        |   `-- splash-small.sed    <-- CentOS 6 specific translation file.
        6414c4
        |-- Tpl
        6414c4
        |   `-- splash-small.sed
        6414c4
        `-- firstboot-left.sed
        6414c4
        6414c4
        6414c4
        6414c4

        3.51.2.7 Translation Rendering

        6414c4
        6414c4

        When rendering translations, the centos-art script checks

        6414c4
        the translation entry to verify that it has a translation template
        6414c4
        directory inside. The translation template directory (<tt>`Tpl/'</tt>)
        6414c4
        contains common translation files used to build release-specific
        6414c4
        translation files. If the translation template directory doesn't exist
        6414c4
        inside the translation entry the translation rendering fails. In this
        6414c4
        case the centos-art script outputs a message and quits
        6414c4
        script execution.
        6414c4

        6414c4
        6414c4
        6414c4

        3.51.2.8 Translation (Pre-)Rendering Configuration Scripts

        6414c4
        6414c4

        When the centos-art script finds a translation template

        6414c4
        directory inside translation entry, it looks for translations
        6414c4
        pre-rendering configuration scripts for that translation entry.
        6414c4
        Translation pre-rendering configuration scripts let you extend
        6414c4
        translation's default functionality (described below). 
        6414c4

        6414c4

        Translation pre-rendering configuration scripts are stored under

        6414c4
        <tt>`trunk/Scripts'</tt> directory, specifically under the appropriate
        6414c4
        language implementation. If you are using centos-art Bash's
        6414c4
        implementation, the translation pre-rendering scripts are store in the
        6414c4
        <tt>`trunk/Scripts/Bash/Config'</tt> location; if you are using
        6414c4
        centos-art Python's implementation, then translation
        6414c4
        pre-rendering scripts are stored in the
        6414c4
        <tt>`trunk/Scripts/Python/Config'</tt> location, and so on for other
        6414c4
        implementations.
        6414c4

        6414c4

        Bash's translation pre-rendering configuration scripts look like the

        6414c4
        following:
        6414c4

        6414c4
        #!/bin/bash
        6414c4
        #
        6414c4
        # render_loadConfig.sh -- brief description here.
        6414c4
        #
        6414c4
        # Copyright (C) YEAR YOURNAME
        6414c4
        # 
        6414c4
        # This program is free software; you can redistribute it and/or modify
        6414c4
        # it under the terms of the GNU General Public License as published by
        6414c4
        # the Free Software Foundation; either version 2 of the License, or
        6414c4
        # (at your option) any later version.
        6414c4
        # 
        6414c4
        # This program is distributed in the hope that it will be useful, but
        6414c4
        # WITHOUT ANY WARRANTY; without even the implied warranty of
        6414c4
        # MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
        6414c4
        # General Public License for more details.
        6414c4
        #
        6414c4
        # You should have received a copy of the GNU General Public License
        6414c4
        # along with this program; if not, write to the Free Software
        6414c4
        # Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307
        6414c4
        # USA.
        6414c4
        # 
        6414c4
        # ----------------------------------------------------------------------
        6414c4
        # $Id: render_loadConfig.sh 94 2010-09-18 10:59:42Z al $
        6414c4
        # ----------------------------------------------------------------------
        6414c4
        6414c4
        function render_loadConfig {
        6414c4
        ...
        6414c4
        }
        6414c4
        6414c4

        Translation pre-rendering scripts are function scripts loaded and

        6414c4
        executed when rendering a translation entry. Translation pre-rendering
        6414c4
        scripts are loaded using the translation entry being rendered as
        6414c4
        reference. For example, suppose you are using the
        6414c4
        centos-art Bash's implementation, and you are rendering
        6414c4
        translations for CentOS brands, in this situation the translation
        6414c4
        entry would be:
        6414c4

        6414c4
        trunk/Translations/Identity/Brands
        6414c4
        6414c4

        and the entry inside the translation pre-rendering configuration

        6414c4
        structure would be:
        6414c4

        6414c4
        trunk/Scripts/Bash/Config/Identity/Brands
        6414c4
        6414c4

        Once the centos-art script detects that translation

        6414c4
        pre-rendering configuration directory exists, the centos-art
        6414c4
        script looks for the translation pre-rendering configuration file.  If
        6414c4
        the translation pre-rendering configuration file exists, it is loaded
        6414c4
        and executed.  Once the translation pre-rendering configuration file
        6414c4
        has been executed the translation rendering process is over, and so
        6414c4
        the script execution.
        6414c4

        6414c4
        info

        Note

        Translation pre-rendering configuration files have the

        6414c4
        following form:
        6414c4

        render.conf.extension
        6414c4

        where <samp>`extension'</samp> refers the programming language implementation

        6414c4
        you are using. For example, <samp>`sh'</samp> for Bash's, <samp>`py'</samp> for
        6414c4
        Python's, <samp>`pl'</samp> for Perl's, and so on for other implementations.
        6414c4

        6414c4
        6414c4

        As we are using Bash implementation to describe the translation

        6414c4
        pre-rendering configuration example, the translation pre-rendering
        6414c4
        configuration file that centos-art looks for, inside the
        6414c4
        above translation pre-rendering configuration directory, is
        6414c4
        <tt>`render.conf.sh'</tt>.
        6414c4

        6414c4
        6414c4
        6414c4

        3.51.2.9 Translation Rendering Default Functionality

        6414c4
        6414c4

        In the other hand, if the translation pre-rendering configuration file

        6414c4
        doesn't exist, or it isn't written as function script, the
        6414c4
        centos-art script ignore translation pre-rendering
        6414c4
        configuration functionality and passes to render translation using
        6414c4
        default functionality instead.
        6414c4

        6414c4

        The translation rendering default functionality takes template

        6414c4
        translation directory structure, duplicates it for each release number
        6414c4
        specified in the <samp>`--filter='release-number''</samp> argument and
        6414c4
        produces release-specific directories. As part of template translation
        6414c4
        duplication process take place, the centos-art script adds
        6414c4
        release-specific replacement commands to each specific translation
        6414c4
        file inside release-specific directories. As result, specific
        6414c4
        translation files, inside release-specific directories, contain
        6414c4
        template translation replacement commands plus,
        6414c4
        release-specific replacement commands.
        6414c4

        6414c4
        info

        Note

        Release-specific replacement commands are standardized

        6414c4
        inside centos-art script using predifined release
        6414c4
        translation markers. Release translation markers are described in the
        6414c4
        translation marker section
        6414c4
        (see Translation Markers).
        6414c4

        6414c4
        6414c4
        e37211
        01b527
        e37211

        3.51.3 Usage

        e37211
        6414c4
        6414c4
        <samp>`centos-art render --entry='path/to/dir''</samp>
        6414c4
        6414c4

        When <samp>`path/to/dir'</samp> refers one directory under

        6414c4
        <samp>`trunk/Translations'</samp>, this command orverwrites available
        6414c4
        translation files using translation templates.
        6414c4

        6414c4
        6414c4
        <samp>`centos-art render --entry='path/to/dir' --filter='pattern''</samp>
        6414c4
        6414c4

        When <samp>`path/to/dir'</samp> refers one directory under

        6414c4
        <tt>`trunk/Translations'</tt>, this command renders release-specific
        6414c4
        translation files as you specify in the <samp>`--filter='pattern''</samp>
        6414c4
        argument. In this case, <samp>`pattern'</samp> not a regular expression but an
        6414c4
        number (e.g., <samp>`5'</samp>) or a list of numbers separated by commas
        6414c4
        (e.g., <samp>`3,4,5,6'</samp>) that specify the major release of CentOS
        6414c4
        distribution you want to render translations for.  
        6414c4

        6414c4
        e37211
        035049
        01b527
        4c79b5

        3.51.4 See also

        4c79b5
        63f275
        6414c4
        3.53 trunk/Translations/Identity/Brands  
        035049
        6414c4
        3.55 trunk/Translations/Identity/Fonts  
        035049
        6414c4
        3.56 trunk/Translations/Identity/Models  
        035049
        6414c4
        3.57 trunk/Translations/Identity/Release  
        035049
        6414c4
        3.58 trunk/Translations/Identity/Themes  
        63f275
        035049
        3.1 trunk/Identity  
        63f275
        63f275
        4c79b5
        4c79b5
        4c79b5
        01b527
        [ < ]
        01b527
        [ > ]
        4c79b5
           
        4c79b5
        [ << ]
        6414c4
        [ Up ]
        6414c4
        [ >> ]
        4c79b5
        4c79b5

        4c79b5
         <font size="-1">
        6414c4
          This document was generated on January, 3 2011 using texi2html 1.76.
        4c79b5
         </font>
        4c79b5
         
        4c79b5
        4c79b5

        4c79b5
        </body>
        4c79b5
        </html>