Blame Manuals/en/Plaintext/Repository/repository.txt

4c79b5
Table of Contents
4c79b5
*****************
4c79b5
4c79b5
CentOS Artwork Repository
4c79b5
1 branches
4c79b5
2 tags
4c79b5
3 trunk
4c79b5
  3.1 trunk/Identity
4c79b5
    3.1.1 Goals
4c79b5
    3.1.2 Description
4c79b5
    3.1.3 Usage
4c79b5
    3.1.4 Renderable directories
4c79b5
      3.1.4.1 Layout 1: Simple image rendering
4c79b5
      3.1.4.2 Layout 2: Simple image rendering (extended)
4c79b5
      3.1.4.3 Layout 3: Language specific image rendering
4c79b5
      3.1.4.4 Layout 4: Release and language specific image rendering
4c79b5
      3.1.4.5 Layout 5: Brands specific image rendering
4c79b5
      3.1.4.6 Layout 6: Themes specific image rendering
4c79b5
    3.1.5 File name convenctions
4c79b5
      3.1.5.1 When text-based files are rendered
4c79b5
      3.1.5.2 When image-based files are rendered
4c79b5
    3.1.6 See also
4c79b5
    3.1.7 References
4c79b5
  3.2 trunk/Identity/Brands
4c79b5
    3.2.1 Goals
4c79b5
    3.2.2 Description
4c79b5
    3.2.3 Usage
4c79b5
    3.2.4 See also
4c79b5
  3.3 trunk/Identity/Fonts
4c79b5
    3.3.1 Goals
4c79b5
    3.3.2 Description
4c79b5
    3.3.3 Usage
4c79b5
    3.3.4 See also
4c79b5
  3.4 trunk/Identity/Icons
4c79b5
    3.4.1 Goals
4c79b5
    3.4.2 Description
4c79b5
    3.4.3 Usage
4c79b5
    3.4.4 See also
4c79b5
  3.5 trunk/Identity/Isolinux
4c79b5
    3.5.1 Goals
4c79b5
    3.5.2 Description
4c79b5
    3.5.3 Usage
4c79b5
    3.5.4 See also
4c79b5
  3.6 trunk/Identity/Models
4c79b5
    3.6.1 Goals
4c79b5
    3.6.2 Description
4c79b5
    3.6.3 Usage
4c79b5
    3.6.4 See also
4c79b5
  3.7 trunk/Identity/Release
4c79b5
    3.7.1 Goals
4c79b5
    3.7.2 Description
4c79b5
    3.7.3 Usage
4c79b5
    3.7.4 See also
4c79b5
  3.8 trunk/Identity/Themes
4c79b5
    3.8.1 Goals
4c79b5
    3.8.2 Description
4c79b5
    3.8.3 Usage
4c79b5
    3.8.4 See also
4c79b5
  3.9 trunk/Identity/Themes/Models
4c79b5
    3.9.1 Goals
4c79b5
    3.9.2 Description
4c79b5
    3.9.3 Usage
4c79b5
    3.9.4 See also
4c79b5
  3.10 trunk/Identity/Themes/Models/Alternative
4c79b5
    3.10.1 Goals
4c79b5
    3.10.2 Description
4c79b5
    3.10.3 Usage
4c79b5
    3.10.4 See also
4c79b5
  3.11 trunk/Identity/Themes/Models/Default
4c79b5
    3.11.1 Goals
4c79b5
    3.11.2 Description
4c79b5
    3.11.3 Usage
4c79b5
    3.11.4 See also
4c79b5
  3.12 trunk/Identity/Themes/Models/Default/Distro
4c79b5
    3.12.1 Goals
4c79b5
    3.12.2 Description
4c79b5
      3.12.2.1 One theme for all major releases
4c79b5
      3.12.2.2 One theme for each major release
4c79b5
    3.12.3 Usage
4c79b5
    3.12.4 See also
4c79b5
  3.13 trunk/Identity/Themes/Models/Default/Distro/Anaconda
4c79b5
    3.13.1 Goals
4c79b5
    3.13.2 Description
4c79b5
    3.13.3 Usage
4c79b5
    3.13.4 See also
4c79b5
  3.14 trunk/Identity/Themes/Models/Default/Promo
4c79b5
    3.14.1 Goals
4c79b5
    3.14.2 Description
4c79b5
    3.14.3 Usage
4c79b5
    3.14.4 See also
4c79b5
  3.15 trunk/Identity/Themes/Models/Default/Web
4c79b5
    3.15.1 Goals
4c79b5
    3.15.2 Description
4c79b5
    3.15.3 Usage
4c79b5
    3.15.4 See also
4c79b5
  3.16 trunk/Identity/Themes/Motifs
4c79b5
    3.16.1 Goals
4c79b5
    3.16.2 Description
4c79b5
    3.16.3 Usage
4c79b5
    3.16.4 See also
4c79b5
  3.17 trunk/Identity/Themes/Motifs/Modern/Backgrounds
4c79b5
    3.17.1 Goals
4c79b5
    3.17.2 Description
4c79b5
    3.17.3 Usage
4c79b5
    3.17.4 See also
4c79b5
  3.18 trunk/Identity/Themes/Motifs/Modern/Backgrounds/Img
4c79b5
    3.18.1 Goals
4c79b5
    3.18.2 Description
4c79b5
    3.18.3 Usage
4c79b5
    3.18.4 See also
4c79b5
  3.19 trunk/Identity/Themes/Motifs/Modern/Backgrounds/Tpl
4c79b5
    3.19.1 Goals
4c79b5
    3.19.2 Description
4c79b5
    3.19.3 Usage
4c79b5
    3.19.4 See also
4c79b5
  3.20 trunk/Identity/Themes/Motifs/Modern/Backgrounds/Xcf
4c79b5
    3.20.1 Goals
4c79b5
    3.20.2 Description
4c79b5
    3.20.3 Usage
4c79b5
    3.20.4 See also
4c79b5
  3.21 trunk/Identity/Themes/Motifs/Modern/Distro/Anaconda/Progress
4c79b5
    3.21.1 Goals
4c79b5
    3.21.2 Description
4c79b5
    3.21.3 Usage
4c79b5
    3.21.4 See also
4c79b5
  3.22 trunk/Identity/Themes/Motifs/Modern/Palettes
4c79b5
    3.22.1 Goals
4c79b5
    3.22.2 Description
4c79b5
    3.22.3 Usage
4c79b5
    3.22.4 See also
4c79b5
  3.23 trunk/Identity/Themes/Motifs/TreeFlower
4c79b5
    3.23.1 Goals
4c79b5
    3.23.2 Description
4c79b5
    3.23.3 Usage
4c79b5
    3.23.4 See also
4c79b5
  3.24 trunk/Identity/Widgets
4c79b5
    3.24.1 Goals
4c79b5
    3.24.2 Description
4c79b5
    3.24.3 Usage
4c79b5
    3.24.4 See also
4c79b5
  3.25 trunk/Manuals
4c79b5
    3.25.1 Goals
4c79b5
    3.25.2 Description
4c79b5
    3.25.3 Usage
4c79b5
    3.25.4 See also
4c79b5
  3.26 trunk/Scripts
4c79b5
    3.26.1 Goals
4c79b5
    3.26.2 Description
4c79b5
    3.26.3 Usage
4c79b5
    3.26.4 See also
4c79b5
  3.27 trunk/Scripts/Bash
4c79b5
    3.27.1 Goals
4c79b5
    3.27.2 Description
4c79b5
      3.27.2.1 The identity matching list
4c79b5
      3.27.2.2 Adding new features
4c79b5
    3.27.3 Usage
4c79b5
      3.27.3.1 The `centos-art' `check' action
4c79b5
      3.27.3.2 The `centos-art' `search' action
4c79b5
      3.27.3.3 The `centos-art' `path' action
4c79b5
      3.27.3.4 The `centos-art' `locale-art' action
4c79b5
      3.27.3.5 The `centos-art' `license' action
4c79b5
    3.27.4 See also
4c79b5
  3.28 trunk/Scripts/Bash/Config
4c79b5
    3.28.1 Goals
4c79b5
    3.28.2 Description
4c79b5
      3.28.2.1 The `render.conf.sh' identity model
4c79b5
      3.28.2.2 The `render.conf.sh' translation model
4c79b5
    3.28.3 Usage
4c79b5
    3.28.4 See also
4c79b5
  3.29 trunk/Scripts/Bash/Config/Identity
4c79b5
    3.29.1 Goals
4c79b5
    3.29.2 Description
4c79b5
    3.29.3 Usage
4c79b5
    3.29.4 See also
4c79b5
  3.30 trunk/Scripts/Bash/Config/Translations
4c79b5
    3.30.1 Goals
4c79b5
    3.30.2 Description
4c79b5
    3.30.3 Usage
4c79b5
    3.30.4 See also
4c79b5
  3.31 trunk/Scripts/Bash/Functions
4c79b5
    3.31.1 Goals
4c79b5
    3.31.2 Description
4c79b5
    3.31.3 Usage
4c79b5
    3.31.4 See also
4c79b5
  3.32 trunk/Scripts/Bash/Functions/Config
4c79b5
  3.33 trunk/Scripts/Bash/Functions/Config/cli_getActionsIdentity.sh
4c79b5
  3.34 trunk/Scripts/Bash/Functions/Config/cli_getActions.sh
4c79b5
  3.35 trunk/Scripts/Bash/Functions/Config/cli_getActionsTranslations.sh
4c79b5
  3.36 trunk/Scripts/Bash/Functions/Config/cli_getIdentityMatchinglist.sh
4c79b5
  3.37 trunk/Scripts/Bash/Functions/Config/repo_renderIdentitySyslinux.sh
4c79b5
    3.37.1 Goals
4c79b5
    3.37.2 Description
4c79b5
    3.37.3 Usage
4c79b5
    3.37.4 See also
300762
  3.38 trunk/Scripts/Bash/Functions/Prepare/prepare_forUsingPackages.sh
4c79b5
    3.38.1 Goals
4c79b5
    3.38.2 Description
4c79b5
    3.38.3 Usage
4c79b5
    3.38.4 See also
300762
  3.39 trunk/Scripts/Bash/Functions/Render/Config
4c79b5
    3.39.1 Goals
4c79b5
    3.39.2 Description
4c79b5
    3.39.3 Usage
4c79b5
    3.39.4 See also
300762
  3.40 trunk/Scripts/Bash/Functions/Render/render_getActionsIdentity.sh
4c79b5
    3.40.1 Goals
4c79b5
    3.40.2 Description
4c79b5
    3.40.3 Usage
4c79b5
    3.40.4 See also
300762
  3.41 trunk/Scripts/Bash/Functions/Render/render_getActions.sh
4c79b5
    3.41.1 Goals
4c79b5
    3.41.2 Description
4c79b5
    3.41.3 Usage
4c79b5
    3.41.4 See also
300762
  3.42 trunk/Scripts/Bash/Functions/Render/render_getActionsTranslations.sh
4c79b5
    3.42.1 Goals
4c79b5
    3.42.2 Description
4c79b5
    3.42.3 Usage
4c79b5
    3.42.4 See also
300762
  3.43 trunk/Scripts/Bash/Locale
4c79b5
    3.43.1 Goals
4c79b5
    3.43.2 Description
300762
      3.43.2.1 Configuration files
4c79b5
    3.43.3 Usage
300762
      3.43.3.1 The `centos-art' `locale-cli' action
4c79b5
    3.43.4 See also
300762
  3.44 trunk/Scripts/Perl
4c79b5
    3.44.1 Goals
4c79b5
    3.44.2 Description
4c79b5
    3.44.3 Usage
4c79b5
    3.44.4 See also
300762
  3.45 trunk/Scripts/Python
4c79b5
    3.45.1 Goals
4c79b5
    3.45.2 Description
4c79b5
    3.45.3 Usage
4c79b5
    3.45.4 See also
300762
  3.46 trunk/Translations
4c79b5
    3.46.1 Goals
4c79b5
    3.46.2 Description
300762
      3.46.2.1 Translation Entries
300762
      3.46.2.2 Translation Markers
300762
      3.46.2.3 Translation Files
300762
      3.46.2.4 Template Translation Files
300762
      3.46.2.5 Common Translation Files
300762
      3.46.2.6 Specific Translation Files
300762
      3.46.2.7 Translation Rendering
300762
      3.46.2.8 Translation (Pre-)Rendering Configuration Scripts
300762
      3.46.2.9 Translation Rendering Default Functionality
4c79b5
    3.46.3 Usage
4c79b5
    3.46.4 See also
300762
  3.47 trunk/Translations/Identity
4c79b5
    3.47.1 Goals
4c79b5
    3.47.2 Description
4c79b5
    3.47.3 Usage
4c79b5
    3.47.4 See also
300762
  3.48 trunk/Translations/Identity/Brands
4c79b5
    3.48.1 Goals
4c79b5
    3.48.2 Description
300762
      3.48.2.1 Conventional file names
300762
      3.48.2.2 Numeric file names
300762
      3.48.2.3 Translation markers
4c79b5
    3.48.3 Usage
4c79b5
    3.48.4 See also
300762
  3.49 trunk/Translations/Identity/Brands/Tpl
4c79b5
    3.49.1 Goals
4c79b5
    3.49.2 Description
4c79b5
    3.49.3 Usage
4c79b5
    3.49.4 See also
300762
  3.50 trunk/Translations/Identity/Fonts
4c79b5
    3.50.1 Goals
4c79b5
    3.50.2 Description
300762
      3.50.2.1 Translation Markers
4c79b5
    3.50.3 Usage
4c79b5
    3.50.4 See also
300762
  3.51 trunk/Translations/Identity/Models
4c79b5
    3.51.1 Goals
4c79b5
    3.51.2 Description
4c79b5
    3.51.3 Usage
4c79b5
    3.51.4 See also
300762
  3.52 trunk/Translations/Identity/Release
300762
    3.52.1 Goals
300762
    3.52.2 Description
300762
    3.52.3 Usage
300762
    3.52.4 See also
300762
  3.53 trunk/Translations/Identity/Themes
300762
    3.53.1 Goals
300762
    3.53.2 Description
300762
    3.53.3 Usage
300762
    3.53.4 See also
300762
  3.54 trunk/Translations/Identity/Themes/Backgrounds
300762
    3.54.1 Goals
300762
    3.54.2 Description
300762
    3.54.3 Usage
300762
    3.54.4 See also
300762
  3.55 trunk/Translations/Identity/Themes/Distro/Anaconda/Progress
300762
    3.55.1 Goals
300762
    3.55.2 Description
300762
    3.55.3 Usage
300762
    3.55.4 See also
300762
  3.56 trunk/Translations/Identity/Widgets
300762
    3.56.1 Goals
300762
    3.56.2 Description
300762
    3.56.3 Usage
300762
    3.56.4 See also
4c79b5
Index
4c79b5
List of Figures
4c79b5
4c79b5
4c79b5
CentOS Artwork Repository
4c79b5
*************************
4c79b5
4c79b5
This manual describes what the CentOS Artwork Repository is and what
4c79b5
can you do inside it.
4c79b5
4c79b5
   Copyright (C) 2009, 2010 CentOS Artwork SIG. All rights reserved.
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
4c79b5
1 branches
4c79b5
**********
4c79b5
4c79b5
2 tags
4c79b5
******
4c79b5
4c79b5
3 trunk
4c79b5
*******
4c79b5
4c79b5
3.1 trunk/Identity
4c79b5
==================
4c79b5
4c79b5
3.1.1 Goals
4c79b5
-----------
4c79b5
4c79b5
The `trunk/Identity' directory exists to organize CentOS corporate
4c79b5
identity artworks.
4c79b5
4c79b5
3.1.2 Description
4c79b5
-----------------
4c79b5
4c79b5
The CentOS Project corporate identity is the "persona" of the
4c79b5
organization known as The CentOS Project.  The CentOS Project corporate
4c79b5
identity plays a significant role in the way the CentOS Project, as
4c79b5
organization, presents itself to both internal and external
4c79b5
stakeholders. In general terms, the CentOS Project corporate visual
4c79b5
identity expresses the values and ambitions of the CentOS Project
4c79b5
organization, its business, and its characteristics.
4c79b5
4c79b5
   The CentOS Project corporate identity provides visibility,
4c79b5
recognizability, reputation, structure and identification to the CentOS
4c79b5
Project organization by means of corporate design, corporate
4c79b5
communication, and corporate behaviour.
4c79b5
4c79b5
   The CentOS Project settles down its corporate visual identity on a
4c79b5
"monolithic corporate visual identity structure". In this structure The
4c79b5
CentOS Project uses one unique name (The CentOS Brand) and one unique
4c79b5
visual style (The CentOS Default Theme) in all its manifestations.
4c79b5
4c79b5
*The CentOS Brands*
4c79b5
     The CentOS brand is the name or trademark that conncects the
4c79b5
     producer with their products. In this case, the producer is The
4c79b5
     CentOS Project and the products are the CentOS distributions, the
4c79b5
     CentOS web sites, the CentOS promotion stuff, etc.
4c79b5
4c79b5
     *Note trunk Identity Brands::, for more information.
4c79b5
4c79b5
*The CentOS Themes*
4c79b5
     The CentOS themes are a set of image files connected by one unique
4c79b5
     visual style. The CentOS themes implements CentOS project corporate
4c79b5
     visual identity in each visual manifestation of CentOS project
4c79b5
     (e.g., distributions, websites, promotion stuff, etc.).
4c79b5
4c79b5
     *Note trunk Identity Themes::, for more information.
4c79b5
4c79b5
   Inside a monolithic corporate visual identity structure, internal and
4c79b5
external stakeholders use to feel a strong sensation of uniformity,
4c79b5
orientation, and identification with the organization. No matter if you
4c79b5
are visiting websites, using the distribution, or acting on social
4c79b5
events, the one unique name and one unique visual style conect them all
4c79b5
to say: Hey! we are all parts of the CentOS project.  And, probably,
4c79b5
some vister will say: Can I join the party?  Yes you can, it is free. :)
4c79b5
4c79b5
3.1.3 Usage
4c79b5
-----------
4c79b5
4c79b5
To produce identity artworks, use the following commands:
4c79b5
4c79b5
`centos-art render 'path/to/dir''
4c79b5
     When `path/to/dir' refers to one renderable directory under
4c79b5
     `trunk/Identity', this command renders identity artworks using
4c79b5
     both related design models and related translation files.
4c79b5
4c79b5
`centos-art render 'path/to/dir' --filter='pattern''
4c79b5
     When `path/to/dir' refers to one renderable directory under
4c79b5
     `trunk/Identity', this command renders identity artworks using
4c79b5
     both related design models and related translation files that match
4c79b5
     the regular expression passed in `--filter='pattern'' argument.
4c79b5
4c79b5
     To control the number of files produced by `centos-art' command,
4c79b5
     you need to look into the translation path and provide a regular
4c79b5
     expression pattern that matches the translation path, or paths,
4c79b5
     related to the file, or files, you want to produce.
4c79b5
4c79b5
     The regular expression pattern you provide to `centos-art' command
4c79b5
     is applied to the translation path from its very beginning.  It is
4c79b5
     not the same to say `5/en/01-welcome' that `01-welcome', the frist
4c79b5
     expression matches but the last one does not.
4c79b5
4c79b5
     When using `--filter='pattern'' you don't need to specify the file
4c79b5
     extension. It is removed from translation path before applying the
4c79b5
     pattern, so it doesn't count here.
4c79b5
4c79b5
3.1.4 Renderable directories
4c79b5
----------------------------
4c79b5
4c79b5
Inside `trunk/Identity', renderable directories should have one of the
4c79b5
following directory layouts:
4c79b5
4c79b5
3.1.4.1 Layout 1: Simple image rendering
4c79b5
........................................
4c79b5
4c79b5
This directory layout contains one `Img/' directory (to store final
4c79b5
images), one `Tpl/' directory to store design templates, and the
4c79b5
translation entry is empty (there isn't translation files in this
4c79b5
configuration).  In this configuration, one design template produces
4c79b5
one untranslated PNG image, just as it is in the template.
4c79b5
4c79b5
4c79b5
trunk/Identity/path/to/dir
4c79b5
|-- Img
4c79b5
|   |-- anaconda_header_fig1.png
4c79b5
|   |-- anaconda_header_fig2.png
4c79b5
|   `-- anaconda_header_summary.png
4c79b5
`-- Tpl
4c79b5
    |-- anaconda_header_fig1.svg
4c79b5
    |-- anaconda_header_fig2.svg
4c79b5
    `-- anaconda_header_summary.svg
4c79b5
4c79b5
3.1.4.2 Layout 2: Simple image rendering (extended)
4c79b5
...................................................
4c79b5
4c79b5
This directory layout contains one `Img/' directory (to store final
4c79b5
images), one `Tpl/' directory to store design templates, and the
4c79b5
translation entry is empty (there isn't translation files in this
4c79b5
configuration).  When images are rendered, the `Img/' directory
4c79b5
structure is created automatically using the `Tpl/' directory structure
4c79b5
as reference.  In this configuration, one design template produces one
4c79b5
untranslated PNG image, just as it is in the template.
4c79b5
4c79b5
4c79b5
trunk/Identity/path/to/dir
4c79b5
|-- Img
4c79b5
|   |-- Corporate
4c79b5
|   |   `-- monolithic.png
4c79b5
|   `-- Distro
4c79b5
|       `-- Anaconda
4c79b5
|           `-- Header
4c79b5
|               |-- fig1.png
4c79b5
|               |-- fig2.png
4c79b5
|               `-- summary.png
4c79b5
`-- Tpl
4c79b5
    |-- Corporate
4c79b5
    |   `-- monolithic.svg
4c79b5
    `-- Distro
4c79b5
        `-- Anaconda
4c79b5
            `-- Header
4c79b5
                |-- fig1.svg
4c79b5
                |-- fig2.svg
4c79b5
                `-- summary.svg
4c79b5
4c79b5
3.1.4.3 Layout 3: Language specific image rendering
4c79b5
...................................................
4c79b5
4c79b5
This directory layout extends previous one in order to produce
4c79b5
language-specific images.  This directory layout contains one `Img/'
4c79b5
directory (to store final images), one `Tpl/' directory to store design
4c79b5
templates, and the translation entry contains translation files inside
4c79b5
(organized by language codes).
4c79b5
4c79b5
4c79b5
trunk/Translations/Identity/path/to/dir
4c79b5
|-- en
4c79b5
|   |-- Corporate
4c79b5
|   |   `-- monolithic.sed
4c79b5
|   `-- Distro
4c79b5
|       `-- Anaconda
4c79b5
|           `-- Header
4c79b5
|               |-- fig1.sed
4c79b5
|               |-- fig2.sed
4c79b5
|               `-- summary.sed
4c79b5
`-- es
4c79b5
    |-- Corporate
4c79b5
    |   `-- monolithic.sed
4c79b5
    `-- Distro
4c79b5
        `-- Anaconda
4c79b5
            `-- Header
4c79b5
                |-- fig1.sed
4c79b5
                |-- fig2.sed
4c79b5
                `-- summary.sed
4c79b5
4c79b5
   When images are rendered, the `Img/' directory structure is created
4c79b5
automatically using the translation entry structure as reference (see
4c79b5
above).
4c79b5
4c79b5
4c79b5
trunk/Identity/path/to/dir
4c79b5
|-- Img
4c79b5
|   |-- en
4c79b5
|   |   |-- Corporate
4c79b5
|   |   |   `-- monolithic.png
4c79b5
|   |   `-- Distro
4c79b5
|   |       `-- Anaconda
4c79b5
|   |           `-- Header
4c79b5
|   |               |-- fig1.png
4c79b5
|   |               |-- fig2.png
4c79b5
|   |               `-- summary.png
4c79b5
|   `-- es
4c79b5
|       |-- Corporate
4c79b5
|       |   `-- monolithic.png
4c79b5
|       `-- Distro
4c79b5
|           `-- Anaconda
4c79b5
|               `-- Header
4c79b5
|                   |-- fig1.png
4c79b5
|                   |-- fig2.png
4c79b5
|                   `-- summary.png
4c79b5
`-- Tpl
4c79b5
    |-- Corporate
4c79b5
    |   `-- monolithic.svg
4c79b5
    `-- Distro
4c79b5
        `-- Anaconda
4c79b5
            `-- Header
4c79b5
                |-- fig1.svg
4c79b5
                |-- fig2.svg
4c79b5
                `-- summary.svg
4c79b5
4c79b5
   In this configuration, one language-specific file is applied to one
4c79b5
design tempalate to produce one translated PNG image. The relation
4c79b5
between language-specific translation file and design template is done
4c79b5
removing the language-specific directory from translation path, and the
4c79b5
one design template path that matches it is used.
4c79b5
4c79b5
   If no design template is found for one translation file, the final
4c79b5
PNG image for that translation file is not produced and the next
4c79b5
translation file in the list is evaluated.
4c79b5
4c79b5
   For example, in this configuration the following translation files:
4c79b5
4c79b5
4c79b5
trunk/Translations/Identity/path/to/dir/en/Corporate/monolithic.sed
4c79b5
trunk/Translations/Identity/path/to/dir/es/Corporate/monolithic.sed
4c79b5
4c79b5
   match the same design template file:
4c79b5
4c79b5
4c79b5
trunk/Identity/path/to/dir/Tpl/Corporate/monolithic.svg
4c79b5
4c79b5
   in order to produce the following PNG image files:
4c79b5
4c79b5
4c79b5
trunk/Identity/path/to/dir/Img/en/Corporate/monolithic.png
4c79b5
trunk/Identity/path/to/dir/Img/es/Corporate/monolithic.png
4c79b5
4c79b5
3.1.4.4 Layout 4: Release and language specific image rendering
4c79b5
...............................................................
4c79b5
4c79b5
This directory layout extends previous one in order to produce
4c79b5
language-specific images for different major releases of CentOS
4c79b5
distribution (as CentOS release schema describes).
4c79b5
4c79b5
   This directory layout contains one `Img/' directory (to store final
4c79b5
images), one `Tpl/' directory to store design templates, and the
4c79b5
translation entry contains translation files inside (organized by
4c79b5
language codes and major release numbers).
4c79b5
4c79b5
4c79b5
trunk/Translations/Identity/path/to/dir
4c79b5
|-- 5
4c79b5
|   |-- en
4c79b5
|   |   |-- Corporate
4c79b5
|   |   |   `-- monolithic.sed
4c79b5
|   |   `-- Distro
4c79b5
|   |       `-- Anaconda
4c79b5
|   |           `-- Header
4c79b5
|   |               |-- fig1.sed
4c79b5
|   |               |-- fig2.sed
4c79b5
|   |               `-- summary.sed
4c79b5
|   `-- es
4c79b5
|       |-- Corporate
4c79b5
|       |   `-- monolithic.sed
4c79b5
|       `-- Distro
4c79b5
|           `-- Anaconda
4c79b5
|               `-- Header
4c79b5
|                   |-- fig1.sed
4c79b5
|                   |-- fig2.sed
4c79b5
|                   `-- summary.sed
4c79b5
`-- 6
4c79b5
    |-- en
4c79b5
    |   |-- Corporate
4c79b5
    |   |   `-- monolithic.sed
4c79b5
    |   `-- Distro
4c79b5
    |       `-- Anaconda
4c79b5
    |           `-- Header
4c79b5
    |               |-- fig1.sed
4c79b5
    |               |-- fig2.sed
4c79b5
    |               `-- summary.sed
4c79b5
    `-- es
4c79b5
        |-- Corporate
4c79b5
        |   `-- monolithic.sed
4c79b5
        `-- Distro
4c79b5
            `-- Anaconda
4c79b5
                `-- Header
4c79b5
                    |-- fig1.sed
4c79b5
                    |-- fig2.sed
4c79b5
                    `-- summary.sed
4c79b5
4c79b5
   When images are rendered, the `Img/' directory structure is created
4c79b5
automatically using the translation entry structure as reference (see
4c79b5
above).
4c79b5
4c79b5
4c79b5
trunk/Identity/path/to/dir
4c79b5
|-- Img
4c79b5
|   |-- 5
4c79b5
|   |   |-- en
4c79b5
|   |   |   |-- Corporate
4c79b5
|   |   |   |   `-- monolithic.png
4c79b5
|   |   |   `-- Distro
4c79b5
|   |   |       `-- Anaconda
4c79b5
|   |   |           `-- Header
4c79b5
|   |   |               |-- fig1.png
4c79b5
|   |   |               |-- fig2.png
4c79b5
|   |   |               `-- summary.png
4c79b5
|   |   `-- es
4c79b5
|   |       |-- Corporate
4c79b5
|   |       |   `-- monolithic.png
4c79b5
|   |       `-- Distro
4c79b5
|   |           `-- Anaconda
4c79b5
|   |               `-- Header
4c79b5
|   |                   |-- fig1.png
4c79b5
|   |                   |-- fig2.png
4c79b5
|   |                   `-- summary.png
4c79b5
|   `-- 6
4c79b5
|       |-- en
4c79b5
|       |   |-- Corporate
4c79b5
|       |   |   `-- monolithic.png
4c79b5
|       |   `-- Distro
4c79b5
|       |       `-- Anaconda
4c79b5
|       |           `-- Header
4c79b5
|       |               |-- fig1.png
4c79b5
|       |               |-- fig2.png
4c79b5
|       |               `-- summary.png
4c79b5
|       `-- es
4c79b5
|           |-- Corporate
4c79b5
|           |   `-- monolithic.png
4c79b5
|           `-- Distro
4c79b5
|               `-- Anaconda
4c79b5
|                   `-- Header
4c79b5
|                           |-- fig1.png
4c79b5
|                           |-- fig2.png
4c79b5
|                           `-- summary.png
4c79b5
`-- Tpl
4c79b5
    |-- Corporate
4c79b5
    |   `-- monolithic.svg
4c79b5
    `-- Distro
4c79b5
        `-- Anaconda
4c79b5
            `-- Header
4c79b5
                |-- fig1.svg
4c79b5
                |-- fig2.svg
4c79b5
                `-- summary.svg
4c79b5
4c79b5
   In this configuration, one language-specific file,  is applied to one
4c79b5
design tempalate to produce one translated PNG image for each major
4c79b5
release specified in the translation entry.  The relation among
4c79b5
release-specific and language-specific translation files, and design
4c79b5
template is done removing the release-specific and language-specific
4c79b5
directories from translation path, and looking for the one design
4c79b5
template path that matches.
4c79b5
4c79b5
   If no design template matches the translation file, the final PNG
4c79b5
image for that translation file is not produced and the next
4c79b5
translation file in the list is evaluated.
4c79b5
4c79b5
   For example, in this configuration, the following translation files:
4c79b5
4c79b5
4c79b5
trunk/Translations/Identity/path/to/dir/5/en/Corporate/monolithic.sed
4c79b5
trunk/Translations/Identity/path/to/dir/5/es/Corporate/monolithic.sed
4c79b5
trunk/Translations/Identity/path/to/dir/6/en/Corporate/monolithic.sed
4c79b5
trunk/Translations/Identity/path/to/dir/6/es/Corporate/monolithic.sed
4c79b5
4c79b5
   match the same design template file:
4c79b5
4c79b5
4c79b5
trunk/Identity/path/to/dir/Tpl/Corporate/monolithic.svg
4c79b5
4c79b5
   in order to produce the following PNG image files:
4c79b5
4c79b5
4c79b5
trunk/Identity/path/to/dir/Img/5/en/Corporate/monolithic.png
4c79b5
trunk/Identity/path/to/dir/Img/5/es/Corporate/monolithic.png
4c79b5
trunk/Identity/path/to/dir/Img/6/en/Corporate/monolithic.png
4c79b5
trunk/Identity/path/to/dir/Img/6/es/Corporate/monolithic.png
4c79b5
4c79b5
3.1.4.5 Layout 5: Brands specific image rendering
4c79b5
.................................................
4c79b5
4c79b5
*Note trunk Identity Brands::, for more information about themes
4c79b5
specific image rendering and directory layout.
4c79b5
4c79b5
3.1.4.6 Layout 6: Themes specific image rendering
4c79b5
.................................................
4c79b5
4c79b5
*Note trunk Identity Themes::, for more information about themes
4c79b5
specific image rendering and directory layout.
4c79b5
4c79b5
3.1.5 File name convenctions
4c79b5
----------------------------
4c79b5
4c79b5
As file name convenction, inside CentOS Artwork Repository, both
4c79b5
text-based and image-based file name produced by `centos-art.sh' script
4c79b5
has the same name of their translation files without the `.sed'
4c79b5
extension. The file extension is set as follow:
4c79b5
4c79b5
3.1.5.1 When text-based files are rendered
4c79b5
..........................................
4c79b5
4c79b5
Text-based files end up having the same extension of their design
4c79b5
template file.
4c79b5
4c79b5
3.1.5.2 When image-based files are rendered
4c79b5
...........................................
4c79b5
4c79b5
Image-based files always end up having the `.png' extension.
4c79b5
4c79b5
     *Tip* Once `.png' images are created, other image formats may be
4c79b5
     created using the `renderFormats' post-rendering action, inside
4c79b5
     the image-based related pre-rendering configuration script.
4c79b5
4c79b5
     *Note trunk Scripts Bash Config::, for more information.
4c79b5
4c79b5
3.1.6 See also
4c79b5
--------------
4c79b5
4c79b5
3.1.7 References
4c79b5
----------------
4c79b5
4c79b5
   * `http://en.wikipedia.org/Corporate_identity' (and related links).
4c79b5
4c79b5
3.2 trunk/Identity/Brands
4c79b5
=========================
4c79b5
4c79b5
3.2.1 Goals
4c79b5
-----------
4c79b5
4c79b5
   * ...
4c79b5
4c79b5
3.2.2 Description
4c79b5
-----------------
4c79b5
4c79b5
3.2.3 Usage
4c79b5
-----------
4c79b5
4c79b5
3.2.4 See also
4c79b5
--------------
4c79b5
4c79b5
3.3 trunk/Identity/Fonts
4c79b5
========================
4c79b5
4c79b5
3.3.1 Goals
4c79b5
-----------
4c79b5
4c79b5
   * ...
4c79b5
4c79b5
3.3.2 Description
4c79b5
-----------------
4c79b5
4c79b5
3.3.3 Usage
4c79b5
-----------
4c79b5
4c79b5
3.3.4 See also
4c79b5
--------------
4c79b5
4c79b5
3.4 trunk/Identity/Icons
4c79b5
========================
4c79b5
4c79b5
3.4.1 Goals
4c79b5
-----------
4c79b5
4c79b5
   * ...
4c79b5
4c79b5
3.4.2 Description
4c79b5
-----------------
4c79b5
4c79b5
3.4.3 Usage
4c79b5
-----------
4c79b5
4c79b5
3.4.4 See also
4c79b5
--------------
4c79b5
4c79b5
3.5 trunk/Identity/Isolinux
4c79b5
===========================
4c79b5
4c79b5
3.5.1 Goals
4c79b5
-----------
4c79b5
4c79b5
   * ...
4c79b5
4c79b5
3.5.2 Description
4c79b5
-----------------
4c79b5
4c79b5
3.5.3 Usage
4c79b5
-----------
4c79b5
4c79b5
3.5.4 See also
4c79b5
--------------
4c79b5
4c79b5
3.6 trunk/Identity/Models
4c79b5
=========================
4c79b5
4c79b5
3.6.1 Goals
4c79b5
-----------
4c79b5
4c79b5
   * ...
4c79b5
4c79b5
3.6.2 Description
4c79b5
-----------------
4c79b5
4c79b5
3.6.3 Usage
4c79b5
-----------
4c79b5
4c79b5
3.6.4 See also
4c79b5
--------------
4c79b5
4c79b5
3.7 trunk/Identity/Release
4c79b5
==========================
4c79b5
4c79b5
3.7.1 Goals
4c79b5
-----------
4c79b5
4c79b5
   * ...
4c79b5
4c79b5
3.7.2 Description
4c79b5
-----------------
4c79b5
4c79b5
3.7.3 Usage
4c79b5
-----------
4c79b5
4c79b5
3.7.4 See also
4c79b5
--------------
4c79b5
4c79b5
3.8 trunk/Identity/Themes
4c79b5
=========================
4c79b5
4c79b5
3.8.1 Goals
4c79b5
-----------
4c79b5
4c79b5
The `trunk/Identity/Themes/' directory exists to:
4c79b5
4c79b5
   * Organize CentOS Themes.
4c79b5
4c79b5
3.8.2 Description
4c79b5
-----------------
4c79b5
4c79b5
3.8.3 Usage
4c79b5
-----------
4c79b5
4c79b5
In this location themes are organized in "Models" --to store common
4c79b5
information-- and "Motifs"--to store unique information.  At rendering
4c79b5
time, both motifs and models are combined to produce the final CentOS
4c79b5
themes.  CentOS themes can be tagged as "Default" or "Alternative".
4c79b5
CentOS themes are maintained by CentOS community.
4c79b5
4c79b5
3.8.4 See also
4c79b5
--------------
4c79b5
4c79b5
3.9 trunk/Identity/Themes/Models
4c79b5
================================
4c79b5
4c79b5
3.9.1 Goals
4c79b5
-----------
4c79b5
4c79b5
   * Organize theme models.
4c79b5
4c79b5
3.9.2 Description
4c79b5
-----------------
4c79b5
4c79b5
Theme models let you modeling characteristics (e.g., dimensions,
4c79b5
translation markers, position of each element on the display area,
4c79b5
etc.) common to all themes.  Theme models let you reduce the time
4c79b5
needed when propagating artistic motifs to different visual
4c79b5
manifestations.
4c79b5
4c79b5
   Theme models serves as a central pool of design templates for themes
4c79b5
to use. This way you can produce themes with different artistic motifs
4c79b5
but same characteristics.
4c79b5
4c79b5
3.9.3 Usage
4c79b5
-----------
4c79b5
4c79b5
Inside the framework location above, you find theme models organized by
4c79b5
name. You can add your own theme models to the structure by adding a
4c79b5
directory to the list. By default you have the `*Note Default: trunk
4c79b5
Identity Themes Models Default,' and `*Note Alternative: trunk Identity
4c79b5
Themes Models Alternative,' ready-to-use theme models.
4c79b5
4c79b5
3.9.4 See also
4c79b5
--------------
4c79b5
4c79b5
3.10 trunk/Identity/Themes/Models/Alternative
4c79b5
=============================================
4c79b5
4c79b5
3.10.1 Goals
4c79b5
------------
4c79b5
4c79b5
   * ...
4c79b5
4c79b5
3.10.2 Description
4c79b5
------------------
4c79b5
4c79b5
CentOS alternative theme models exist for people how want to use a
4c79b5
different visual style on their installations of CentOS distribution.
4c79b5
As the visual style is needed for a system already installed components
4c79b5
like Anaconda are not required inside alternative themes.  Inside
4c79b5
alternative themes you find post-installation visual style only (i.e.
4c79b5
Backgrounds, Display Managers, Grub, etc.).  CentOS alternative themes
4c79b5
are maintained by CentOS Community.
4c79b5
4c79b5
3.10.3 Usage
4c79b5
------------
4c79b5
4c79b5
   * ...
4c79b5
4c79b5
3.10.4 See also
4c79b5
---------------
4c79b5
4c79b5
3.11 trunk/Identity/Themes/Models/Default
4c79b5
=========================================
4c79b5
4c79b5
3.11.1 Goals
4c79b5
------------
4c79b5
4c79b5
This location stores CentOS default theme model. The CentOS default
4c79b5
theme model is used in all visual manifestations of CentOS Project's
4c79b5
corporate visual identity (e.g., distributions, web sites, promotion,
4c79b5
etc.).
4c79b5
4c79b5
3.11.2 Description
4c79b5
------------------
4c79b5
4c79b5
3.11.3 Usage
4c79b5
------------
4c79b5
4c79b5
Changing CentOS default theme is not very convenient because that
4c79b5
affects the "recognition" of CentOS Project.  Nevertheless, we are
4c79b5
interested on seeing your art work propositions.  Specially if your art
4c79b5
work is an improvement to the base idea behind CentOS default theme
4c79b5
(*Modern*, squares and circles flowing up.).
4c79b5
4c79b5
   If you are not happy with CentOS default theme, you can look inside
4c79b5
CentOS alternative themes and download the one you are interested in.
4c79b5
If you are not happy with any of the CentOS alternative themes
4c79b5
available, then go and design your own CentOS alternative theme as
4c79b5
described in *Note Theme Motifs: trunk Identity Themes Motifs.
4c79b5
4c79b5
3.11.4 See also
4c79b5
---------------
4c79b5
4c79b5
3.12 trunk/Identity/Themes/Models/Default/Distro
4c79b5
================================================
4c79b5
4c79b5
3.12.1 Goals
4c79b5
------------
4c79b5
4c79b5
   * ...
4c79b5
4c79b5
3.12.2 Description
4c79b5
------------------
4c79b5
4c79b5
It applies to all major releases of CentOS distribution.
4c79b5
4c79b5
3.12.2.1 One theme for all major releases
4c79b5
.........................................
4c79b5
4c79b5
Sometimes, specific visual manifestations are formed by common
4c79b5
components which have internal differences. That is the case of CentOS
4c79b5
distribution visual manifestation.
4c79b5
4c79b5
   Since a visual style point of view, the CentOS distributions share
4c79b5
common artwork components like Anaconda --to cover the CentOS
4c79b5
distribution installation--, BootUp --to cover the CentOS distribution
4c79b5
start up--, and Backgrounds --to cover the CentOS distribution
4c79b5
desktop--.  Now, since a technical point of view, those common artwork
4c79b5
components are made of software improved constantly.  So, we need to
4c79b5
find a way to keep one unique name and one unique visual style in
4c79b5
artwork components that have internal difference and also remark
4c79b5
internal difference as well.
4c79b5
4c79b5
     *Important* Remarking the CentOS release schema inside each major
4c79b5
     release of CentOS distribution --or similar visual manifestation--
4c79b5
     takes _high attention_ inside The CentOS Project corporate visual
4c79b5
     identity. It should be very clear for people which major release
4c79b5
     of CentOS distribution they are using.
4c79b5
4c79b5
   In order to remark the CentOS release schema, the CentOS Artwork SIG
4c79b5
uses a release-specific brand design named "The CentOS Release Brand".
4c79b5
The CentOS release brand is compossed by the CentOS logotype _and_ the
4c79b5
CentOS major release number (as specified in CentOS release schema
4c79b5
definition). In this solution, the CentOS release brand is set inside
4c79b5
all release-specific artworks (e.g., distribution, installation media,
4c79b5
etc.) in remarkable way.   The CentOS release brand is the design
4c79b5
component that lets us remark the CentOS release schema inside the
4c79b5
monolithic corporate visual identity structure we propose to use.
4c79b5
4c79b5
3.12.2.2 One theme for each major release
4c79b5
.........................................
4c79b5
4c79b5
Other way we've been using to remark CentOS release schema is applying
4c79b5
one unique theme for _each_ major release of CentOS distribution.  That
4c79b5
is, if we have 4 major releases of CentOS distribution, we need to
4c79b5
provide 4 different themes to cover each CentOS distribution available.
4c79b5
4c79b5
   Inside CentOS Artwork Repository, you can create many themes and that
4c79b5
is very convenient. But using one unique theme for _each_ major release
4c79b5
of CentOS distribution would bring visual isolation among
4c79b5
distributions, websites and promotion visual manifestations. If the
4c79b5
CentOS project would maintain just one CentOS distribution (and many
4c79b5
experienced graphic designers ready to create beautiful artworks) this
4c79b5
model would be nice. Indeed, this model looks quite similar to that one
4c79b5
used by Fedora project, doesn't it. But no, the CentOS project
4c79b5
maintains near to 4 major releases of CentOS distribution in parallel,
4c79b5
and that fact makes a huge difference since the corporate visual
4c79b5
identity point of view.
4c79b5
4c79b5
   If we use one unique theme for _each_ major release of CentOS
4c79b5
distribution, which one of those themes, does we use to cover other
4c79b5
CentOS visual manifestations, like websites and promotion stuff?
4c79b5
4c79b5
   In whatever case you choose some release-specific distribution user
4c79b5
will be visually isolated from other CentOS visual manifestations like
4c79b5
websites and promotion stuff, even if the CentOS brand is present in
4c79b5
all visual manifestations. In such a case, probably, users will end up
4c79b5
asking themselves, why my CentOS distribution has this design and the
4c79b5
CentOS website another one? Isn't them on the same project? With luck
4c79b5
the CentOS brand will exonerate user form visual isolation.
4c79b5
4c79b5
3.12.3 Usage
4c79b5
------------
4c79b5
4c79b5
3.12.4 See also
4c79b5
---------------
4c79b5
4c79b5
3.13 trunk/Identity/Themes/Models/Default/Distro/Anaconda
4c79b5
=========================================================
4c79b5
4c79b5
3.13.1 Goals
4c79b5
------------
4c79b5
4c79b5
   * ...
4c79b5
4c79b5
3.13.2 Description
4c79b5
------------------
4c79b5
4c79b5
3.13.3 Usage
4c79b5
------------
4c79b5
4c79b5
3.13.4 See also
4c79b5
---------------
4c79b5
4c79b5
3.14 trunk/Identity/Themes/Models/Default/Promo
4c79b5
===============================================
4c79b5
4c79b5
3.14.1 Goals
4c79b5
------------
4c79b5
4c79b5
   * ...
4c79b5
4c79b5
3.14.2 Description
4c79b5
------------------
4c79b5
4c79b5
It applies to all tangible and non tangible items CentOS uses to
4c79b5
promote its existence. Clothes, posters, installation media,
4c79b5
stationery, release countdown images, banners, stickers, are all
4c79b5
examples of promotion designs.
4c79b5
4c79b5
   * ...
4c79b5
4c79b5
3.14.3 Usage
4c79b5
------------
4c79b5
4c79b5
   * ...
4c79b5
4c79b5
3.14.4 See also
4c79b5
---------------
4c79b5
4c79b5
3.15 trunk/Identity/Themes/Models/Default/Web
4c79b5
=============================================
4c79b5
4c79b5
3.15.1 Goals
4c79b5
------------
4c79b5
4c79b5
   * ...
4c79b5
4c79b5
3.15.2 Description
4c79b5
------------------
4c79b5
4c79b5
It applies to all web applications CentOS uses to handle its needs (Ex.
4c79b5
Portals, Wikis, Forums, Blogs, Bug Tracker). Anything involving HTML
4c79b5
standards should be consider here.
4c79b5
4c79b5
   * ...
4c79b5
4c79b5
3.15.3 Usage
4c79b5
------------
4c79b5
4c79b5
   * ...
4c79b5
4c79b5
3.15.4 See also
4c79b5
---------------
4c79b5
4c79b5
3.16 trunk/Identity/Themes/Motifs
4c79b5
=================================
4c79b5
4c79b5
3.16.1 Goals
4c79b5
------------
4c79b5
4c79b5
The `trunk/Identity/Themes/Motifs' directory exists to:
4c79b5
4c79b5
   * Organize CentOS themes' artistic motifs.
4c79b5
4c79b5
3.16.2 Description
4c79b5
------------------
4c79b5
4c79b5
The artistic motif of theme is a graphic design component that provides
4c79b5
theme's visual style, it is used as pattern to connect all visual
4c79b5
manifestations inside one unique theme.
4c79b5
4c79b5
   Artistic motifs are based on conceptual ideas. Conceptual ideas bring
4c79b5
the motivation, they are fuel for the engines of human imagination.
4c79b5
Good conceptual ideas may produce good motivation to produce almost
4c79b5
anything, and art works don't escape from it.
4c79b5
4c79b5
`TreeFlower'
4c79b5
     CentOS like trees, has roots, trunk, branches, leaves and flowers.
4c79b5
     Day by day they work together in freedom, ruled by the laws of
4c79b5
     nature and open standards, to show the beauty of its existence.
4c79b5
4c79b5
`Modern'
4c79b5
     Modern, squares and circles flowing up.
4c79b5
4c79b5
   If you have new conceptual ideas for CentOS, then you can say that
4c79b5
you want to create a new artistic motif for CentOS. To create a new
4c79b5
artistic motif you need to create a directory under
4c79b5
`Identity/Themes/Motifs/' using a name coherent with your conceptual
4c79b5
idea. That name will be your artistic motif's name. If possible, when
4c79b5
creating new conceptual ideas for CentOS, think about what CentOS means
4c79b5
for you, what does it makes you feel, take your time, think deep, and
4c79b5
share; you can improve the idea as time goes on.
4c79b5
4c79b5
   Once you have defined a name for your theme, you need to create the
4c79b5
motif structure of your theme. The motif structure is the basic
4c79b5
direcotry structure you'll use to work your ideas. Here is where you
4c79b5
organize your graphic design projects.
4c79b5
4c79b5
   To add a new motif structure to CentOS Artwork Repository, you need
4c79b5
to use the `centos-art' command line in the `Identity/Themes/Motifs/'
4c79b5
directory as described below:
4c79b5
4c79b5
     centos-art add --motif=ThemeName
4c79b5
4c79b5
   The previous command will create the motif's basic structure for you.
4c79b5
The basic structure produced by `centos-art' command is illustrated in
4c79b5
the following figure:
4c79b5
4c79b5
     trunk/Identity/Themes/Motifs/$ThemeName/
4c79b5
     |-- Backgrounds
4c79b5
     |   |-- Img
4c79b5
     |   `-- Tpl
4c79b5
     |-- Info
4c79b5
     |   |-- Img
4c79b5
     |   `-- Tpl
4c79b5
     |-- Palettes
4c79b5
     `-- Screenshots
4c79b5
4c79b5
3.16.3 Usage
4c79b5
------------
4c79b5
4c79b5
When designing artistic motifs for CentOS, consider the following
4c79b5
recommendations:
4c79b5
4c79b5
   * Give a unique (case-sensitive) name to your Motif. This name is
4c79b5
     used as value wherever theme variable ($THEME) or translation
4c79b5
     marker (=THEME=) is.  Optionally, you can add a description about
4c79b5
     inspiration and concepts behind your work.
4c79b5
4c79b5
   * Use the location `trunk/Identity/Themes/Motifs/$THEME/' to store
4c79b5
     your work. If it doesn't exist create it. Note that this require
4c79b5
     you to have previous commit access in CentOS Artwork Repository.
4c79b5
4c79b5
   * The CentOS Project is using the blue color (#204c8d) as base for
4c79b5
     its corporate visual identity. Use the CentOS Project's base
4c79b5
     corporate color as much as possible in your artistic motif designs.
4c79b5
4c79b5
   * Try to make your design fit one of the theme models.
4c79b5
4c79b5
   * Feel free to make your art enterprise-level and beautiful.
4c79b5
4c79b5
   * Add the following information on your art work (both in a visible
4c79b5
     design area, and inside Inkscape's document metadata section
4c79b5
     wherever it be possible):
4c79b5
4c79b5
        * The name (or logo) of your artistic motif.
4c79b5
4c79b5
        * The copyright sentence: Copyright (C) YEAR YOURNAME
4c79b5
4c79b5
        * The license under which the work is released. All CentOS Art
4c79b5
          works are released under Creative Common Share-Alike License
4c79b5
          3.0 (http://creativecommons.org/licenses/by-sa/3.0/)
4c79b5
          (`http://creativecommons.org/licenses/by-sa/3.0/').
4c79b5
4c79b5
4c79b5
3.16.4 See also
4c79b5
---------------
4c79b5
4c79b5
3.17 trunk/Identity/Themes/Motifs/Modern/Backgrounds
4c79b5
====================================================
4c79b5
4c79b5
3.17.1 Goals
4c79b5
------------
4c79b5
4c79b5
   * Organize background images for Modern theme.
4c79b5
4c79b5
3.17.2 Description
4c79b5
------------------
4c79b5
4c79b5
Inside motif's `Backgrounds/' directory you can create vectorial
4c79b5
designs using Inkscape and background images using Gimp. Later, you can
4c79b5
export background images as `.png' and load them in your vectorial
4c79b5
design project using Inkscape's import feautre.
4c79b5
4c79b5
   You may need to repeat this technic for different screen resoluions.
4c79b5
In that case you need to create one file for each screen resolution and
4c79b5
do the appropriate linking inside .svg to .png files.  For example if
4c79b5
you need to produce background images in 800x600 you need to create the
4c79b5
following file:
4c79b5
4c79b5
     xcf/800x600.xcf
4c79b5
4c79b5
   to produce the background image:
4c79b5
4c79b5
     img/800x600-bg.png
4c79b5
4c79b5
   which is loaded in:
4c79b5
4c79b5
     svg/800x600.svg
4c79b5
4c79b5
   to produce the final background image:
4c79b5
4c79b5
     img/800x600.png
4c79b5
4c79b5
   The `img/800x600.png' background image is produced automatically by
4c79b5
means of rendering scripts.
4c79b5
4c79b5
   In other cases, like Anaconda's, it is possible that you need to make
4c79b5
some variations to one background image that don't want to appear on
4c79b5
regular background images of the same resolution. In this case you need
4c79b5
to create a new and specific background image for that art component.
4c79b5
For example, if you need to produce the background image used by
4c79b5
Anconda (800x600) art works you create the file:
4c79b5
4c79b5
     xcf/800x600-anaconda.xcf
4c79b5
4c79b5
   to produce the background image:
4c79b5
4c79b5
     img/800x600-anaconda-bg.png
4c79b5
4c79b5
   which is loaded in:
4c79b5
4c79b5
     svg/800x600-anaconda.svg
4c79b5
4c79b5
   to produce the file:
4c79b5
4c79b5
     img/800x600-anaconda.png
4c79b5
4c79b5
   The 800x600-anaconda.png file is used by all Anaconda art works
4c79b5
sharing a common 800x600 screen resolution (e.g., Header, Progress,
4c79b5
Splash, Firstboot, etc.). The Anaconda Prompt is indexed to 16 colors
4c79b5
and 640x480 pixels so you need to create a 640x480 background image for
4c79b5
it, and take the color limitation into account when designing it.
4c79b5
4c79b5
   Background images without artistic motif are generally used as based
4c79b5
to build the Background images that do contain the theme's artistic
4c79b5
motif.
4c79b5
4c79b5
   Background images are linked (using Inkscape's import feature)
4c79b5
inside almost all theme art works. This structure let you make
4c79b5
centralized changes on the visual identity and propagate them quickly
4c79b5
to other areas.
4c79b5
4c79b5
   In this structure you design background images for different screen
4c79b5
resolutions based on theme's artistic motif.
4c79b5
4c79b5
   You may create different artistic motifs propositions based on the
4c79b5
same conceptual idea. The conceptual idea is what defines a theme.
4c79b5
Artistic motifs are interpretations of that idea.
4c79b5
4c79b5
   Inside this directory artistic motifs are organized by name (e.g.,
4c79b5
TreeFlower, Modern, etc.).
4c79b5
4c79b5
   Inside each motif directories represent just one unique artistic
4c79b5
motif.
4c79b5
4c79b5
   The artistic motif is graphic design used as common pattern to
4c79b5
connect all visual manifestations inside one unique theme.  The
4c79b5
artistic motif is based on a conceptual idea.  Artistic motifs provide
4c79b5
visual style to themes.
4c79b5
4c79b5
   Designing artistic motifs is for anyone interested in creating
4c79b5
beautiful themes for CentOS.  When building a theme for CentOS, the
4c79b5
first design you need to define is the artistic motif.
4c79b5
4c79b5
   Inside CentOS Artwork Repository, theme visual styles (Motifs) and
4c79b5
theme visual structures (Models) are two different working lines.  When
4c79b5
you design an artistic motif for CentOS you concentrate on its visual
4c79b5
style, and eventualy, use the `centos-art' command line interface to
4c79b5
render the visual style, you are currently producing, against an
4c79b5
already-made theme model in order to produce the final result.  Final
4c79b5
images are stored under the motif's name directory using the model
4c79b5
directory structure as reference.
4c79b5
4c79b5
   The artistic motif base structure is used by `centos-art' to produce
4c79b5
images automatically. This section describes each directory of CentOS
4c79b5
artistic motif base structure.
4c79b5
4c79b5
3.17.3 Usage
4c79b5
------------
4c79b5
4c79b5
The motif's `Backgrounds/' directory is probably the motif's core
4c79b5
component.  Inside motif's `Backgrounds/' directory you produce
4c79b5
background images used by almost all theme models (e.g., Distribution,
4c79b5
Websites, Promotion, etc.).  The motif's `Backgrounds/' directory can
4c79b5
contain subdirectories to help you organize the design process.
4c79b5
4c79b5
3.17.4 See also
4c79b5
---------------
4c79b5
4c79b5
3.18 trunk/Identity/Themes/Motifs/Modern/Backgrounds/Img
4c79b5
========================================================
4c79b5
4c79b5
3.18.1 Goals
4c79b5
------------
4c79b5
4c79b5
   * ...
4c79b5
4c79b5
3.18.2 Description
4c79b5
------------------
4c79b5
4c79b5
3.18.3 Usage
4c79b5
------------
4c79b5
4c79b5
In this directory is where you store all background images (e.g., .png,
4c79b5
.jpg, .xpm, etc.).  This directory is required by `centos-art' command
4c79b5
line interface.
4c79b5
4c79b5
3.18.4 See also
4c79b5
---------------
4c79b5
4c79b5
3.19 trunk/Identity/Themes/Motifs/Modern/Backgrounds/Tpl
4c79b5
========================================================
4c79b5
4c79b5
3.19.1 Goals
4c79b5
------------
4c79b5
4c79b5
   * ...
4c79b5
4c79b5
3.19.2 Description
4c79b5
------------------
4c79b5
4c79b5
3.19.3 Usage
4c79b5
------------
4c79b5
4c79b5
In this directory is where you store all the scalable vector graphics
4c79b5
(e.g., .svg) files. This directory is required by `centos-art' command
4c79b5
line interface.
4c79b5
4c79b5
3.19.4 See also
4c79b5
---------------
4c79b5
4c79b5
3.20 trunk/Identity/Themes/Motifs/Modern/Backgrounds/Xcf
4c79b5
========================================================
4c79b5
4c79b5
3.20.1 Goals
4c79b5
------------
4c79b5
4c79b5
   * ...
4c79b5
4c79b5
3.20.2 Description
4c79b5
------------------
4c79b5
4c79b5
   * ...
4c79b5
4c79b5
3.20.3 Usage
4c79b5
------------
4c79b5
4c79b5
In this directory is where you store Gimp's project files (e.g, .xcf).
4c79b5
This directory is not required by `centos-art' command line interface.
4c79b5
If you can create a beautiful background images using scalable vector
4c79b5
graphics only, then there is no need to use the `Xcf/' directory to
4c79b5
store Gimp's background projects. Of course, you can merge Gimp's power
4c79b5
with Inkscape's power to produce images based on them.  In this last
4c79b5
case you need the `Xcf/' directory.
4c79b5
4c79b5
3.20.4 See also
4c79b5
---------------
4c79b5
4c79b5
3.21 trunk/Identity/Themes/Motifs/Modern/Distro/Anaconda/Progress
4c79b5
=================================================================
4c79b5
4c79b5
3.21.1 Goals
4c79b5
------------
4c79b5
4c79b5
   * ...
4c79b5
4c79b5
3.21.2 Description
4c79b5
------------------
4c79b5
4c79b5
3.21.3 Usage
4c79b5
------------
4c79b5
4c79b5
To render Anaconda progress slide images using the Modern's artistic
4c79b5
motif design, the Default theme model, and available translation files
4c79b5
(*note trunk Translations Identity Themes Distro Anaconda Progress::);
4c79b5
use the following commands:
4c79b5
4c79b5
     cd /home/centos/artwork/trunk/Identity/Themes/Motifs/Modern/Distro/Anaconda/Progress/
4c79b5
     centos-art render --identity
4c79b5
4c79b5
   The above command will create the following structure:
4c79b5
4c79b5
     trunk/Identity/Themes/Motifs/Modern/Distro/Anaconda/Progress
4c79b5
     |-- 3
4c79b5
     |   |-- en
4c79b5
     |   |   |-- 01-welcome.png
4c79b5
     |   |   |-- 02-donate.png
4c79b5
     |   |   `-- 03-yum.png
4c79b5
     |   `-- es
4c79b5
     |       |-- 01-welcome.png
4c79b5
     |       |-- 02-donate.png
4c79b5
     |       `-- 03-yum.png
4c79b5
     |-- 4
4c79b5
     |   |-- en
4c79b5
     |   |   |-- 01-welcome.png
4c79b5
     |   |   |-- 02-donate.png
4c79b5
     |   |   `-- 03-yum.png
4c79b5
     |   `-- es
4c79b5
     |       |-- 01-welcome.png
4c79b5
     |       |-- 02-donate.png
4c79b5
     |       `-- 03-yum.png
4c79b5
     `-- 5
4c79b5
         |-- en
4c79b5
         |   |-- 01-welcome.png
4c79b5
         |   |-- 02-donate.png
4c79b5
         |   `-- 03-yum.png
4c79b5
         `-- es
4c79b5
             |-- 01-welcome.png
4c79b5
             |-- 02-donate.png
4c79b5
             `-- 03-yum.png
4c79b5
4c79b5
3.21.4 See also
4c79b5
---------------
4c79b5
4c79b5
3.22 trunk/Identity/Themes/Motifs/Modern/Palettes
4c79b5
=================================================
4c79b5
4c79b5
3.22.1 Goals
4c79b5
------------
4c79b5
4c79b5
   * Organize palette files for Modern theme.
4c79b5
4c79b5
3.22.2 Description
4c79b5
------------------
4c79b5
4c79b5
3.22.3 Usage
4c79b5
------------
4c79b5
4c79b5
Here is where graphic designers define theme palettes for color-limited
4c79b5
art works. Theme palettes contain the color information that rendering
4c79b5
functions need, in order to produce images with color limitations.
4c79b5
Theme palettes contain theme's unique color information.
4c79b5
4c79b5
3.22.4 See also
4c79b5
---------------
4c79b5
4c79b5
3.23 trunk/Identity/Themes/Motifs/TreeFlower
4c79b5
============================================
4c79b5
4c79b5
3.23.1 Goals
4c79b5
------------
4c79b5
4c79b5
   * ...
4c79b5
4c79b5
3.23.2 Description
4c79b5
------------------
4c79b5
4c79b5
3.23.3 Usage
4c79b5
------------
4c79b5
4c79b5
3.23.4 See also
4c79b5
---------------
4c79b5
4c79b5
3.24 trunk/Identity/Widgets
4c79b5
===========================
4c79b5
4c79b5
3.24.1 Goals
4c79b5
------------
4c79b5
4c79b5
   * ...
4c79b5
4c79b5
3.24.2 Description
4c79b5
------------------
4c79b5
4c79b5
3.24.3 Usage
4c79b5
------------
4c79b5
4c79b5
3.24.4 See also
4c79b5
---------------
4c79b5
4c79b5
3.25 trunk/Manuals
4c79b5
==================
4c79b5
4c79b5
3.25.1 Goals
4c79b5
------------
4c79b5
4c79b5
   * ...
4c79b5
4c79b5
3.25.2 Description
4c79b5
------------------
4c79b5
4c79b5
   * ...
4c79b5
4c79b5
3.25.3 Usage
4c79b5
------------
4c79b5
4c79b5
`centos-art help 'path/to/dir''
4c79b5
     Use this command to read directory documentation specified in
4c79b5
     `path/to/dir'.
4c79b5
4c79b5
`centos-art help 'path/to/dir' --read='filename''
4c79b5
     Use this command to read file documentation as specified by
4c79b5
     `path/to/dir/filename' combination.
4c79b5
4c79b5
`centos-art help 'path/to/dir' --edit'
4c79b5
     Use this command to edit directory documentation as specified in
4c79b5
     `path/to/dir'.
4c79b5
4c79b5
`centos-art help 'path/to/dir' --edit='filename''
4c79b5
     Use this command to edit file documentation as specified in
4c79b5
     `path/to/dir/filename' combination.
4c79b5
4c79b5
`centos-art help 'path/to/dir' --update'
4c79b5
     Use this command to update documentation output files.
4c79b5
4c79b5
`centos-art help 'path/to/dir' --remove'
4c79b5
     Use this command to remove directory documentation as specified in
4c79b5
     `path/to/dir'.
4c79b5
4c79b5
          *Caution* When directory documentation is removed all
4c79b5
          documentation under it is also removed.
4c79b5
4c79b5
          *Tip* To recover from directory documentation lost, try the
4c79b5
          following command (before commit local changes up to central
4c79b5
          repository):
4c79b5
          svn revert path/to/dir --recursive
4c79b5
4c79b5
`centos-art help 'path/to/dir' --remove='filename''
4c79b5
     Use this command to remove file documentation as specified in
4c79b5
     `path/to/dir/filename' combination.
4c79b5
4c79b5
3.25.4 See also
4c79b5
---------------
4c79b5
4c79b5
3.26 trunk/Scripts
4c79b5
==================
4c79b5
4c79b5
3.26.1 Goals
4c79b5
------------
4c79b5
4c79b5
The `trunk/Scripts' directory exists to:
4c79b5
4c79b5
   * Organize the "trunk" development line of automation scripts by
4c79b5
     programming language.
4c79b5
4c79b5
3.26.2 Description
4c79b5
------------------
4c79b5
4c79b5
   * ...
4c79b5
4c79b5
3.26.3 Usage
4c79b5
------------
4c79b5
4c79b5
   * ...
4c79b5
4c79b5
3.26.4 See also
4c79b5
---------------
4c79b5
4c79b5
3.27 trunk/Scripts/Bash
4c79b5
=======================
4c79b5
4c79b5
3.27.1 Goals
4c79b5
------------
4c79b5
4c79b5
The `trunk/Scripts/Bash' directory exists to organize the "trunk"
4c79b5
development line of `centos-art.sh' automation script.  The
4c79b5
`centos-art.sh' script standardize frequent tasks inside your working
4c79b5
copy of CentOS Artwork Repository.
4c79b5
4c79b5
3.27.2 Description
4c79b5
------------------
4c79b5
4c79b5
The best way to understand `centos-art.sh' automation script is
4c79b5
studying its source code. The `centos-art.sh' script is splited in
4c79b5
several configuration and function files which are loaded when the
4c79b5
`centos-art.sh' script is executed. This section describes the order in
4c79b5
which `centos-art.sh' loads its configuration and function files.
4c79b5
4c79b5
   When you type the `centos-art' command in your terminal, the
4c79b5
operating system trys to execute that command. In order to execute the
4c79b5
command, the operating system needs to know where it is, so the
4c79b5
operating system uses the PATH environment variable to look for that
4c79b5
command's location. If your system was prepared to use CentOS Artwork
4c79b5
Repository correctly (see usage section above), you should have a
4c79b5
symbolic link inside `~/bin/' directory that points to the
4c79b5
`centos-art.sh' script file. As `~/bin/' directory is, by default,
4c79b5
inside PATH environment variable, the execution of `centos-art' command
4c79b5
runs the `centos-art.sh' script.
4c79b5
4c79b5
   When `centos-art.sh' script is executed, the first it does is
4c79b5
execute the `trunk/Scripts/Bash/initFunctions.sh' file to initialize
4c79b5
`gettext' variables and all function scripts inside
4c79b5
`trunk/Scripts/Bash/Functions' directory.
4c79b5
4c79b5
   Once `gettext' variables and all function scripts have been
4c79b5
initialized, the `centos-art.sh' script initializes its environment
4c79b5
variables using the `cli_getVariables' function.  At this point the
4c79b5
`centos-art.sh' script calls the `cli_getActions' function from
4c79b5
`cli_getVariables' function's bottom.
4c79b5
4c79b5
   The `cli_getActions' function defines which actions the
4c79b5
`centos-art.sh' script is able to perform. Inside `cli_getActions'
4c79b5
function, actions are defined combining positional arguments and
4c79b5
function calls.
4c79b5
4c79b5
4c79b5
+------------------------------------------------------------------+
4c79b5
| [centos@host]$ centos-art action 'path/to/dir' --option='value'  |
4c79b5
+------------------------------------------------------------------+
4c79b5
| ~/bin/centos-art --> ~/artwork/trunk/Scripts/Bash/centos-art.sh  |
4c79b5
+---v-----------------------------------------v--------------------+
4c79b5
    | centos-art.sh                           |
4c79b5
    +---v---------------------------------v---+
4c79b5
    .   | initFunctions.sh                |   .
4c79b5
    .   +---------------------------------+   .
4c79b5
    .   | cli_getVariables $@             |   .
4c79b5
    .   +---v-------------------------v---+   .
4c79b5
    .   .   | cli_getActions          |   .   .
4c79b5
    .   .   +---v-----------------v---+   .   .
4c79b5
    .   .   .   | function call 1 |   .   .   .
4c79b5
    .   .   .   | function call 2 |   .   .   .
4c79b5
    .   .   .   | function call n |   .   .   .
4c79b5
    .   .   .   +-----------------+   .   .   .
4c79b5
    .   .   ...........................   .   .
4c79b5
    .   ...................................   .
4c79b5
    ...........................................
4c79b5
4c79b5
Figure 3.1: The `centos-art.sh' initialization environment.
4c79b5
4c79b5
3.27.2.1 The identity matching list
4c79b5
...................................
4c79b5
4c79b5
The identity matching list is used by identity rendering functions to
4c79b5
define the relation between translation files and identity design
4c79b5
templates. *Note trunk Scripts Bash Functions Config
4c79b5
cli_getIdentityMatchinglist.sh::, for more information.
4c79b5
4c79b5
3.27.2.2 Adding new features
4c79b5
............................
4c79b5
4c79b5
To add new features inside `centos-art.sh' script, you need to set
4c79b5
positional arguments and function calls inside `cli_getActions'
4c79b5
function for the new function or functions required by the new feature
4c79b5
you want to add.
4c79b5
4c79b5
3.27.3 Usage
4c79b5
------------
4c79b5
4c79b5
3.27.3.1 The `centos-art' `check' action
4c79b5
........................................
4c79b5
4c79b5
This feature is supported through the following command:
4c79b5
4c79b5
`centos-art check'
4c79b5
     This command verifies paths, symbolic links, installed packages and
4c79b5
     everything your workstation needs in order to run the `centos-art'
4c79b5
     command correctly.
4c79b5
4c79b5
          *Warning* If this is the first time you run `centos-art'
4c79b5
          command, the appropriate way to execute check action is not
4c79b5
          using the `centos-art' command, but the absolute path to
4c79b5
          `centos-art.sh' script instead:
4c79b5
          ~/artwork/trunk/Scripts/Bash/centos-art.sh check
4c79b5
4c79b5
3.27.3.2 The `centos-art' `search' action
4c79b5
.........................................
4c79b5
4c79b5
This feature is not supported yet.
4c79b5
4c79b5
`centos-art search 'pattern''
4c79b5
     Use this command to find directories and files that match exactly
4c79b5
     the posix-regular expression set in `pattern' as in `^pattern$'.
4c79b5
4c79b5
`centos-art search 'pattern1 pattern2 patternN''
4c79b5
     Use this command to search repository entries that match pattern1
4c79b5
     _or_ patter2 _or_ patternN as in
4c79b5
     `'^.*(pattern1|pattern2|patternN).*$''.
4c79b5
4c79b5
`centos-art search 'path/to/dir1 path/to/dir2 path/to/dirN''
4c79b5
     Use this command to search repository entries that match
4c79b5
     `path/to/dir1' _or_ `path/to/dir2', _or_ `path/to/dirN' as in
4c79b5
     `^.*(path/to/dir1|path/to/dir2|path/to/dirN).*$''.
4c79b5
4c79b5
4c79b5
3.27.3.3 The `centos-art' `path' action
4c79b5
.......................................
4c79b5
4c79b5
This feature is not supported yet.
4c79b5
4c79b5
`centos-art path 'path/to/dir/' --copy-to='path/to/dir''
4c79b5
4c79b5
`centos-art path 'path/to/dir/' --copy-to='path/to/dir/filename''
4c79b5
4c79b5
`centos-art path 'path/to/dir/' --move-to='path/to/dir''
4c79b5
4c79b5
`centos-art path 'path/to/dir/' --move-to='path/to/dir/filename''
4c79b5
4c79b5
`centos-art path 'path/to/dir/' --remove'
4c79b5
4c79b5
3.27.3.4 The `centos-art' `locale-art' action
4c79b5
.............................................
4c79b5
4c79b5
This feature is not supported yet.
4c79b5
4c79b5
`centos-art locale-art 'path/to/dir' --edit'
4c79b5
4c79b5
`centos-art locale-art 'path/to/dir' --edit='filename''
4c79b5
4c79b5
`centos-art locale-art 'path/to/dir' --list'
4c79b5
4c79b5
`centos-art locale-art 'path/to/dir' --list='filename''
4c79b5
4c79b5
3.27.3.5 The `centos-art' `license' action
4c79b5
..........................................
4c79b5
4c79b5
This feature is supported through the following command:
4c79b5
4c79b5
`centos-art license'
4c79b5
     Use this command to see a brief description of `centos-art'
4c79b5
     command its copyright and its license notes.
4c79b5
4c79b5
3.27.4 See also
4c79b5
---------------
4c79b5
4c79b5
3.28 trunk/Scripts/Bash/Config
4c79b5
==============================
4c79b5
4c79b5
3.28.1 Goals
4c79b5
------------
4c79b5
4c79b5
The `trunk/Scripts/Bash/Config' directory exists to oraganize
4c79b5
pre-rendering configuration scripts.
4c79b5
4c79b5
3.28.2 Description
4c79b5
------------------
4c79b5
4c79b5
Pre-rendering configuration scripts let you customize the way
4c79b5
`centos-art.sh' script renders identity and translation repository
4c79b5
entries.  Pre-rendering configuration scripts are `render.conf.sh'
4c79b5
files with `loadConfiguration' function definition inside.
4c79b5
4c79b5
   There is one `render.conf.sh' file for each pre-rendering
4c79b5
configuration entry. Pre-rendering configuration entries can be based
4c79b5
both on identity and translation repository entires.  Pre-rendering
4c79b5
configuration entries are required for each identity entry, but not for
4c79b5
translation entries.
4c79b5
4c79b5
3.28.2.1 The `render.conf.sh' identity model
4c79b5
............................................
4c79b5
4c79b5
Inside CentOS Artwork Repository, we consider directories under
4c79b5
`trunk/Identity' as identity entries. Identity entries can be
4c79b5
image-based or text-based. When you render image-based identity entries
4c79b5
you need to use image-based pre-rendering configuration scripts.
4c79b5
Likewise, when you render text-based identity entries you need to use
4c79b5
text-based pre-rendering configuration scripts.
4c79b5
4c79b5
   Inside both image-based and text-based identity pre-rendering
4c79b5
configuration scripts, we use the `ACTIONS' array variable to define
4c79b5
the way `centos-art.sh' script performs identity rendering. The first
4c79b5
entry inside `ACTIONS' array variable (i.e., `ACTIONS[0]') is reserved
4c79b5
to define the primary rendering action (i.e, `renderImage' or
4c79b5
`renderText').  Further entries inside `ACTIONS' (i.e., `ACTIONS[1]',
4c79b5
`ACTIONS[2]', etc.) are used to define identity post-rendering actions.
4c79b5
4c79b5
   Inside identity pre-rendering configuration scripts, image-based
4c79b5
pre-rendering configuration scripts look like the following:
4c79b5
4c79b5
4c79b5
#!/bin/bash
4c79b5
4c79b5
function loadConfiguration {
4c79b5
4c79b5
    # Define post-rendering actions. An empty value means that no
4c79b5
    # post-rendering action is applied.
4c79b5
    ACTIONS[0]='renderImage'
4c79b5
    ACTIONS[1]='renderFormats: tif xpm pdf ppm'
4c79b5
4c79b5
}
4c79b5
4c79b5
   Inside identity pre-rendering configuration scripts, text-based
4c79b5
pre-rendering configuration scripts look like the following:
4c79b5
4c79b5
4c79b5
#!/bin/bash
4c79b5
4c79b5
function loadConfiguration {
4c79b5
4c79b5
    # Define post-rendering actions. An empty value means that no
4c79b5
    # post-rendering action is applied.
4c79b5
    ACTIONS[0]='renderText'
4c79b5
    ACTIONS[1]='formatText: --width=70 --uniform-spacing'
4c79b5
4c79b5
}
4c79b5
4c79b5
   When using identity pre-rendering configuration scripts, you can
4c79b5
extend both image-based and text-based pre-rendering configuration
4c79b5
scripts using image-based and text-based post-rendering actions,
4c79b5
respectively.
4c79b5
4c79b5
3.28.2.2 The `render.conf.sh' translation model
4c79b5
...............................................
4c79b5
4c79b5
Translation pre-rendering configuration scripts take precedence before
4c79b5
default translation rendering action. Translation pre-rendering actions
4c79b5
are useful when default translation rendering action do not fit itself
4c79b5
to translation entry rendering requirements.
4c79b5
4c79b5
3.28.3 Usage
4c79b5
------------
4c79b5
4c79b5
Use the following commands to administer both identity and translation
4c79b5
pre-rendering configuration scripts:
4c79b5
4c79b5
`centos-art config 'path/to/dir/' --create'
4c79b5
     Use this command to create `path/to/dir' related pre-rendering
4c79b5
     configuration script.
4c79b5
4c79b5
`centos-art config 'path/to/dir/' --edit'
4c79b5
     Use this command to edit `path/to/dir' related pre-rendering
4c79b5
     configuration script.
4c79b5
4c79b5
`centos-art config 'path/to/dir/' --read'
4c79b5
     Use this command to read `path/to/dir' related pre-rendering
4c79b5
     configuration script.
4c79b5
4c79b5
`centos-art config 'path/to/dir/' --remove'
4c79b5
     Use this command to remove `path/to/dir' related pre-rendering
4c79b5
     configuration script.
4c79b5
4c79b5
4c79b5
   In the commands above, `path/to/dir' refers to one renderable
4c79b5
directory path under `trunk/Identity' or `trunk/Translations'
4c79b5
structures only.
4c79b5
4c79b5
3.28.4 See also
4c79b5
---------------
4c79b5
4c79b5
3.29 trunk/Scripts/Bash/Config/Identity
4c79b5
=======================================
4c79b5
4c79b5
3.29.1 Goals
4c79b5
------------
4c79b5
4c79b5
   * ...
4c79b5
4c79b5
3.29.2 Description
4c79b5
------------------
4c79b5
4c79b5
   * ...
4c79b5
4c79b5
3.29.3 Usage
4c79b5
------------
4c79b5
4c79b5
   * ...
4c79b5
4c79b5
3.29.4 See also
4c79b5
---------------
4c79b5
4c79b5
3.30 trunk/Scripts/Bash/Config/Translations
4c79b5
===========================================
4c79b5
4c79b5
3.30.1 Goals
4c79b5
------------
4c79b5
4c79b5
   * ...
4c79b5
4c79b5
3.30.2 Description
4c79b5
------------------
4c79b5
4c79b5
   * ...
4c79b5
4c79b5
3.30.3 Usage
4c79b5
------------
4c79b5
4c79b5
   * ...
4c79b5
4c79b5
3.30.4 See also
4c79b5
---------------
4c79b5
4c79b5
3.31 trunk/Scripts/Bash/Functions
4c79b5
=================================
4c79b5
4c79b5
3.31.1 Goals
4c79b5
------------
4c79b5
4c79b5
   * ...
4c79b5
4c79b5
3.31.2 Description
4c79b5
------------------
4c79b5
4c79b5
   * ...
4c79b5
4c79b5
3.31.3 Usage
4c79b5
------------
4c79b5
4c79b5
   * ...
4c79b5
4c79b5
3.31.4 See also
4c79b5
---------------
4c79b5
4c79b5
3.32 trunk/Scripts/Bash/Functions/Config
4c79b5
========================================
4c79b5
300762
     *Redirection* The content of this page was moved. *Note trunk
300762
     Scripts Bash Functions Render Config::, instead.
300762
300762
3.33 trunk/Scripts/Bash/Functions/Config/cli_getActionsIdentity.sh
300762
==================================================================
300762
300762
     *Redirection* The content of this page was moved. *Note trunk
300762
     Scripts Bash Functions Render render_getActionsIdentity.sh::,
300762
     instead.
300762
300762
3.34 trunk/Scripts/Bash/Functions/Config/cli_getActions.sh
300762
==========================================================
300762
300762
     *Redirection* The content of this page was moved. *Note trunk
300762
     Scripts Bash Functions Render render_getActions.sh::, instead.
300762
300762
3.35 trunk/Scripts/Bash/Functions/Config/cli_getActionsTranslations.sh
300762
======================================================================
300762
300762
     *Redirection* The content of this page was moved. *Note trunk
300762
     Scripts Bash Functions Render render_getActionsTranslations.sh::,
300762
     instead.
300762
300762
3.36 trunk/Scripts/Bash/Functions/Config/cli_getIdentityMatchinglist.sh
300762
=======================================================================
300762
300762
     *Removed* The content of this page was removed. Use the following
300762
     command to search what you need:
300762
300762
300762
     centos-art help --search --filter='your search pattern'
300762
300762
3.37 trunk/Scripts/Bash/Functions/Config/repo_renderIdentitySyslinux.sh
300762
=======================================================================
300762
300762
3.37.1 Goals
4c79b5
------------
4c79b5
4c79b5
   * ...
4c79b5
300762
3.37.2 Description
4c79b5
------------------
4c79b5
4c79b5
   * ...
4c79b5
300762
3.37.3 Usage
4c79b5
------------
4c79b5
4c79b5
   * ...
4c79b5
300762
3.37.4 See also
4c79b5
---------------
4c79b5
300762
3.38 trunk/Scripts/Bash/Functions/Prepare/prepare_forUsingPackages.sh
300762
=====================================================================
4c79b5
300762
3.38.1 Goals
4c79b5
------------
4c79b5
4c79b5
   * ...
4c79b5
300762
3.38.2 Description
4c79b5
------------------
4c79b5
4c79b5
   * ...
4c79b5
300762
3.38.3 Usage
4c79b5
------------
4c79b5
4c79b5
   * ...
4c79b5
300762
3.38.4 See also
4c79b5
---------------
4c79b5
300762
3.39 trunk/Scripts/Bash/Functions/Render/Config
300762
===============================================
4c79b5
300762
3.39.1 Goals
4c79b5
------------
4c79b5
4c79b5
   * ...
4c79b5
300762
3.39.2 Description
4c79b5
------------------
4c79b5
4c79b5
   * ...
4c79b5
300762
3.39.3 Usage
4c79b5
------------
4c79b5
4c79b5
   * ...
4c79b5
300762
3.39.4 See also
4c79b5
---------------
4c79b5
300762
3.40 trunk/Scripts/Bash/Functions/Render/render_getActionsIdentity.sh
300762
=====================================================================
4c79b5
300762
3.40.1 Goals
4c79b5
------------
4c79b5
4c79b5
   * ...
4c79b5
300762
3.40.2 Description
4c79b5
------------------
4c79b5
4c79b5
   * ...
4c79b5
300762
3.40.3 Usage
4c79b5
------------
4c79b5
4c79b5
   * ...
4c79b5
300762
3.40.4 See also
4c79b5
---------------
4c79b5
300762
3.41 trunk/Scripts/Bash/Functions/Render/render_getActions.sh
300762
=============================================================
4c79b5
300762
3.41.1 Goals
4c79b5
------------
4c79b5
4c79b5
   * ...
4c79b5
300762
3.41.2 Description
4c79b5
------------------
4c79b5
4c79b5
   * ...
4c79b5
300762
3.41.3 Usage
4c79b5
------------
4c79b5
4c79b5
   * ...
4c79b5
300762
3.41.4 See also
4c79b5
---------------
4c79b5
300762
3.42 trunk/Scripts/Bash/Functions/Render/render_getActionsTranslations.sh
300762
=========================================================================
4c79b5
300762
3.42.1 Goals
4c79b5
------------
4c79b5
4c79b5
   * ...
4c79b5
300762
3.42.2 Description
4c79b5
------------------
4c79b5
4c79b5
   * ...
4c79b5
300762
3.42.3 Usage
4c79b5
------------
4c79b5
4c79b5
   * ...
4c79b5
300762
3.42.4 See also
4c79b5
---------------
4c79b5
300762
3.43 trunk/Scripts/Bash/Locale
4c79b5
==============================
4c79b5
300762
3.43.1 Goals
4c79b5
------------
4c79b5
4c79b5
   * Organize `centos-art.sh' locale files.
4c79b5
300762
3.43.2 Description
4c79b5
------------------
4c79b5
4c79b5
This command looks for `.sh' files inside Bash directory and extracts
4c79b5
translatable strings from files, using `xgettext' command, in order to
4c79b5
create a portable object template (`centos-art.sh.pot') file for them.
4c79b5
4c79b5
   With the `centos-art.sh.pot' file up to date, the `centos-art'
4c79b5
command removes the temporal list of files sotred inside `/tmp'
4c79b5
directory and checks the current language of your user's session to
4c79b5
create a portable object file for it, in the location
4c79b5
`$CLI_LANG/$CLI_LANG.po'.
4c79b5
4c79b5
   The CLI_LANG variable discribes the locale language used to output
4c79b5
messages inside `centos-art' command. The locale language used inside
4c79b5
`centos-art' command is taken from the LANG environment variable.  The
4c79b5
CLI_LANG variable has the `LL_CC' format, where `LL' is a language code
4c79b5
from the ISO-639 standard, and `CC' a country code from the ISO-3166
4c79b5
standard.
4c79b5
4c79b5
   The LANG environment variable is set when you do log in to your
4c79b5
system. If you are using a graphical session, change language to your
4c79b5
native language and do login. That would set and exoprt the LANG
4c79b5
environment variable to the correct value. On the other side, if you
4c79b5
are using a text session edit your `~/.bash_profile' file to set and
4c79b5
export the LANG environment variable to your native locale as defines
4c79b5
the `locale -a' command output; do logout, and do login again.
4c79b5
4c79b5
   At this point, the LANG environment variable has the appropriate
4c79b5
value you need, in order to translate `centos-art.sh' messages to your
4c79b5
native language (the one set in LANG environment variable).
4c79b5
4c79b5
   With the `$CLI_LANG/$CLI_LANG.po' file up to date, the `centos-art'
4c79b5
opens it for you to update translation strings.  The `centos-art'
4c79b5
command uses the value of EDITOR environment variable to determine your
4c79b5
favorite text editor. If no value is defined on EDITOR, the
4c79b5
`/usr/bin/vim' text editor is used as default.
4c79b5
4c79b5
   When you finish PO file's edition and quit text editor, the
4c79b5
`centos-art' command creates the related machine object in the location
4c79b5
`$CLI_LANG/LC_MESSAGES/$TEXTDOMAIN.mo'.
4c79b5
4c79b5
   At this point, all translations you made in the PO file should be
4c79b5
available to your language when runing `centos-art.sh' script.
4c79b5
300762
3.43.2.1 Configuration files
4c79b5
............................
4c79b5
4c79b5
In order to make the `centos-art.sh' internationalization, the
4c79b5
`centos-art.sh' script was modified as described in the `gettext' info
4c79b5
documentation (`info gettext').  You can find such modifications in the
4c79b5
following files:
4c79b5
4c79b5
   * `trunk/Scripts/Bash/initFunctions.sh'
4c79b5
4c79b5
   * `trunk/Scripts/Bash/Functions/Config/cli_localeMessages.sh'
4c79b5
4c79b5
   * `trunk/Scripts/Bash/Functions/Config/cli_localeMessagesStatus.sh'
4c79b5
300762
3.43.3 Usage
4c79b5
------------
4c79b5
300762
3.43.3.1 The `centos-art' `locale-cli' action
4c79b5
.............................................
4c79b5
4c79b5
`centos-art locale-cli --edit'
4c79b5
     Use this command to translate command-line interface output
4c79b5
     messages in the current system locale you are using (as specified
4c79b5
     in LANG environment variable).
4c79b5
4c79b5
`centos-art locale-cli --list'
4c79b5
     Use this command to see the command-line interface locale report.
4c79b5
300762
3.43.4 See also
4c79b5
---------------
4c79b5
300762
3.44 trunk/Scripts/Perl
4c79b5
=======================
4c79b5
300762
3.44.1 Goals
4c79b5
------------
4c79b5
4c79b5
   * ...
4c79b5
300762
3.44.2 Description
4c79b5
------------------
4c79b5
300762
3.44.3 Usage
4c79b5
------------
4c79b5
300762
3.44.4 See also
4c79b5
---------------
4c79b5
300762
3.45 trunk/Scripts/Python
4c79b5
=========================
4c79b5
300762
3.45.1 Goals
4c79b5
------------
4c79b5
4c79b5
   * ...
4c79b5
300762
3.45.2 Description
4c79b5
------------------
4c79b5
4c79b5
   * ...
4c79b5
300762
3.45.3 Usage
4c79b5
------------
4c79b5
4c79b5
   * ...
4c79b5
300762
3.45.4 See also
4c79b5
---------------
4c79b5
300762
3.46 trunk/Translations
4c79b5
=======================
4c79b5
300762
3.46.1 Goals
4c79b5
------------
4c79b5
4c79b5
The `trunk/Translations' directory exists to:
4c79b5
4c79b5
   * Organize translation files.
4c79b5
4c79b5
   * Organize translation templates used to produce translation files.
4c79b5
300762
3.46.2 Description
4c79b5
------------------
4c79b5
4c79b5
When you create artwork for CentOS distribution you find that some
4c79b5
artworks need to be created for different major releases of CentOS
4c79b5
distribution and inside each major release they need to be created for
4c79b5
different locales. To get an approximate idea of how many files we are
4c79b5
talking about, consider the followig approximate statistic:
4c79b5
4c79b5
   * Inside CentOS distribution, there are around 30 images to
4c79b5
     rebrand.(1)
4c79b5
4c79b5
   * There are near to four major releases of CentOS distribution to
4c79b5
     rebrand in parallel development.(2)
4c79b5
4c79b5
   * Each CentOS distribution in parallel development supports more
4c79b5
     than two hundreds locales.(3)
4c79b5
4c79b5
   In order to aliviate maintainance of artwork production for such
4c79b5
environment, we divided artwork production in three production lines:
4c79b5
4c79b5
  1. *Note trunk Identity Themes Models::, to define artworks
4c79b5
     characteristics (e.g., dimensions, position on the screen, etc.).
4c79b5
4c79b5
  2. *Note trunk Identity Themes Motifs::, to define artworks visual
4c79b5
     styles (e.g., the look and feel).
4c79b5
4c79b5
  3. Translations, to define which major releases and locales artworks
4c79b5
     are produced for.
4c79b5
4c79b5
   Inside CentOS Artwork Repository, the artworks' translation
4c79b5
production line is stored under `trunk/Translations' directory.
4c79b5
4c79b5
   Inside `trunk/Translations' directory, we use "translation entries"
4c79b5
to organize artworks' "translation files" and artworks' "translation
4c79b5
templates".
4c79b5
300762
3.46.2.1 Translation Entries
4c79b5
............................
4c79b5
4c79b5
Translation entries exists for each artwork you want to produce.
4c79b5
Translation entries can be empty directories, or directories containing
4c79b5
translation files and translation templates.
4c79b5
4c79b5
   When translation entries are empty directories, the identity entry is
4c79b5
used as reference to create file names and directories layout for
4c79b5
rendered files.  In this case, the `centos-art' script takes one design
4c79b5
template and outputs one non-translated file for each design template
4c79b5
available.  This configuration is mainly used to produce
4c79b5
non-translatable artworks like themes' backgrounds.
4c79b5
4c79b5
   When translation entries contain translation files, the translation
4c79b5
entry implements the CentOS release schema and is used as reference to
4c79b5
create file names and directories layout for translated artworks. In
4c79b5
this case, the `centos-art' script applies one translation file to one
4c79b5
design template to create one translated instance which is used to
4c79b5
output one translated file. When the translated file is rendered, the
4c79b5
`centos-art' script remove the previous instance and takes the next
4c79b5
file in the list of translation files to repate the whole process once
4c79b5
again, and so on for all files in the list. This configuration is
4c79b5
mainly used to produce translatable artworks like Anaconda's progress
4c79b5
slide images.
4c79b5
4c79b5
   To find out correspondence between translation entries and identity
4c79b5
entries, you need to look the path of both translation entries and
4c79b5
identity entries. For example, if you are using the Modern's artisitic
4c79b5
motif, the identity entry for Anaconda progress artwork is:
4c79b5
4c79b5
4c79b5
trunk/Identity/Themes/Motifs/Modern/Distro/Anaconda/Progress
4c79b5
4c79b5
   and its translation entry is:
4c79b5
4c79b5
4c79b5
trunk/Translations/Identity/Themes/Distro/Anaconda/Progress
4c79b5
4c79b5
   Note how the `Translations/' directory prefixes `Identity/'
4c79b5
directory, also how static values (e.g., Identity, Themes, Distro,
4c79b5
etc.) in the identity's entry path remain in translation's entry path,
4c79b5
and how variable values like theme names (e.g., Modern) are stript out
4c79b5
from translation's entry path. The same convenction can be applied to
4c79b5
other identity entries in order to determine their translation entries,
4c79b5
or to other translation entries to determine their identity entries.
4c79b5
4c79b5
     *Note* Translation entries related to identity entries under
4c79b5
     `trunk/Identity/Themes/Motifs' do not use `Motifs/' in the path.
4c79b5
     We've done this because `trunk/Identity/Themes/Models' structure,
4c79b5
     the other structure under `trunk/Identity/Themes', doesn't require
4c79b5
     translation paths so far. So in the sake of saving characters
4c79b5
     space when building translation entries for
4c79b5
     `trunk/Identity/Themes/Motifs' structure, we organize Motifs
4c79b5
     translation entries under `trunk/Translations/Identity/Themes/'
4c79b5
     directly.
4c79b5
4c79b5
     If for some reason `trunk/Identity/Themes/Models' structure
4c79b5
     requires translation entries, we need to re-oraganize the current
4c79b5
     directory structure accordingly.
4c79b5
4c79b5
   Translation entries, as described above, can be re-used by similar
4c79b5
identity entries. For example the following identity entries:
4c79b5
4c79b5
4c79b5
trunk/Identity/Themes/Motifs/Modern/Distro/Anaconda/Progress/
4c79b5
trunk/Identity/Themes/Motifs/TreeFlower/Distro/Anaconda/Progress/
4c79b5
trunk/Identity/Themes/Motifs/Mettle/Distro/Anaconda/Progress/
4c79b5
4c79b5
   are all valid identity entries able to re-use translation files
4c79b5
inside Anaconda progress translation entry (the one shown in our example
4c79b5
above). This way, you can create several identity entries and maintain
4c79b5
just one translation entry for all of them.  Once you change the
4c79b5
translation files inside the common translation entry, changes inside
4c79b5
identity entries will take effect inside the next you render them.
4c79b5
4c79b5
   Trying to make things plain and simple: inside CentOS Artwork
4c79b5
Repository, graphic designers can concentrate their efforts in artworks
4c79b5
look and feel (the identity entries), and translators in artworks
4c79b5
translations (the translation entries).
4c79b5
300762
3.46.2.2 Translation Markers
4c79b5
............................
4c79b5
4c79b5
Translation markers are used in "Theme Model Designs" and "Translation
4c79b5
Files" as replacement patterns to commit content translation.  When you
4c79b5
are rendering content using `centos-art' script inisde `trunk/Identity'
4c79b5
structure, artistic motifs and translation files are applied to model
4c79b5
designs to produce translated content as result. In order to have the
4c79b5
appropriate translation in content rendered, markers defintion in
4c79b5
translation files should match markers in model designs exactly.
4c79b5
4c79b5
   Translation markers can be whatever text you want, but as convenction
4c79b5
we use the following to represent releases of CentOS distribution:
4c79b5
4c79b5
`=MINOR_RELEASE='
4c79b5
     Replace with minor release of CentOS distribution. In the schema
4c79b5
     M.N, the minor release is represented by the N letter.
4c79b5
4c79b5
`=MAJOR_RELEASE='
4c79b5
     Replace with major release of CentOS distribution. In the schema
4c79b5
     M.N, the major release is represented by the M letter.
4c79b5
4c79b5
`=RELEASE='
4c79b5
     Replace the full release of CentOS distribution. It is
4c79b5
     `=MAJOR_RELEASE=.=MINOR_RELEASE=' basically.
4c79b5
4c79b5
   Specific translation markers convenctions are described inside
4c79b5
specific translation entries. Read translation entries documentation to
4c79b5
know more about supported translation markers.
4c79b5
4c79b5
   Translation markers standardization creates a common point of
4c79b5
reference for translators and graphic designers. To have translation
4c79b5
markers well defined makes possible that translators and graphic
4c79b5
designers can work together but independently one another.
4c79b5
300762
3.46.2.3 Translation Files
4c79b5
..........................
4c79b5
4c79b5
Translation files are text files with `sed''s commands inside,
4c79b5
replacement commands mainly. As convenction, translation file names end
4c79b5
in `.sed'. Translation files are used by `centos-art' script to produce
4c79b5
translated artworks for specific major releases of CentOS Distribution.
4c79b5
There are common translation files, specific translation, and template
4c79b5
translation files.
4c79b5
4c79b5
   For example, the Firstboot artwork of CentOS distribution uses the
4c79b5
images `splash-small.png' and `firstboot-left.png' as based to control
4c79b5
its visual style. The `splash-small.png' image contains, in its graphic
4c79b5
design, the release number information of CentOS distribution. So the
4c79b5
`splash-small.png' is release-specific. In the other hand, the
4c79b5
`firstboot-left.png' doesn't contain release number information. So the
4c79b5
`firstboot-left.png' is not release-specific.
4c79b5
4c79b5
   If we want to produce Firstboot artwork for different major releases
4c79b5
of CentOS distribution, using a monolithic visual identity, all
4c79b5
Firstboot images should have the same visual style and, at the same
4c79b5
time, the release-specific information in the release-specific images.
4c79b5
4c79b5
     *Note* The monolithic visual identity is implemented using theme
4c79b5
     models (*note trunk Identity Themes Models::) and artistic motifs
4c79b5
     (*note trunk Identity Themes Motifs::).
4c79b5
4c79b5
   Assuming that both theme models and theme motifs are ready for using,
4c79b5
the initial translation entry to produce Firstboot artworks would look
4c79b5
like the following:
4c79b5
4c79b5
4c79b5
trunk/Translations/Identity/Themes/Distro/BootUp/Firstboot/
4c79b5
|-- Tpl
4c79b5
|   `-- splash-small.sed
4c79b5
`-- firstboot-left.sed
4c79b5
4c79b5
   With the translation entry above, `centos-art' command is able to
4c79b5
produce the image `firstboot-left.png' only. To produce
4c79b5
`splash-small.png' images for major releases (e.g., 3, 4, 5, and 6) of
4c79b5
CentOS distribution we need to produce the release-specific translation
4c79b5
files using the `centos-art' script as following:
4c79b5
4c79b5
4c79b5
centos-art render --translation=/home/centos/artwork/trunk/Translations/Identity/Themes/BootUp/Firstboot --filter='3,4,5,6'
4c79b5
4c79b5
   The above command produces the following translation entiry:
4c79b5
4c79b5
4c79b5
trunk/Translations/Identity/Themes/Distro/BootUp/Firstboot/
4c79b5
|-- 3
4c79b5
|   `-- splash-small.sed
4c79b5
|-- 4
4c79b5
|   `-- splash-small.sed
4c79b5
|-- 5
4c79b5
|   `-- splash-small.sed
4c79b5
|-- 6
4c79b5
|   `-- splash-small.sed
4c79b5
|-- Tpl
4c79b5
|   `-- splash-small.sed
4c79b5
`-- firstboot-left.sed
4c79b5
4c79b5
   At this point `centos-art' is able to produce the Firstboot artwork
4c79b5
images for major releases of CentOS distribution. To add new
4c79b5
release-specific translation files, run the translation rendering
4c79b5
command with the release number you want to produce translation files
4c79b5
for in the `--filter='release-number'' argument.
4c79b5
300762
3.46.2.4 Template Translation Files
4c79b5
...................................
4c79b5
4c79b5
Template translation files are translation files stored inside
4c79b5
translation template directory. Template translation files are used by
4c79b5
`centos-art' script to produce specific translation files only.
4c79b5
Template translation files may be empty or contain `sed''s replacement
4c79b5
commands. If template translation files are empty files, the final
4c79b5
specifc translation file built from it contains release-specific
4c79b5
replacement commands only. For example, see the following translation
4c79b5
entry:
4c79b5
4c79b5
4c79b5
trunk/Translations/Identity/Themes/Distro/BootUp/Firstboot/
4c79b5
|-- 3
4c79b5
|   `-- splash-small.sed
4c79b5
|-- 4
4c79b5
|   `-- splash-small.sed
4c79b5
|-- 5
4c79b5
|   `-- splash-small.sed
4c79b5
|-- 6
4c79b5
|   `-- splash-small.sed
4c79b5
|-- Tpl
4c79b5
|   `-- splash-small.sed    <-- template translation file.
4c79b5
`-- firstboot-left.sed
4c79b5
4c79b5
   In the above exmaple, the `splash-small.sed' file is a template
4c79b5
translation file and looks like:
4c79b5
4c79b5
4c79b5
# -------------------------------------
300762
# $Id: Translations.texi 94 2010-09-18 10:59:42Z al $
4c79b5
# -------------------------------------
4c79b5
4c79b5
   In the above template translation file there are three comments
4c79b5
lines, but when you render it, the `centos-art' adds the
4c79b5
release-specific replacement commands. In our Firstboot example, after
4c79b5
rendering Firstboot translation entry, the `splash-small.sed'
4c79b5
translation file specific to CentOS 5, looks like the following:
4c79b5
4c79b5
4c79b5
# Warning: Do not modify this file directly. This file is created
4c79b5
# automatically using 'centos-art' command line interface.  Any change
4c79b5
# you do in this file will be lost the next time you update
4c79b5
# translation files using 'centos-art' command line interface. If you
4c79b5
# want to improve the content of this translation file, improve its
4c79b5
# template file instead and run the 'centos-art' command line
4c79b5
# interface later to propagate your changes.
4c79b5
# -------------------------------------
300762
# $Id: Translations.texi 94 2010-09-18 10:59:42Z al $
4c79b5
# -------------------------------------
4c79b5
4c79b5
# Release number information.
4c79b5
s!=RELEASE=!=MAJOR_RELEASE=.=MINOR_RELEASE=!g
4c79b5
s!=MINOR_RELEASE=!0!g
4c79b5
s!=MAJOR_RELEASE=!5!g
4c79b5
4c79b5
   If template translation files are not empty, replacement commands
4c79b5
inside template translation files are preserved inside release-specific
4c79b5
translation files.  For example, consider the English template
4c79b5
translation file of Anaconda progress welcome slide.  The translation
4c79b5
template directory structure looks like the following:
4c79b5
4c79b5
4c79b5
trunk/Translations/Identity/Themes/Distro/Anaconda/Progress/
4c79b5
`-- Tpl
4c79b5
    `-- en
4c79b5
        `-- 01-welcome.sed
4c79b5
4c79b5
   and if we render translation files for CentOS 4 and CentOS 5 major
4c79b5
releases, the translation entry would look like the following:
4c79b5
4c79b5
4c79b5
trunk/Translations/Identity/Themes/Distro/Anaconda/Progress/
4c79b5
|-- 4
4c79b5
|   `-- en
4c79b5
|       `-- 01-welcome.sed
4c79b5
|-- 5
4c79b5
|   `-- en
4c79b5
|       `-- 01-welcome.sed
4c79b5
`-- Tpl
4c79b5
    `-- en
4c79b5
        `-- 01-welcome.sed
4c79b5
4c79b5
     *Note* Release-specific translation directories preserve template
4c79b5
     translation directory structure and file names.
4c79b5
4c79b5
   In the example above, the template translation file looks like the
4c79b5
following:
4c79b5
4c79b5
4c79b5
# ------------------------------------------------------------
300762
# $Id: Translations.texi 94 2010-09-18 10:59:42Z al $
4c79b5
# ------------------------------------------------------------
4c79b5
s/=TITLE=/Welcome to CentOS =MAJOR_RELEASE= !/
4c79b5
s/=TEXT1=/Thank you for installing CentOS =MAJOR_RELEASE=./
4c79b5
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./
4c79b5
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./
4c79b5
s/=TEXT4=//
4c79b5
s/=TEXT5=//
4c79b5
s/=TEXT6=//
4c79b5
s!=URL=!http://www.centos.org/!
4c79b5
4c79b5
   and, after render the translation entry, specific translation files
4c79b5
look like the following:
4c79b5
4c79b5
4c79b5
# Warning: Do not modify this file directly. This file is created
4c79b5
# automatically using 'centos-art' command line interface.  Any change
4c79b5
# you do in this file will be lost the next time you update
4c79b5
# translation files using 'centos-art' command line interface. If you
4c79b5
# want to improve the content of this translation file, improve its
4c79b5
# template file instead and run the 'centos-art' command line
4c79b5
# interface later to propagate your changes.
4c79b5
# ------------------------------------------------------------
300762
# $Id: Translations.texi 94 2010-09-18 10:59:42Z al $
4c79b5
# ------------------------------------------------------------
4c79b5
4c79b5
s/=TITLE=/Welcome to CentOS =MAJOR_RELEASE= !/
4c79b5
s/=TEXT1=/Thank you for installing CentOS =MAJOR_RELEASE=./
4c79b5
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./
4c79b5
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./
4c79b5
s/=TEXT4=//
4c79b5
s/=TEXT5=//
4c79b5
s/=TEXT6=//
4c79b5
s!=URL=!http://www.centos.org/!
4c79b5
4c79b5
# Release number information.
4c79b5
s!=RELEASE=!=MAJOR_RELEASE=.=MINOR_RELEASE=!g
4c79b5
s!=MINOR_RELEASE=!0!g
4c79b5
s!=MAJOR_RELEASE=!5!g
4c79b5
4c79b5
   In the example above, relevant lines begin with the `s' word
4c79b5
followed by a separation character (e.g., `/', `!', etc.).  These lines
4c79b5
have the following format:
4c79b5
4c79b5
4c79b5
s/REGEXP/REPLACEMENT/FLAGS
4c79b5
4c79b5
   The `/' characters may be uniformly replaced by any other single
4c79b5
character within any given `s' command.  The `/' character (or whatever
4c79b5
other character is used in its stead) can appear in the REGEXP or
4c79b5
REPLACEMENT only if it is preceded by a `\' character.
4c79b5
4c79b5
   The `s' command is probably the most important in `sed' and has a
4c79b5
lot of different options.  Its basic concept is simple: the `s' command
4c79b5
attempts to match the pattern space against the supplied REGEXP; if the
4c79b5
match is successful, then that portion of the pattern space which was
4c79b5
matched is replaced with REPLACEMENT.
4c79b5
4c79b5
   In the context of our translation files, the REGEXP is where you
4c79b5
define translation markers and REPLACEMENT where you define the
4c79b5
translation text you want to have after artworks rendering.  Sometimes
4c79b5
we use the FLAG component with the `g' command to apply the
4c79b5
replacements globally.
4c79b5
4c79b5
     *Tip* More information about how to use `sed''s replacement
4c79b5
     commands and flags is available in `sed''s documentation manual.
4c79b5
     To read sed's documentation manual type the following command:
4c79b5
     info sed
4c79b5
4c79b5
   Inside translation files, you can use translation markers not only
4c79b5
inside the REGEXP but in the REPLACEMENT too. In order for this
4c79b5
configuration to work, the REPLACEMENT of translation markers needs to
4c79b5
be define _after_ its definition. For example, see in the
4c79b5
release-specific translation file above, how the `s!=MAJOR_RELASE=!5!g'
4c79b5
replacement command is defined _after_ `=MAJOR_RELASE=' translation
4c79b5
marker definition in the REPLACEMENT of `=TITLE=' translation marker
4c79b5
replacement command.
4c79b5
300762
3.46.2.5 Common Translation Files
4c79b5
.................................
4c79b5
4c79b5
Common translation files contain common translations or no translation
4c79b5
at all for their related artworks.  They are in the root directory of
4c79b5
the translation entry. Common translation files create common artworks
4c79b5
for all major releases of CentOS Distribution.
4c79b5
4c79b5
   Translation entries, with common translation files inside, look like
4c79b5
the following:
4c79b5
4c79b5
4c79b5
trunk/Translations/Identity/Themes/Distro/BootUp/Firstboot/
4c79b5
|-- 3
4c79b5
|   `-- splash-small.sed
4c79b5
|-- 4
4c79b5
|   `-- splash-small.sed
4c79b5
|-- 5
4c79b5
|   `-- splash-small.sed
4c79b5
|-- 6
4c79b5
|   `-- splash-small.sed
4c79b5
|-- Tpl
4c79b5
|   `-- splash-small.sed
4c79b5
`-- firstboot-left.sed      <-- common translation file.
4c79b5
300762
3.46.2.6 Specific Translation Files
4c79b5
...................................
4c79b5
4c79b5
Specific translation files contain specific translations for their
4c79b5
related artworks. Specific translation files are not in the root
4c79b5
directory of the translation entry, but inside directories which
4c79b5
describe the type of translation they are doing. Specific translation
4c79b5
files are produced automatically using the `centos-art' script.
4c79b5
4c79b5
4c79b5
trunk/Translations/Identity/Themes/Distro/BootUp/Firstboot/
4c79b5
|-- 3
4c79b5
|   `-- splash-small.sed    <-- CentOS 3 specific translation file.
4c79b5
|-- 4
4c79b5
|   `-- splash-small.sed    <-- CentOS 4 specific translation file.
4c79b5
|-- 5
4c79b5
|   `-- splash-small.sed    <-- CentOS 5 specific translation file.
4c79b5
|-- 6
4c79b5
|   `-- splash-small.sed    <-- CentOS 6 specific translation file.
4c79b5
|-- Tpl
4c79b5
|   `-- splash-small.sed
4c79b5
`-- firstboot-left.sed
4c79b5
300762
3.46.2.7 Translation Rendering
4c79b5
..............................
4c79b5
4c79b5
When rendering translations, the `centos-art' script checks the
4c79b5
translation entry to verify that it has a translation template
4c79b5
directory inside. The translation template directory (`Tpl/') contains
4c79b5
common translation files used to build release-specific translation
4c79b5
files. If the translation template directory doesn't exist inside the
4c79b5
translation entry the translation rendering fails. In this case the
4c79b5
`centos-art' script outputs a message and quits script execution.
4c79b5
300762
3.46.2.8 Translation (Pre-)Rendering Configuration Scripts
4c79b5
..........................................................
4c79b5
4c79b5
When the `centos-art' script finds a translation template directory
4c79b5
inside translation entry, it looks for translations pre-rendering
4c79b5
configuration scripts for that translation entry.  Translation
4c79b5
pre-rendering configuration scripts let you extend translation's
4c79b5
default functionality (described below).
4c79b5
4c79b5
   Translation pre-rendering configuration scripts are stored under
4c79b5
`trunk/Scripts' directory, specifically under the appropriate language
4c79b5
implementation. If you are using `centos-art' Bash's implementation,
4c79b5
the translation pre-rendering scripts are store in the
4c79b5
`trunk/Scripts/Bash/Config' location; if you are using `centos-art'
4c79b5
Python's implementation, then translation pre-rendering scripts are
4c79b5
stored in the `trunk/Scripts/Python/Config' location, and so on for
4c79b5
other implementations.
4c79b5
4c79b5
   Bash's translation pre-rendering configuration scripts look like the
4c79b5
following:
4c79b5
4c79b5
4c79b5
#!/bin/bash
4c79b5
#
4c79b5
# loadConfiguration.sh -- brief description here.
4c79b5
#
4c79b5
# Copyright (C) YEAR YOURNAME
4c79b5
#
4c79b5
# This program is free software; you can redistribute it and/or modify
4c79b5
# it under the terms of the GNU General Public License as published by
4c79b5
# the Free Software Foundation; either version 2 of the License, or
4c79b5
# (at your option) any later version.
4c79b5
#
4c79b5
# This program is distributed in the hope that it will be useful, but
4c79b5
# WITHOUT ANY WARRANTY; without even the implied warranty of
4c79b5
# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
4c79b5
# General Public License for more details.
4c79b5
#
4c79b5
# You should have received a copy of the GNU General Public License
4c79b5
# along with this program; if not, write to the Free Software
4c79b5
# Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307
4c79b5
# USA.
4c79b5
#
4c79b5
# ----------------------------------------------------------------------
300762
# $Id: Translations.texi 94 2010-09-18 10:59:42Z al $
4c79b5
# ----------------------------------------------------------------------
4c79b5
4c79b5
function loadConfiguration {
4c79b5
...
4c79b5
}
4c79b5
4c79b5
   Translation pre-rendering scripts are function scripts loaded and
4c79b5
executed when rendering a translation entry. Translation pre-rendering
4c79b5
scripts are loaded using the translation entry being rendered as
4c79b5
reference. For example, suppose you are using the `centos-art' Bash's
4c79b5
implementation, and you are rendering translations for CentOS brands,
4c79b5
in this situation the translation entry would be:
4c79b5
4c79b5
4c79b5
trunk/Translations/Identity/Brands
4c79b5
4c79b5
   and the entry inside the translation pre-rendering configuration
4c79b5
structure would be:
4c79b5
4c79b5
4c79b5
trunk/Scripts/Bash/Config/Identity/Brands
4c79b5
4c79b5
   Once the `centos-art' script detects that translation pre-rendering
4c79b5
configuration directory exists, the `centos-art' script looks for the
4c79b5
translation pre-rendering configuration file.  If the translation
4c79b5
pre-rendering configuration file exists, it is loaded and executed.
4c79b5
Once the translation pre-rendering configuration file has been executed
4c79b5
the translation rendering process is over, and so the script execution.
4c79b5
4c79b5
     *Note* Translation pre-rendering configuration files have the
4c79b5
     following form:
4c79b5
     render.conf.extension
4c79b5
      where `extension' refers the programming language implementation
4c79b5
     you are using. For example, `sh' for Bash's, `py' for Python's,
4c79b5
     `pl' for Perl's, and so on for other implementations.
4c79b5
4c79b5
   As we are using Bash implementation to describe the translation
4c79b5
pre-rendering configuration example, the translation pre-rendering
4c79b5
configuration file that `centos-art' looks for, inside the above
4c79b5
translation pre-rendering configuration directory, is `render.conf.sh'.
4c79b5
300762
3.46.2.9 Translation Rendering Default Functionality
4c79b5
....................................................
4c79b5
4c79b5
In the other hand, if the translation pre-rendering configuration file
4c79b5
doesn't exist, or it isn't written as function script, the `centos-art'
4c79b5
script ignore translation pre-rendering configuration functionality and
4c79b5
passes to render translation using default functionality instead.
4c79b5
4c79b5
   The translation rendering default functionality takes template
4c79b5
translation directory structure, duplicates it for each release number
4c79b5
specified in the `--filter='release-number'' argument and produces
4c79b5
release-specific directories. As part of template translation
4c79b5
duplication process take place, the `centos-art' script adds
4c79b5
release-specific replacement commands to each specific translation file
4c79b5
inside release-specific directories. As result, specific translation
4c79b5
files, inside release-specific directories, contain template
4c79b5
translation replacement commands _plus_, release-specific replacement
4c79b5
commands.
4c79b5
4c79b5
     *Note* Release-specific replacement commands are standardized
4c79b5
     inside `centos-art' script using predifined release translation
4c79b5
     markers. Release translation markers are described in the
4c79b5
     translation marker section (*note Translation Markers:
4c79b5
     trunk:Translations:TranslationMarkers.).
4c79b5
300762
3.46.3 Usage
4c79b5
------------
4c79b5
4c79b5
`centos-art render 'path/to/dir''
4c79b5
     When `path/to/dir' refers one directory under
4c79b5
     `trunk/Translations', this command orverwrites available
4c79b5
     translation files using translation templates.
4c79b5
4c79b5
`centos-art render 'path/to/dir' --filter='pattern''
4c79b5
     When `path/to/dir' refers one directory under
4c79b5
     `trunk/Translations', this command renders release-specific
4c79b5
     translation files as you specify in the `--filter='pattern''
4c79b5
     argument. In this case, `pattern' not a regular expression but an
4c79b5
     number (e.g., `5') or a list of numbers separated by commas (e.g.,
4c79b5
     `3,4,5,6') that specify the major release of CentOS distribution
4c79b5
     you want to render translations for.
4c79b5
4c79b5
300762
3.46.4 See also
4c79b5
---------------
4c79b5
4c79b5
---------- Footnotes ----------
4c79b5
4c79b5
   (1) This number is an approximate value and may change.  It is
4c79b5
mainly based on CentOS 5 rebranding experience.
4c79b5
4c79b5
   (2) This value was taken from CentOS release schema.
4c79b5
4c79b5
   (3) This value was taken from the `locale -a' command's output.
4c79b5
300762
3.47 trunk/Translations/Identity
4c79b5
================================
4c79b5
300762
3.47.1 Goals
4c79b5
------------
4c79b5
4c79b5
   * ...
4c79b5
300762
3.47.2 Description
4c79b5
------------------
4c79b5
4c79b5
   * ...
4c79b5
300762
3.47.3 Usage
4c79b5
------------
4c79b5
4c79b5
   * ...
4c79b5
300762
3.47.4 See also
4c79b5
---------------
4c79b5
300762
3.48 trunk/Translations/Identity/Brands
4c79b5
=======================================
4c79b5
300762
3.48.1 Goals
4c79b5
------------
4c79b5
4c79b5
   * Organize brands' translation files.
4c79b5
300762
3.48.2 Description
4c79b5
------------------
4c79b5
4c79b5
Translation files, inside `trunk/Translations/Identity/Brands'
4c79b5
translation entry, don't use default rendering translation
4c79b5
functionality, they use the following translation pre-rendering
4c79b5
configuration file instead:
4c79b5
4c79b5
4c79b5
/home/centos/artwork/trunk/Translation/Identity/Brands/render.conf.sh
4c79b5
4c79b5
   Inside `trunk/Translations/Identity/Brands' translation entry,
4c79b5
translation files are symbolic links pointing to the common template
4c79b5
translation structure, inside the translation template (`Tpl/')
4c79b5
directory.
4c79b5
4c79b5
   Inside `trunk/Translations/Identity/Brands' translation entry,
4c79b5
translation files are created using identity design templates as
4c79b5
reference.  The translation pre-rendering script creates a translation
4c79b5
structure where the translation template (`Tpl/') directory structure
4c79b5
applies to each single design template available.
4c79b5
4c79b5
   For example, if the brands' translation template (`Tpl/') directory
4c79b5
has 30 translation files, and there are 20 design templates; the
4c79b5
brands' translation pre-rendering script creates a translation
4c79b5
structure of symbolic links where the 30 translation files apply the 20
4c79b5
design templates one by one, producing 600 translation symbolic links
4c79b5
as result. At this point, when rendering identity, the `centos-art'
4c79b5
script considers translation symbolic links as translation files.
4c79b5
4c79b5
   Translation file names, inside brands' translation template (`Tpl')
4c79b5
directory have special meaning:
4c79b5
300762
3.48.2.1 Conventional file names
4c79b5
................................
4c79b5
4c79b5
Convenctional file names look like `blue.sed', `2c-a.sed', etc.
4c79b5
Replacement commands inside translation file are applied to design
4c79b5
templates and translation file names are used as final image name.  The
4c79b5
image dimensions use the same dimensions that design template has.
4c79b5
300762
3.48.2.2 Numeric file names
4c79b5
...........................
4c79b5
4c79b5
Numeric file names look like `300.sed', `200.sed', etc.  Replacements
4c79b5
commands inside translation files are applied to design templates, and
4c79b5
translation file names are used as final image name.  The final image
4c79b5
is saved using an specific `width' defined by the number part of the
4c79b5
translation file name. The image `height' is automatically scaled based
4c79b5
on the previous `width' definition to maintain the design's ratio.
4c79b5
4c79b5
   For example, if your design template has 400x200 pixels of dimension,
4c79b5
and you apply a translation file named `300.sed' to it, the final image
4c79b5
you get as result will have 300x100 pixels of dimension.   The same is
4c79b5
true if you use higher numbers like `1024.sed', `2048.sed', etc. In
4c79b5
these cases you have bigger images proportionally.
4c79b5
4c79b5
   As we are using scalable vector graphics to design identity
4c79b5
templates, the image size you produce is not limitted in size. You can
4c79b5
use one design template produced in 400x200 pixels to produce larger or
4c79b5
shorter PNG images using numeric translation files as described above.
4c79b5
300762
3.48.2.3 Translation markers
4c79b5
............................
4c79b5
4c79b5
Inside `trunk/Translations/Identity/Brands/', translation files combine
4c79b5
the following translation markers:
4c79b5
4c79b5
`#000000'
4c79b5
     Specify which color to use when rendering brand images.
4c79b5
4c79b5
          *Note* As translation files inside
4c79b5
          `trunk/Translations/Identity/Brands' are symbolic links that
4c79b5
          point to template translation files, translation markers are
4c79b5
          defined inside template translation files.
4c79b5
300762
3.48.3 Usage
4c79b5
------------
4c79b5
4c79b5
To render brands' translation files, use the following command:
4c79b5
4c79b5
4c79b5
centos-art render --translation=/home/centos/artwork/trunk/Translations/Identity/Brands
4c79b5
300762
3.48.4 See also
4c79b5
---------------
4c79b5
300762
3.49 trunk/Translations/Identity/Brands/Tpl
4c79b5
===========================================
4c79b5
300762
3.49.1 Goals
4c79b5
------------
4c79b5
300762
3.49.2 Description
4c79b5
------------------
4c79b5
300762
3.49.3 Usage
4c79b5
------------
4c79b5
300762
3.49.4 See also
4c79b5
---------------
4c79b5
300762
3.50 trunk/Translations/Identity/Fonts
4c79b5
======================================
4c79b5
300762
3.50.1 Goals
4c79b5
------------
4c79b5
4c79b5
   * Organize fonts' translation files.
4c79b5
300762
3.50.2 Description
4c79b5
------------------
4c79b5
4c79b5
Translation files, inside `trunk/Translations/Fonts', have the
4c79b5
following structure:
4c79b5
4c79b5
4c79b5
# ----------------------------------------------------------------------
4c79b5
# $Id: Fonts.texi 29 2010-09-12 05:32:26Z al $
4c79b5
# ----------------------------------------------------------------------
4c79b5
4c79b5
s!font-family:Denmark!font-family:DejaVu LGC Sans!
4c79b5
s!font-weight:normal!font-weight:bold!
4c79b5
s!font-style:normal!font-style:italic!
4c79b5
4c79b5
   Inside `trunk/Translations/Fonts', there is one translation file for
4c79b5
each font preview image you want to produce. This way, we create one
4c79b5
translation file for each font-family we use somewhere inside CentOS
4c79b5
visual identity.
4c79b5
4c79b5
     *Important* Do not create translation files for font-families not
4c79b5
     used somewhere inside CentOS visual identity. The font's identity
4c79b5
     entry (*note trunk Identity Fonts::) is used as reference when
4c79b5
     someone needs to know which font-families are allowed to use
4c79b5
     inside CentOS visual identity.
4c79b5
300762
3.50.2.1 Translation Markers
4c79b5
............................
4c79b5
4c79b5
Inside `trunk/Translations/Identity/Fonts', translation files combine
4c79b5
the following translation markers:
4c79b5
4c79b5
`font-family:Denmark'
4c79b5
     Specify which font family to use when rendering font preview
4c79b5
     images.
4c79b5
4c79b5
`font-weight:normal'
4c79b5
     Specify which font weight to use when rendering font preview
4c79b5
     images.
4c79b5
4c79b5
`font-style:normal'
4c79b5
     Specify which font style to use when rendering font preview images.
4c79b5
300762
3.50.3 Usage
4c79b5
------------
4c79b5
4c79b5
Inside `trunk/Translations/Fonts' you use your favorite text editor to
4c79b5
create translation files.  Inside `trunk/Translations/Fonts' there is
4c79b5
not translation template directory (`Tpl/'), nor translation rendering
4c79b5
using `centos-art' script.  For example, to create the
4c79b5
`dejavu_lgc_sans-boldoblique.sed' translation file using `vim' editor,
4c79b5
type the following command:
4c79b5
4c79b5
4c79b5
vim /home/centos/artwork/trunk/Translations/Fonts/dejavu_lgc_sans-boldoblique.sed
4c79b5
300762
3.50.4 See also
4c79b5
---------------
4c79b5
300762
3.51 trunk/Translations/Identity/Models
4c79b5
=======================================
4c79b5
300762
3.51.1 Goals
4c79b5
------------
4c79b5
300762
3.51.2 Description
4c79b5
------------------
4c79b5
300762
3.51.3 Usage
4c79b5
------------
4c79b5
300762
3.51.4 See also
4c79b5
---------------
4c79b5
300762
3.52 trunk/Translations/Identity/Release
4c79b5
========================================
4c79b5
300762
3.52.1 Goals
4c79b5
------------
4c79b5
300762
3.52.2 Description
4c79b5
------------------
4c79b5
300762
3.52.3 Usage
4c79b5
------------
4c79b5
300762
3.52.4 See also
4c79b5
---------------
4c79b5
300762
3.53 trunk/Translations/Identity/Themes
4c79b5
=======================================
4c79b5
300762
3.53.1 Goals
4c79b5
------------
4c79b5
300762
3.53.2 Description
4c79b5
------------------
4c79b5
300762
3.53.3 Usage
4c79b5
------------
4c79b5
300762
3.53.4 See also
4c79b5
---------------
4c79b5
300762
3.54 trunk/Translations/Identity/Themes/Backgrounds
4c79b5
===================================================
4c79b5
300762
3.54.1 Goals
4c79b5
------------
4c79b5
4c79b5
   * ...
4c79b5
300762
3.54.2 Description
4c79b5
------------------
4c79b5
4c79b5
   * ...
4c79b5
300762
3.54.3 Usage
4c79b5
------------
4c79b5
4c79b5
   * ...
4c79b5
300762
3.54.4 See also
4c79b5
---------------
4c79b5
300762
3.55 trunk/Translations/Identity/Themes/Distro/Anaconda/Progress
4c79b5
================================================================
4c79b5
300762
3.55.1 Goals
4c79b5
------------
4c79b5
4c79b5
   * Organize Anaconda progress translation templates.
4c79b5
4c79b5
   * Organize Anaconda progress translation files in several languages
4c79b5
     and major releases of CentOS distribution.
4c79b5
300762
3.55.2 Description
4c79b5
------------------
4c79b5
4c79b5
Use the following command to produce translation files based:
4c79b5
4c79b5
     trunk/Translations/Identity/Themes/Distro/Anaconda/Progress
4c79b5
     `-- Tpl
4c79b5
         |-- en
4c79b5
         |   |-- 01-welcome.sed
4c79b5
         |   |-- 02-donate.sed
4c79b5
         |   `-- 03-yum.sed
4c79b5
         `-- es
4c79b5
             |-- 01-welcome.sed
4c79b5
             |-- 02-donate.sed
4c79b5
             `-- 03-yum.sed
4c79b5
4c79b5
   In order to produce the slide images in PNG format we need to have
4c79b5
the translation files first. So we use the following commands to create
4c79b5
translation files for CentOS 3, 4, and 5 major releases:
4c79b5
4c79b5
     centos-art render --translation --filter='3,4,5'
4c79b5
4c79b5
   The above commands will produce the following translation structure:
4c79b5
4c79b5
     trunk/Translations/Identity/Themes/Distro/Anaconda/Progress
4c79b5
     |-- 3
4c79b5
     |   |-- en
4c79b5
     |   |   |-- 01-welcome.sed
4c79b5
     |   |   |-- 02-donate.sed
4c79b5
     |   |   `-- 03-yum.sed
4c79b5
     |   `-- es
4c79b5
     |       |-- 01-welcome.sed
4c79b5
     |       |-- 02-donate.sed
4c79b5
     |       `-- 03-yum.sed
4c79b5
     |-- 4
4c79b5
     |   |-- en
4c79b5
     |   |   |-- 01-welcome.sed
4c79b5
     |   |   |-- 02-donate.sed
4c79b5
     |   |   `-- 03-yum.sed
4c79b5
     |   `-- es
4c79b5
     |       |-- 01-welcome.sed
4c79b5
     |       |-- 02-donate.sed
4c79b5
     |       `-- 03-yum.sed
4c79b5
     |-- 5
4c79b5
     |   |-- en
4c79b5
     |   |   |-- 01-welcome.sed
4c79b5
     |   |   |-- 02-donate.sed
4c79b5
     |   |   `-- 03-yum.sed
4c79b5
     |   `-- es
4c79b5
     |       |-- 01-welcome.sed
4c79b5
     |       |-- 02-donate.sed
4c79b5
     |       `-- 03-yum.sed
4c79b5
     `-- Tpl
4c79b5
         |-- en
4c79b5
         |   |-- 01-welcome.sed
4c79b5
         |   |-- 02-donate.sed
4c79b5
         |   `-- 03-yum.sed
4c79b5
         `-- es
4c79b5
             |-- 01-welcome.sed
4c79b5
             |-- 02-donate.sed
4c79b5
             `-- 03-yum.sed
4c79b5
4c79b5
   At this point we have all the translation files we need to produce
4c79b5
Anaconda progress welcome, donate and yum slides images; in English and
4c79b5
Spanish languages; for CentOS 3, CentOS 4, and CentOS 5. That is, a sum
4c79b5
of 18 images around.
4c79b5
4c79b5
   Now, with translation files in place, let's move to `trunk/Identity'
4c79b5
structure and render them.
4c79b5
4c79b5
   * *Note trunk Identity Themes Motifs Modern Distro Anaconda
4c79b5
     Progress::.
4c79b5
300762
3.55.3 Usage
4c79b5
------------
4c79b5
4c79b5
Translation rendering is described in `trunk/Translations'
4c79b5
documentation entry (*note trunk Translations::).
4c79b5
300762
3.55.4 See also
4c79b5
---------------
4c79b5
300762
3.56 trunk/Translations/Identity/Widgets
4c79b5
========================================
4c79b5
300762
3.56.1 Goals
4c79b5
------------
4c79b5
4c79b5
   * ...
4c79b5
300762
3.56.2 Description
4c79b5
------------------
4c79b5
4c79b5
   * ...
4c79b5
300762
3.56.3 Usage
4c79b5
------------
4c79b5
4c79b5
   * ...
4c79b5
300762
3.56.4 See also
4c79b5
---------------
4c79b5
4c79b5
Index
4c79b5
*****
4c79b5
300762
branches:                                      See 1.        (line  327)
300762
Common translation files:                      See 3.46.2.5. (line 2641)
300762
How to render brands' translation files:       See 3.48.3.   (line 2946)
300762
How to render fonts' translation files:        See 3.50.3.   (line 3023)
300762
How to render translation files:               See 3.46.3.   (line 2811)
300762
Specific translation files:                    See 3.46.2.6. (line 2666)
300762
tags:                                          See 2.        (line  330)
300762
Template translation files:                    See 3.46.2.4. (line 2471)
300762
Translation brands file names:                 See 3.48.2.1. (line 2903)
300762
Translation configuration scripts:             See 3.46.2.8. (line 2700)
300762
Translation entries:                           See 3.46.2.1. (line 2287)
300762
Translation files:                             See 3.46.2.3. (line 2403)
300762
Translation markers:                           See 3.46.2.2. (line 2368)
300762
Translation paths:                             See 3.46.2.1. (line 2287)
300762
Translation pre-rendering configuration scripts:See 3.46.2.8.
300762
                                                             (line 2700)
300762
Translation rendering:                         See 3.46.2.7. (line 2689)
300762
Translation rendering default functionality:   See 3.46.2.9. (line 2786)
300762
trunk:                                         See 3.        (line  333)
300762
trunk Identity:                                See 3.1.      (line  336)
300762
trunk Identity Brands:                         See 3.2.      (line  756)
300762
trunk Identity Fonts:                          See 3.3.      (line  773)
300762
trunk Identity Icons:                          See 3.4.      (line  790)
300762
trunk Identity Isolinux:                       See 3.5.      (line  807)
300762
trunk Identity Models:                         See 3.6.      (line  824)
300762
trunk Identity Release:                        See 3.7.      (line  841)
300762
trunk Identity Themes:                         See 3.8.      (line  858)
300762
trunk Identity Themes Models:                  See 3.9.      (line  883)
300762
trunk Identity Themes Models Alternative:      See 3.10.     (line  916)
300762
trunk Identity Themes Models Default:          See 3.11.     (line  943)
300762
trunk Identity Themes Models Default Distro:   See 3.12.     (line  975)
4c79b5
trunk Identity Themes Models Default Distro Anaconda:See 3.13.
300762
                                                             (line 1059)
300762
trunk Identity Themes Models Default Promo:    See 3.14.     (line 1076)
300762
trunk Identity Themes Models Default Web:      See 3.15.     (line 1102)
300762
trunk Identity Themes Motifs:                  See 3.16.     (line 1127)
300762
trunk Identity Themes Motifs Modern Backgrounds:See 3.17.    (line 1231)
4c79b5
trunk Identity Themes Motifs Modern Backgrounds Img:See 3.18.
300762
                                                             (line 1353)
4c79b5
trunk Identity Themes Motifs Modern Backgrounds Tpl:See 3.19.
300762
                                                             (line 1374)
4c79b5
trunk Identity Themes Motifs Modern Backgrounds Xcf:See 3.20.
300762
                                                             (line 1395)
4c79b5
trunk Identity Themes Motifs Modern Distro Anaconda Progress:See 3.21.
300762
                                                             (line 1422)
300762
trunk Identity Themes Motifs Modern Palettes:  See 3.22.     (line 1478)
300762
trunk Identity Themes Motifs TreeFlower:       See 3.23.     (line 1500)
300762
trunk Identity Widgets:                        See 3.24.     (line 1517)
300762
trunk Manuals:                                 See 3.25.     (line 1534)
300762
trunk Scripts:                                 See 3.26.     (line 1588)
300762
trunk Scripts Bash:                            See 3.27.     (line 1612)
300762
trunk Scripts Bash Config:                     See 3.28.     (line 1778)
300762
trunk Scripts Bash Config Identity:            See 3.29.     (line 1892)
300762
trunk Scripts Bash Config Translations:        See 3.30.     (line 1913)
300762
trunk Scripts Bash Functions:                  See 3.31.     (line 1934)
300762
trunk Scripts Bash Functions Config:           See 3.32.     (line 1955)
4c79b5
trunk Scripts Bash Functions Config cli_getActions.sh:See 3.34.
300762
                                                             (line 1968)
4c79b5
trunk Scripts Bash Functions Config cli_getActionsIdentity.sh:See 3.33.
300762
                                                             (line 1961)
4c79b5
trunk Scripts Bash Functions Config cli_getActionsTranslations.sh:See 3.35.
300762
                                                             (line 1974)
4c79b5
trunk Scripts Bash Functions Config cli_getIdentityMatchinglist.sh:See 3.36.
300762
                                                             (line 1981)
4c79b5
trunk Scripts Bash Functions Config repo_renderIdentitySyslinux.sh:See 3.37.
300762
                                                             (line 1990)
300762
trunk Scripts Bash Functions Prepare prepare_forUsingPackages.sh:See 3.38.
300762
                                                             (line 2011)
300762
trunk Scripts Bash Functions Render Config:    See 3.39.     (line 2032)
300762
trunk Scripts Bash Functions Render render_getActions.sh:See 3.41.
300762
                                                             (line 2074)
300762
trunk Scripts Bash Functions Render render_getActionsIdentity.sh:See 3.40.
300762
                                                             (line 2053)
300762
trunk Scripts Bash Functions Render render_getActionsTranslations.sh:See 3.42.
300762
                                                             (line 2095)
300762
trunk Scripts Bash Locale:                     See 3.43.     (line 2116)
300762
trunk Scripts Perl:                            See 3.44.     (line 2200)
300762
trunk Scripts Python:                          See 3.45.     (line 2217)
300762
trunk Translations:                            See 3.46.     (line 2238)
300762
trunk Translations Identity:                   See 3.47.     (line 2841)
300762
trunk Translations Identity Brands:            See 3.48.     (line 2862)
300762
trunk Translations Identity Brands Tpl:        See 3.49.     (line 2957)
300762
trunk Translations Identity Fonts:             See 3.50.     (line 2972)
300762
trunk Translations Identity Models:            See 3.51.     (line 3039)
300762
trunk Translations Identity Release:           See 3.52.     (line 3054)
300762
trunk Translations Identity Themes:            See 3.53.     (line 3069)
300762
trunk Translations Identity Themes Backgrounds:See 3.54.     (line 3084)
300762
trunk Translations Identity Themes Distro Anaconda Progress:See 3.55.
300762
                                                             (line 3105)
300762
trunk Translations Identity Widgets:           See 3.56.     (line 3198)
4c79b5
List of Figures
4c79b5
***************
4c79b5