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
5fb024
  3.7 trunk/Identity/Models/Css
4c79b5
    3.7.1 Goals
4c79b5
    3.7.2 Description
4c79b5
    3.7.3 Usage
4c79b5
    3.7.4 See also
5fb024
  3.8 trunk/Identity/Models/Html
4c79b5
    3.8.1 Goals
5fb024
    3.8.2 Description
4c79b5
    3.8.3 Usage
4c79b5
    3.8.4 See also
5fb024
  3.9 trunk/Identity/Models/Img/Promo/Web
4c79b5
    3.9.1 Goals
4c79b5
    3.9.2 Description
4c79b5
    3.9.3 Usage
4c79b5
    3.9.4 See also
5fb024
  3.10 trunk/Identity/Models/Tpl
4c79b5
    3.10.1 Goals
4c79b5
    3.10.2 Description
4c79b5
    3.10.3 Usage
4c79b5
    3.10.4 See also
5fb024
  3.11 trunk/Identity/Models/Tpl/Promo/Web
4c79b5
    3.11.1 Goals
5fb024
    3.11.2 The CentOS web environment
5fb024
      3.11.2.1 Design model (without ads)
5fb024
      3.11.2.2 Design model (with ads)
5fb024
      3.11.2.3 HTML definitions
5fb024
      3.11.2.4 Controlling visual style
5fb024
      3.11.2.5 Producing visual style
5fb024
      3.11.2.6 Navigation
5fb024
      3.11.2.7 Development and release cycle
5fb024
      3.11.2.8 The [webenv-test] repository
5fb024
      3.11.2.9 The [webenv] repository
5fb024
      3.11.2.10 Priority configuration
4c79b5
    3.11.3 Usage
4c79b5
    3.11.4 See also
5fb024
  3.12 trunk/Identity/Models/Xcf
4c79b5
    3.12.1 Goals
4c79b5
    3.12.2 Description
4c79b5
    3.12.3 Usage
4c79b5
    3.12.4 See also
5fb024
  3.13 trunk/Identity/Release
4c79b5
    3.13.1 Goals
4c79b5
    3.13.2 Description
4c79b5
    3.13.3 Usage
4c79b5
    3.13.4 See also
5fb024
  3.14 trunk/Identity/Themes
4c79b5
    3.14.1 Goals
4c79b5
    3.14.2 Description
4c79b5
    3.14.3 Usage
4c79b5
    3.14.4 See also
5fb024
  3.15 trunk/Identity/Themes/Models
4c79b5
    3.15.1 Goals
4c79b5
    3.15.2 Description
4c79b5
    3.15.3 Usage
4c79b5
    3.15.4 See also
5fb024
  3.16 trunk/Identity/Themes/Models/Alternative
4c79b5
    3.16.1 Goals
4c79b5
    3.16.2 Description
4c79b5
    3.16.3 Usage
4c79b5
    3.16.4 See also
5fb024
  3.17 trunk/Identity/Themes/Models/Default
4c79b5
    3.17.1 Goals
4c79b5
    3.17.2 Description
4c79b5
    3.17.3 Usage
4c79b5
    3.17.4 See also
5fb024
  3.18 trunk/Identity/Themes/Models/Default/Distro
4c79b5
    3.18.1 Goals
4c79b5
    3.18.2 Description
5fb024
      3.18.2.1 One theme for all major releases
5fb024
      3.18.2.2 One theme for each major release
4c79b5
    3.18.3 Usage
4c79b5
    3.18.4 See also
5fb024
  3.19 trunk/Identity/Themes/Models/Default/Distro/Anaconda
4c79b5
    3.19.1 Goals
4c79b5
    3.19.2 Description
4c79b5
    3.19.3 Usage
4c79b5
    3.19.4 See also
5fb024
  3.20 trunk/Identity/Themes/Models/Default/Promo
4c79b5
    3.20.1 Goals
4c79b5
    3.20.2 Description
4c79b5
    3.20.3 Usage
4c79b5
    3.20.4 See also
5fb024
  3.21 trunk/Identity/Themes/Models/Default/Web
4c79b5
    3.21.1 Goals
4c79b5
    3.21.2 Description
4c79b5
    3.21.3 Usage
4c79b5
    3.21.4 See also
5fb024
  3.22 trunk/Identity/Themes/Motifs
4c79b5
    3.22.1 Goals
4c79b5
    3.22.2 Description
4c79b5
    3.22.3 Usage
4c79b5
    3.22.4 See also
5fb024
  3.23 trunk/Identity/Themes/Motifs/Modern/Backgrounds
4c79b5
    3.23.1 Goals
4c79b5
    3.23.2 Description
4c79b5
    3.23.3 Usage
4c79b5
    3.23.4 See also
5fb024
  3.24 trunk/Identity/Themes/Motifs/Modern/Backgrounds/Img
4c79b5
    3.24.1 Goals
4c79b5
    3.24.2 Description
4c79b5
    3.24.3 Usage
4c79b5
    3.24.4 See also
5fb024
  3.25 trunk/Identity/Themes/Motifs/Modern/Backgrounds/Tpl
4c79b5
    3.25.1 Goals
4c79b5
    3.25.2 Description
4c79b5
    3.25.3 Usage
4c79b5
    3.25.4 See also
5fb024
  3.26 trunk/Identity/Themes/Motifs/Modern/Backgrounds/Xcf
4c79b5
    3.26.1 Goals
4c79b5
    3.26.2 Description
4c79b5
    3.26.3 Usage
4c79b5
    3.26.4 See also
5fb024
  3.27 trunk/Identity/Themes/Motifs/Modern/Distro/Anaconda/Progress
4c79b5
    3.27.1 Goals
4c79b5
    3.27.2 Description
4c79b5
    3.27.3 Usage
4c79b5
    3.27.4 See also
5fb024
  3.28 trunk/Identity/Themes/Motifs/Modern/Palettes
4c79b5
    3.28.1 Goals
4c79b5
    3.28.2 Description
4c79b5
    3.28.3 Usage
4c79b5
    3.28.4 See also
5fb024
  3.29 trunk/Identity/Themes/Motifs/TreeFlower
4c79b5
    3.29.1 Goals
4c79b5
    3.29.2 Description
4c79b5
    3.29.3 Usage
4c79b5
    3.29.4 See also
5fb024
  3.30 trunk/Identity/Widgets
4c79b5
    3.30.1 Goals
4c79b5
    3.30.2 Description
4c79b5
    3.30.3 Usage
4c79b5
    3.30.4 See also
5fb024
  3.31 trunk/Manuals
4c79b5
    3.31.1 Goals
4c79b5
    3.31.2 Description
4c79b5
    3.31.3 Usage
4c79b5
    3.31.4 See also
5fb024
  3.32 trunk/Scripts
bc3531
    3.32.1 Goals
bc3531
    3.32.2 Description
bc3531
    3.32.3 Usage
bc3531
    3.32.4 See also
5fb024
  3.33 trunk/Scripts/Bash
bc3531
    3.33.1 Goals
bc3531
    3.33.2 Description
5fb024
      3.33.2.1 The identity matching list
5fb024
      3.33.2.2 Adding new features
bc3531
    3.33.3 Usage
5fb024
      3.33.3.1 The `centos-art' `check' action
5fb024
      3.33.3.2 The `centos-art' `search' action
5fb024
      3.33.3.3 The `centos-art' `path' action
5fb024
      3.33.3.4 The `centos-art' `locale-art' action
5fb024
      3.33.3.5 The `centos-art' `license' action
bc3531
    3.33.4 See also
5fb024
  3.34 trunk/Scripts/Bash/Config/Identity
5fb024
    3.34.1 Goals
5fb024
    3.34.2 Description
5fb024
    3.34.3 Usage
5fb024
    3.34.4 See also
5fb024
  3.35 trunk/Scripts/Bash/Config/Translations
5fb024
    3.35.1 Goals
5fb024
    3.35.2 Description
5fb024
    3.35.3 Usage
5fb024
    3.35.4 See also
5fb024
  3.36 trunk/Scripts/Bash/Functions
5fb024
    3.36.1 Goals
5fb024
    3.36.2 Description
5fb024
    3.36.3 Usage
5fb024
    3.36.4 See also
5fb024
  3.37 trunk/Scripts/Bash/Functions/Config
5fb024
  3.38 trunk/Scripts/Bash/Functions/Config/cli_getActionsIdentity.sh
5fb024
  3.39 trunk/Scripts/Bash/Functions/Config/cli_getActions.sh
5fb024
  3.40 trunk/Scripts/Bash/Functions/Config/cli_getActionsTranslations.sh
5fb024
  3.41 trunk/Scripts/Bash/Functions/Config/cli_getIdentityMatchinglist.sh
5fb024
  3.42 trunk/Scripts/Bash/Functions/Config/repo_renderIdentitySyslinux.sh
4c79b5
    3.42.1 Goals
4c79b5
    3.42.2 Description
4c79b5
    3.42.3 Usage
4c79b5
    3.42.4 See also
5fb024
  3.43 trunk/Scripts/Bash/Functions/Prepare/prepare_forUsingPackages.sh
4c79b5
    3.43.1 Goals
4c79b5
    3.43.2 Description
4c79b5
    3.43.3 Usage
4c79b5
    3.43.4 See also
5fb024
  3.44 trunk/Scripts/Bash/Functions/Render
4c79b5
    3.44.1 Goals
4c79b5
    3.44.2 Description
4c79b5
    3.44.3 Usage
4c79b5
    3.44.4 See also
5fb024
  3.45 trunk/Scripts/Bash/Functions/Render/Config
4c79b5
    3.45.1 Goals
4c79b5
    3.45.2 Description
5fb024
      3.45.2.1 The `render.conf.sh' identity model
5fb024
      3.45.2.2 The `render.conf.sh' translation model
5fb024
      3.45.2.3 The `render.conf.sh' rendering actions
4c79b5
    3.45.3 Usage
4c79b5
    3.45.4 See also
5fb024
  3.46 trunk/Scripts/Bash/Functions/Render/render_getActionsIdentity.sh
4c79b5
    3.46.1 Goals
4c79b5
    3.46.2 Description
4c79b5
    3.46.3 Usage
4c79b5
    3.46.4 See also
5fb024
  3.47 trunk/Scripts/Bash/Functions/Render/render_getActions.sh
4c79b5
    3.47.1 Goals
4c79b5
    3.47.2 Description
4c79b5
    3.47.3 Usage
4c79b5
    3.47.4 See also
5fb024
  3.48 trunk/Scripts/Bash/Functions/Render/render_getActionsTranslations.sh
4c79b5
    3.48.1 Goals
4c79b5
    3.48.2 Description
4c79b5
    3.48.3 Usage
4c79b5
    3.48.4 See also
5fb024
  3.49 trunk/Scripts/Bash/Locale
4c79b5
    3.49.1 Goals
4c79b5
    3.49.2 Description
5fb024
      3.49.2.1 Configuration files
4c79b5
    3.49.3 Usage
5fb024
      3.49.3.1 The `centos-art' `locale-cli' action
4c79b5
    3.49.4 See also
5fb024
  3.50 trunk/Scripts/Perl
4c79b5
    3.50.1 Goals
4c79b5
    3.50.2 Description
4c79b5
    3.50.3 Usage
4c79b5
    3.50.4 See also
5fb024
  3.51 trunk/Scripts/Python
4c79b5
    3.51.1 Goals
4c79b5
    3.51.2 Description
4c79b5
    3.51.3 Usage
4c79b5
    3.51.4 See also
5fb024
  3.52 trunk/Translations
300762
    3.52.1 Goals
300762
    3.52.2 Description
5fb024
      3.52.2.1 Translation Entries
5fb024
      3.52.2.2 Translation Markers
5fb024
      3.52.2.3 Translation Files
5fb024
      3.52.2.4 Template Translation Files
5fb024
      3.52.2.5 Common Translation Files
5fb024
      3.52.2.6 Specific Translation Files
5fb024
      3.52.2.7 Translation Rendering
5fb024
      3.52.2.8 Translation (Pre-)Rendering Configuration Scripts
5fb024
      3.52.2.9 Translation Rendering Default Functionality
300762
    3.52.3 Usage
300762
    3.52.4 See also
5fb024
  3.53 trunk/Translations/Identity
300762
    3.53.1 Goals
300762
    3.53.2 Description
300762
    3.53.3 Usage
300762
    3.53.4 See also
5fb024
  3.54 trunk/Translations/Identity/Brands
300762
    3.54.1 Goals
300762
    3.54.2 Description
5fb024
      3.54.2.1 Conventional file names
5fb024
      3.54.2.2 Numeric file names
5fb024
      3.54.2.3 Translation markers
300762
    3.54.3 Usage
300762
    3.54.4 See also
5fb024
  3.55 trunk/Translations/Identity/Brands/Tpl
300762
    3.55.1 Goals
300762
    3.55.2 Description
300762
    3.55.3 Usage
300762
    3.55.4 See also
5fb024
  3.56 trunk/Translations/Identity/Fonts
300762
    3.56.1 Goals
300762
    3.56.2 Description
5fb024
      3.56.2.1 Translation Markers
300762
    3.56.3 Usage
300762
    3.56.4 See also
5fb024
  3.57 trunk/Translations/Identity/Models
bc3531
    3.57.1 Goals
bc3531
    3.57.2 Description
bc3531
    3.57.3 Usage
bc3531
    3.57.4 See also
5fb024
  3.58 trunk/Translations/Identity/Release
bc3531
    3.58.1 Goals
bc3531
    3.58.2 Description
bc3531
    3.58.3 Usage
bc3531
    3.58.4 See also
5fb024
  3.59 trunk/Translations/Identity/Themes
5fb024
    3.59.1 Goals
5fb024
    3.59.2 Description
5fb024
    3.59.3 Usage
5fb024
    3.59.4 See also
5fb024
  3.60 trunk/Translations/Identity/Themes/Backgrounds
5fb024
    3.60.1 Goals
5fb024
    3.60.2 Description
5fb024
    3.60.3 Usage
5fb024
    3.60.4 See also
5fb024
  3.61 trunk/Translations/Identity/Themes/Distro/Anaconda/Progress
5fb024
    3.61.1 Goals
5fb024
    3.61.2 Description
5fb024
    3.61.3 Usage
5fb024
    3.61.4 See also
5fb024
  3.62 trunk/Translations/Identity/Widgets
5fb024
    3.62.1 Goals
5fb024
    3.62.2 Description
5fb024
    3.62.3 Usage
5fb024
    3.62.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
5fb024
     *Note trunk Scripts Bash::, 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
5fb024
This section exists to organize design models.
4c79b5
4c79b5
3.6.2 Description
4c79b5
-----------------
4c79b5
5fb024
Design models are representative designs useful to understand how to
5fb024
build artworks.
5fb024
4c79b5
3.6.3 Usage
4c79b5
-----------
4c79b5
4c79b5
3.6.4 See also
4c79b5
--------------
4c79b5
5fb024
3.7 trunk/Identity/Models/Css
5fb024
=============================
4c79b5
4c79b5
3.7.1 Goals
4c79b5
-----------
4c79b5
5fb024
This directory exists to provide common style sheets (CSS) definitions
5fb024
to HTML design models.
4c79b5
4c79b5
3.7.2 Description
4c79b5
-----------------
4c79b5
bc3531
   * ...
bc3531
4c79b5
3.7.3 Usage
4c79b5
-----------
4c79b5
bc3531
   * ...
bc3531
4c79b5
3.7.4 See also
4c79b5
--------------
4c79b5
5fb024
3.8 trunk/Identity/Models/Html
5fb024
==============================
4c79b5
4c79b5
3.8.1 Goals
4c79b5
-----------
4c79b5
5fb024
   * ...
5fb024
5fb024
3.8.2 Description
5fb024
-----------------
5fb024
5fb024
   * ...
5fb024
5fb024
3.8.3 Usage
5fb024
-----------
5fb024
5fb024
   * ...
5fb024
5fb024
3.8.4 See also
5fb024
--------------
5fb024
5fb024
3.9 trunk/Identity/Models/Img/Promo/Web
5fb024
=======================================
5fb024
5fb024
3.9.1 Goals
5fb024
-----------
5fb024
5fb024
   * Provide images related to CentOS web interface.
5fb024
5fb024
3.9.2 Description
5fb024
-----------------
5fb024
5fb024
   * ...
5fb024
5fb024
3.9.3 Usage
5fb024
-----------
5fb024
5fb024
   * ...
5fb024
5fb024
3.9.4 See also
5fb024
--------------
5fb024
5fb024
3.10 trunk/Identity/Models/Tpl
5fb024
==============================
5fb024
5fb024
3.10.1 Goals
5fb024
------------
5fb024
5fb024
   * ...
5fb024
5fb024
3.10.2 Description
5fb024
------------------
5fb024
5fb024
   * ...
5fb024
5fb024
3.10.3 Usage
5fb024
------------
5fb024
5fb024
   * ...
5fb024
5fb024
3.10.4 See also
5fb024
---------------
5fb024
5fb024
3.11 trunk/Identity/Models/Tpl/Promo/Web
5fb024
========================================
5fb024
5fb024
3.11.1 Goals
5fb024
------------
5fb024
1a6d31
Organize scalable vector graphics (svg) to help describe the CentOS web
1a6d31
environment.
1a6d31
5fb024
3.11.2 The CentOS web environment
5fb024
---------------------------------
1a6d31
1a6d31
Inside CentOS corporate identity, the CentOS web environment is
1a6d31
considered a promotion component. The CentOS web environment is formed
1a6d31
by a central web application --to cover base needs (e.g., per-major
1a6d31
release information like release notes, lifetime, downloads,
1a6d31
documentation, support, security advisories, bugs, etc.)-- and many
1a6d31
different free web applications --to cover specific needs (e.g., wiki,
1a6d31
mailing lists, etc.)--.
1a6d31
1a6d31
   The CentOS web environment is addressed to solve the following
1a6d31
issues:
1a6d31
1a6d31
   * One unique name and one unique visual style to all web
1a6d31
     applications used inside the web environment.
1a6d31
1a6d31
   * One-step navigation to web applications inside the environment.
1a6d31
1a6d31
   * High degree of customization to change the visual style of all web
1a6d31
     applications with few changes (e.g, updating just two or three
1a6d31
     images plus common style sheet [CSS] definitions).
1a6d31
1a6d31
   The CentOS project is attached to a monolithic corporate visual
1a6d31
identity (*note trunk Identity::), where all visual manifestations have
1a6d31
one unique name and one unique visual style. This way, the CentOS web
1a6d31
environment has one unique name (the CentOS brand) and one unique
1a6d31
visual style (the CentOS default theme) for all its visual
1a6d31
manifestations, the web applications in this case.
1a6d31
1a6d31
   Since a maintainance point of view, achiving the one unique visual
1a6d31
style inside CentOS web environment is not a simple task. The CentOS
1a6d31
web environment is built upon many different web applications which
1a6d31
have different visual styles and different internal ways to customize
1a6d31
their own visual styles. For example: MoinMoin, the web application
1a6d31
used to support the CentOS wiki (`http://wiki.centos.org/') is highly
1a6d31
customizable but Mailman (in its 2.x.x serie), the web application used
1a6d31
to support the CentOS mailing list, doesn't support(1) a customization
1a6d31
system that separates presentation from logic, similar to MoinMoin's
1a6d31
one.
1a6d31
1a6d31
   This visual style diversity complicates our goal of one unique visual
1a6d31
style for all web applications. So, if we want one unique visual style
1a6d31
for all web applications used, it is innevitable to modify the web
1a6d31
applications in order to implement the CentOS one unique visual style
1a6d31
customization in them. Direct modification of upstream applications is
1a6d31
not convenient because upstream applications come with their one visual
1a6d31
style and administrators take the risk of loosing all customization
1a6d31
changes the next time the application be updated (since not all
1a6d31
upstream web applications, used in CentOS web environment, separate
1a6d31
presentation from logic).
1a6d31
1a6d31
   To solve the "one unique visual style" issue, installation and
1a6d31
actualization of web applications --used inside CentOS web
1a6d31
environment-- need to be independent from upstream web applications
1a6d31
development line; in a way that CentOS web environment administrators
1a6d31
can install and update web applications freely without risk of loosing
1a6d31
the one unique visual style customization changes.
1a6d31
1a6d31
   At the surface of this issue we can see the need of one specific yum
1a6d31
repository to store CentOS web environment customized web applications.
1a6d31
5fb024
3.11.2.1 Design model (without ads)
5fb024
...................................
1a6d31
5fb024
3.11.2.2 Design model (with ads)
5fb024
................................
1a6d31
5fb024
3.11.2.3 HTML definitions
5fb024
.........................
1e9202
5fb024
3.11.2.4 Controlling visual style
5fb024
.................................
4c79b5
1a6d31
Inside CentOS web environment, the visual style is controlled by the
1a6d31
following compenents:
4c79b5
1a6d31
*Webenv header background*
1a6d31
1e9202
     trunk/Identity/Themes/Motifs/$THEME/Backgrounds/Img/1024x250.png
1a6d31
1a6d31
*CSS definitions*
1a6d31
1e9202
     trunk/Identity/Themes/Models/Default/Promo/Web/CSS/stylesheet.css
1a6d31
5fb024
3.11.2.5 Producing visual style
5fb024
...............................
1a6d31
1a6d31
The visual style of CentOS web environment is defined in the following
1a6d31
files:
1a6d31
1a6d31
1a6d31
trunk/Identity/Themes/Motifs/$THEME/Backgrounds/Xcf/1024x250.xcf
1a6d31
trunk/Identity/Themes/Motifs/$THEME/Backgrounds/Img/1024x250.png
1a6d31
trunk/Identity/Themes/Motifs/$THEME/Backgrounds/Img/1024x250-bg.png
1a6d31
trunk/Identity/Themes/Motifs/$THEME/Backgrounds/Tpl/1024x250.svg
1a6d31
1a6d31
   As graphic designer you use `1024x250.xcf' file to produce
1a6d31
`1024x250-bg.png' file. Later, inside `1024x250.svg' file, you use the
1a6d31
`1024x250-bg.png' file as background layer to draw your vectorial
1a6d31
design. When you consider you artwork ready, use the `centos-art.sh'
1a6d31
script, as described below, to produce the visual style controller
1a6d31
images of CentOS web environment.
1a6d31
1a6d31
1e9202
centos-art render --entry=trunk/Identity/Themes/Motifs/$THEME/Backgrounds --filter='1024x250'
1a6d31
1a6d31
   Once you have rendered required image files, changing the visual
1a6d31
style of CentOS web environment is a matter of replacing old image files
1a6d31
with new ones, inside webenv repository file system structure. The
1a6d31
visual style changes will take effect the next time customization line
1a6d31
of CentOS web applications be packaged, uploded, and installed from
1a6d31
[webenv] or [webenv-test] repositories.
1a6d31
5fb024
3.11.2.6 Navigation
5fb024
...................
1e9202
1e9202
Inside CentOS web environment, the one-step navegation between web
1e9202
applications is addressed using the web environment navigation bar.
1e9202
The web environment navigation bar contains links to main applications
1e9202
and is always visible no matter where you are inside the web
1e9202
environment.
1e9202
5fb024
3.11.2.7 Development and release cycle
5fb024
......................................
1a6d31
1a6d31
The CentOS web environment development and relase cycle is described
1a6d31
below:
1a6d31
1a6d31
*Download*
1a6d31
     The first action is download the source code of web applications we
1a6d31
     want to use inside CentOS web environment.
1a6d31
1a6d31
          *Important* The source location from which web application are
1a6d31
          downloaded is very important. Use SRPMs from CentOS *[base]*
1a6d31
          and *[updates]* repositories as first choise, and third party
1a6d31
          repositories (e.g. RPMForge, EPEL, etc.) as last resource.
1a6d31
1a6d31
*Prepare*
1a6d31
     Once web application source code has been downloaded, our duty is
1a6d31
     organize its files inside `webenv' version controlled repository.
1a6d31
1a6d31
     When preparing the structure keep in mind that different web
1a6d31
     applications have different visual styles, and also different ways
1a6d31
     to implement it. A convenient way to organize the file system
1a6d31
     structure would be create one development line for each web
1a6d31
     application we use inside CentOS web environment. For example,
1a6d31
     consider the following file system structure:
1a6d31
1a6d31
1a6d31
     https://projects.centos.org/svn/webenv/trunk/
1a6d31
     |-- WebApp1/
1a6d31
     |   |-- Sources/
1a6d31
     |   |   `-- webapp1-0.0.1/
1a6d31
     |   |-- Rpms/
1a6d31
     |   |   `-- webapp1-0.0.1.rpm
1a6d31
     |   |-- Srpms/
1a6d31
     |   |   `-- webapp1-0.0.1.srpm
1a6d31
     |   `-- Specs/
1a6d31
     |       `-- webapp1-0.0.1.spec
1a6d31
     |-- WebApp2/
1a6d31
     `-- WebAppN/
1a6d31
1a6d31
*Customize*
1a6d31
     Once web applications have been organized inside the version
1a6d31
     controlled repository file system, use subversion to create the
1a6d31
     CentOS customization development line of web applications source
1a6d31
     code.  For example, using the above file system structure, you can
1a6d31
     create the customization development line of `webapp1-0.0.1/' with
1a6d31
     the following command:
1a6d31
1a6d31
1a6d31
     svn cp trunk/WebApp1/Sources/webapp1-0.0.1 trunk/WebApp1/Sources/webapp1-0.0.1-webenv
1a6d31
1a6d31
     The command above creates the following structure:
1a6d31
1a6d31
1a6d31
     https://projects.centos.org/svn/webenv/trunk/
1a6d31
     |-- WebApp1/
1a6d31
     |   |-- Sources/
1a6d31
     |   |   |-- webapp1-0.0.1/
1a6d31
     |   |   `-- webapp1-0.0.1-webenv/
1a6d31
     |   |-- Rpms/
1a6d31
     |   |   `-- webapp1-0.0.1.rpm
1a6d31
     |   |-- Srpms/
1a6d31
     |   |   `-- webapp1-0.0.1.srpm
1a6d31
     |   `-- Specs/
1a6d31
     |       `-- webapp1-0.0.1.spec
1a6d31
     |-- WebApp2/
1a6d31
     `-- WebAppN/
1a6d31
1a6d31
     In the above structure, the `webapp1-0.0.1-webenv/' directory is
1a6d31
     the place where you customize the visual style of `webapp1-0.0.1/'
1a6d31
     web application.
1a6d31
1a6d31
          *Tip* Use Subversion's `diff' between CentOS customization
1a6d31
          and upstream development lines to know what you are changing
1a6d31
          exactly.
1a6d31
1a6d31
*Build packages*
1a6d31
     When web application has been customized, build the web application
1a6d31
     RPM and SRPM using the source location with `-webenv' prefix.
1a6d31
1a6d31
1a6d31
     https://projects.centos.org/svn/webenv/trunk/
1a6d31
     |-- WebApp1/
1a6d31
     |   |-- Sources/
1a6d31
     |   |   |-- webapp1-0.0.1/
1a6d31
     |   |   `-- webapp1-0.0.1-webenv/
1a6d31
     |   |-- Rpms/
1a6d31
     |   |   |-- webapp1-0.0.1.rpm
1a6d31
     |   |   `-- webapp1-0.0.1-webenv.rpm
1a6d31
     |   |-- Srpms/
1a6d31
     |   |   |-- webapp1-0.0.1.srpm
1a6d31
     |   |   `-- webapp1-0.0.1-webenv.srpm
1a6d31
     |   `-- Specs/
1a6d31
     |       |-- webapp1-0.0.1.spec
1a6d31
     |       `-- webapp1-0.0.1-webenv.spec
1a6d31
     |-- WebApp2/
1a6d31
     `-- WebAppN/
1a6d31
1a6d31
*Release for testing*
1a6d31
     When the customized web application has been packaged, make
1a6d31
     packages available for testing and quality assurance. This can be
1a6d31
     achives using a [webenv-test] yum repository.
1a6d31
1a6d31
          *Note* The [webenv-test] repository is not shipped inside
1a6d31
          CentOS distribution default yum configuraiton. In order to use
1a6d31
          [webenv-test] repository you need to configure it first.
1a6d31
1a6d31
     If some problem is found to install/update/use the customized
1a6d31
     version of web application, the problem is notified somewhere (a
1a6d31
     bugtracker maybe) and the customization face is repated in order
1a6d31
     to fix the problem. To release the new package add a number after
1a6d31
     `-webenv' prefix. For example, if some problem is found in
1a6d31
     `webapp1-0.0.1-webenv.rpm', when it be fixed the new package will
1a6d31
     be named `webapp1-0.0.1-webenv-1.rpm'. If a problem is found in
1a6d31
     `webapp1-0.0.1-webenv-1.rpm', when it be fixed the new package
1a6d31
     will be named `webapp1-0.0.1-webenv-2.rpm', and so on.
1a6d31
1a6d31
     The "customization -- release for testing" process is repeated
1a6d31
     until CentOS quality assurance team considers the package is ready
1a6d31
     for production.
1a6d31
1a6d31
*Release for production*
1a6d31
     When customized web application packages are considered ready for
1a6d31
     production they are moved from [webenv-test] to [webenv]
1a6d31
     repository.  This action is commited by CentOS quality assurance
1a6d31
     team.
1a6d31
1a6d31
          *Note* The [webenv] repository is not shipped inside CentOS
1a6d31
          distribution default yum configuraiton. In order to use
1a6d31
          [webenv] repository you need to configure it first.
1a6d31
5fb024
3.11.2.8 The [webenv-test] repository
5fb024
.....................................
1a6d31
1a6d31
1a6d31
/etc/yum.repos.d/CentOS-Webenv-test.repo
1a6d31
1a6d31
1a6d31
[webenv-test]
1a6d31
name=CentOS-$releasever - Webenv-test
1a6d31
mirrorlist=http://mirrorlist.centos.org/?release=$releasever&arch=$basearch&repo=webenv-test
1a6d31
#baseurl=http://mirror.centos.org/centos/$releasever/webenv-test/$basearch/
1a6d31
gpgcheck=1
1a6d31
gpgkey=file:///etc/pki/rpm-gpg/RPM-GPG-KEY-CentOS-$releasever
1a6d31
enabled=1
1a6d31
priority=10
1a6d31
5fb024
3.11.2.9 The [webenv] repository
5fb024
................................
1a6d31
1a6d31
1a6d31
/etc/yum.repos.d/CentOS-Webenv.repo
1a6d31
1a6d31
1a6d31
[webenv]
1a6d31
name=CentOS-$releasever - Webenv
1a6d31
mirrorlist=http://mirrorlist.centos.org/?release=$releasever&arch=$basearch&repo=webenv
1a6d31
#baseurl=http://mirror.centos.org/centos/$releasever/webenv/$basearch/
1a6d31
gpgcheck=1
1a6d31
gpgkey=file:///etc/pki/rpm-gpg/RPM-GPG-KEY-CentOS-$releasever
1a6d31
enabled=1
1a6d31
priority=10
1a6d31
5fb024
3.11.2.10 Priority configuration
5fb024
................................
1a6d31
1a6d31
Both [webenv] and [webenv-test] repositories update packages inside
1a6d31
CentOS [base] and CentOS [updates] repositories.
1a6d31
5fb024
3.11.3 Usage
5fb024
------------
4c79b5
bc3531
   * ...
4c79b5
5fb024
3.11.4 See also
5fb024
---------------
4c79b5
1a6d31
---------- Footnotes ----------
1a6d31
1a6d31
   (1) Mailman's theme support may be introduced in mailman-3.x.x
1a6d31
release.
1a6d31
5fb024
3.12 trunk/Identity/Models/Xcf
5fb024
==============================
4c79b5
5fb024
3.12.1 Goals
5fb024
------------
4c79b5
bc3531
   * ...
4c79b5
5fb024
3.12.2 Description
5fb024
------------------
4c79b5
5fb024
   * ...
bc3531
5fb024
3.12.3 Usage
5fb024
------------
5fb024
5fb024
   * ...
5fb024
5fb024
3.12.4 See also
5fb024
---------------
5fb024
5fb024
3.13 trunk/Identity/Release
5fb024
===========================
5fb024
5fb024
3.13.1 Goals
5fb024
------------
bc3531
5fb024
   * ...
5fb024
5fb024
3.13.2 Description
5fb024
------------------
5fb024
5fb024
3.13.3 Usage
5fb024
------------
5fb024
5fb024
3.13.4 See also
5fb024
---------------
5fb024
5fb024
3.14 trunk/Identity/Themes
bc3531
==========================
bc3531
5fb024
3.14.1 Goals
bc3531
------------
bc3531
bc3531
The `trunk/Identity/Themes/' directory exists to:
bc3531
bc3531
   * Organize CentOS Themes.
bc3531
5fb024
3.14.2 Description
bc3531
------------------
bc3531
5fb024
3.14.3 Usage
bc3531
------------
bc3531
bc3531
In this location themes are organized in "Models" --to store common
bc3531
information-- and "Motifs"--to store unique information.  At rendering
bc3531
time, both motifs and models are combined to produce the final CentOS
bc3531
themes.  CentOS themes can be tagged as "Default" or "Alternative".
bc3531
CentOS themes are maintained by CentOS community.
bc3531
5fb024
3.14.4 See also
bc3531
---------------
bc3531
5fb024
3.15 trunk/Identity/Themes/Models
bc3531
=================================
bc3531
5fb024
3.15.1 Goals
bc3531
------------
bc3531
bc3531
   * Organize theme models.
bc3531
5fb024
3.15.2 Description
bc3531
------------------
bc3531
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
5fb024
3.15.3 Usage
bc3531
------------
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
5fb024
3.15.4 See also
bc3531
---------------
4c79b5
5fb024
3.16 trunk/Identity/Themes/Models/Alternative
4c79b5
=============================================
4c79b5
5fb024
3.16.1 Goals
4c79b5
------------
4c79b5
4c79b5
   * ...
4c79b5
5fb024
3.16.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
5fb024
3.16.3 Usage
4c79b5
------------
4c79b5
4c79b5
   * ...
4c79b5
5fb024
3.16.4 See also
4c79b5
---------------
4c79b5
5fb024
3.17 trunk/Identity/Themes/Models/Default
4c79b5
=========================================
4c79b5
5fb024
3.17.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
5fb024
3.17.2 Description
4c79b5
------------------
4c79b5
5fb024
3.17.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
5fb024
3.17.4 See also
4c79b5
---------------
4c79b5
5fb024
3.18 trunk/Identity/Themes/Models/Default/Distro
4c79b5
================================================
4c79b5
5fb024
3.18.1 Goals
4c79b5
------------
4c79b5
4c79b5
   * ...
4c79b5
5fb024
3.18.2 Description
4c79b5
------------------
4c79b5
4c79b5
It applies to all major releases of CentOS distribution.
4c79b5
5fb024
3.18.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
5fb024
3.18.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
5fb024
3.18.3 Usage
4c79b5
------------
4c79b5
5fb024
3.18.4 See also
4c79b5
---------------
4c79b5
5fb024
3.19 trunk/Identity/Themes/Models/Default/Distro/Anaconda
4c79b5
=========================================================
4c79b5
5fb024
3.19.1 Goals
4c79b5
------------
4c79b5
4c79b5
   * ...
4c79b5
5fb024
3.19.2 Description
4c79b5
------------------
4c79b5
5fb024
3.19.3 Usage
4c79b5
------------
4c79b5
5fb024
3.19.4 See also
4c79b5
---------------
4c79b5
5fb024
3.20 trunk/Identity/Themes/Models/Default/Promo
4c79b5
===============================================
4c79b5
5fb024
3.20.1 Goals
4c79b5
------------
4c79b5
4c79b5
   * ...
4c79b5
5fb024
3.20.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
5fb024
3.20.3 Usage
4c79b5
------------
4c79b5
4c79b5
   * ...
4c79b5
5fb024
3.20.4 See also
4c79b5
---------------
4c79b5
5fb024
3.21 trunk/Identity/Themes/Models/Default/Web
4c79b5
=============================================
4c79b5
5fb024
3.21.1 Goals
4c79b5
------------
4c79b5
4c79b5
   * ...
4c79b5
5fb024
3.21.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
5fb024
3.21.3 Usage
4c79b5
------------
4c79b5
4c79b5
   * ...
4c79b5
5fb024
3.21.4 See also
4c79b5
---------------
4c79b5
5fb024
3.22 trunk/Identity/Themes/Motifs
4c79b5
=================================
4c79b5
5fb024
3.22.1 Goals
4c79b5
------------
4c79b5
4c79b5
The `trunk/Identity/Themes/Motifs' directory exists to:
4c79b5
4c79b5
   * Organize CentOS themes' artistic motifs.
4c79b5
5fb024
3.22.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
5fb024
3.22.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
5fb024
3.22.4 See also
4c79b5
---------------
4c79b5
5fb024
3.23 trunk/Identity/Themes/Motifs/Modern/Backgrounds
4c79b5
====================================================
4c79b5
5fb024
3.23.1 Goals
4c79b5
------------
4c79b5
4c79b5
   * Organize background images for Modern theme.
4c79b5
5fb024
3.23.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
5fb024
3.23.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
5fb024
3.23.4 See also
4c79b5
---------------
4c79b5
5fb024
3.24 trunk/Identity/Themes/Motifs/Modern/Backgrounds/Img
4c79b5
========================================================
4c79b5
5fb024
3.24.1 Goals
4c79b5
------------
4c79b5
4c79b5
   * ...
4c79b5
5fb024
3.24.2 Description
4c79b5
------------------
4c79b5
5fb024
3.24.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
5fb024
3.24.4 See also
4c79b5
---------------
4c79b5
5fb024
3.25 trunk/Identity/Themes/Motifs/Modern/Backgrounds/Tpl
4c79b5
========================================================
4c79b5
5fb024
3.25.1 Goals
4c79b5
------------
4c79b5
4c79b5
   * ...
4c79b5
5fb024
3.25.2 Description
4c79b5
------------------
4c79b5
5fb024
3.25.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
5fb024
3.25.4 See also
4c79b5
---------------
4c79b5
5fb024
3.26 trunk/Identity/Themes/Motifs/Modern/Backgrounds/Xcf
4c79b5
========================================================
4c79b5
5fb024
3.26.1 Goals
4c79b5
------------
4c79b5
4c79b5
   * ...
4c79b5
5fb024
3.26.2 Description
4c79b5
------------------
4c79b5
4c79b5
   * ...
4c79b5
5fb024
3.26.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
5fb024
3.26.4 See also
4c79b5
---------------
4c79b5
5fb024
3.27 trunk/Identity/Themes/Motifs/Modern/Distro/Anaconda/Progress
4c79b5
=================================================================
4c79b5
5fb024
3.27.1 Goals
4c79b5
------------
4c79b5
4c79b5
   * ...
4c79b5
5fb024
3.27.2 Description
4c79b5
------------------
4c79b5
5fb024
3.27.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
5fb024
3.27.4 See also
4c79b5
---------------
4c79b5
5fb024
3.28 trunk/Identity/Themes/Motifs/Modern/Palettes
4c79b5
=================================================
4c79b5
5fb024
3.28.1 Goals
4c79b5
------------
4c79b5
4c79b5
   * Organize palette files for Modern theme.
4c79b5
5fb024
3.28.2 Description
4c79b5
------------------
4c79b5
5fb024
3.28.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
5fb024
3.28.4 See also
4c79b5
---------------
4c79b5
5fb024
3.29 trunk/Identity/Themes/Motifs/TreeFlower
4c79b5
============================================
4c79b5
5fb024
3.29.1 Goals
4c79b5
------------
4c79b5
4c79b5
   * ...
4c79b5
5fb024
3.29.2 Description
4c79b5
------------------
4c79b5
5fb024
3.29.3 Usage
4c79b5
------------
4c79b5
5fb024
3.29.4 See also
4c79b5
---------------
4c79b5
5fb024
3.30 trunk/Identity/Widgets
4c79b5
===========================
4c79b5
5fb024
3.30.1 Goals
4c79b5
------------
4c79b5
4c79b5
   * ...
4c79b5
5fb024
3.30.2 Description
4c79b5
------------------
4c79b5
5fb024
3.30.3 Usage
4c79b5
------------
4c79b5
5fb024
3.30.4 See also
4c79b5
---------------
4c79b5
5fb024
3.31 trunk/Manuals
4c79b5
==================
4c79b5
5fb024
3.31.1 Goals
4c79b5
------------
4c79b5
4c79b5
   * ...
4c79b5
5fb024
3.31.2 Description
4c79b5
------------------
4c79b5
4c79b5
   * ...
4c79b5
5fb024
3.31.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
5fb024
3.31.4 See also
4c79b5
---------------
4c79b5
5fb024
3.32 trunk/Scripts
4c79b5
==================
4c79b5
5fb024
3.32.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
5fb024
3.32.2 Description
4c79b5
------------------
4c79b5
4c79b5
   * ...
4c79b5
5fb024
3.32.3 Usage
4c79b5
------------
4c79b5
4c79b5
   * ...
4c79b5
5fb024
3.32.4 See also
4c79b5
---------------
4c79b5
5fb024
3.33 trunk/Scripts/Bash
4c79b5
=======================
4c79b5
5fb024
3.33.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
5fb024
3.33.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
5fb024
3.33.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
5fb024
templates.
4c79b5
5fb024
3.33.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
5fb024
3.33.3 Usage
4c79b5
------------
4c79b5
5fb024
3.33.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
5fb024
3.33.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
5fb024
3.33.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
5fb024
3.33.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
5fb024
3.33.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
5fb024
3.33.4 See also
4c79b5
---------------
4c79b5
5fb024
3.34 trunk/Scripts/Bash/Config/Identity
4c79b5
=======================================
4c79b5
5fb024
3.34.1 Goals
4c79b5
------------
4c79b5
4c79b5
   * ...
4c79b5
5fb024
3.34.2 Description
4c79b5
------------------
4c79b5
4c79b5
   * ...
4c79b5
5fb024
3.34.3 Usage
4c79b5
------------
4c79b5
4c79b5
   * ...
4c79b5
5fb024
3.34.4 See also
4c79b5
---------------
4c79b5
5fb024
3.35 trunk/Scripts/Bash/Config/Translations
4c79b5
===========================================
4c79b5
5fb024
3.35.1 Goals
4c79b5
------------
4c79b5
4c79b5
   * ...
4c79b5
5fb024
3.35.2 Description
4c79b5
------------------
4c79b5
4c79b5
   * ...
4c79b5
5fb024
3.35.3 Usage
4c79b5
------------
4c79b5
4c79b5
   * ...
4c79b5
5fb024
3.35.4 See also
4c79b5
---------------
4c79b5
5fb024
3.36 trunk/Scripts/Bash/Functions
4c79b5
=================================
4c79b5
5fb024
3.36.1 Goals
4c79b5
------------
4c79b5
4c79b5
   * ...
4c79b5
5fb024
3.36.2 Description
4c79b5
------------------
4c79b5
4c79b5
   * ...
4c79b5
5fb024
3.36.3 Usage
4c79b5
------------
4c79b5
4c79b5
   * ...
4c79b5
5fb024
3.36.4 See also
4c79b5
---------------
4c79b5
5fb024
3.37 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
5fb024
3.38 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
5fb024
3.39 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
5fb024
3.40 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
5fb024
3.41 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
5fb024
3.42 trunk/Scripts/Bash/Functions/Config/repo_renderIdentitySyslinux.sh
300762
=======================================================================
300762
5fb024
3.42.1 Goals
4c79b5
------------
4c79b5
4c79b5
   * ...
4c79b5
5fb024
3.42.2 Description
4c79b5
------------------
4c79b5
4c79b5
   * ...
4c79b5
5fb024
3.42.3 Usage
4c79b5
------------
4c79b5
4c79b5
   * ...
4c79b5
5fb024
3.42.4 See also
4c79b5
---------------
4c79b5
5fb024
3.43 trunk/Scripts/Bash/Functions/Prepare/prepare_forUsingPackages.sh
300762
=====================================================================
4c79b5
5fb024
3.43.1 Goals
4c79b5
------------
4c79b5
4c79b5
   * ...
4c79b5
5fb024
3.43.2 Description
4c79b5
------------------
4c79b5
4c79b5
   * ...
4c79b5
5fb024
3.43.3 Usage
4c79b5
------------
4c79b5
4c79b5
   * ...
4c79b5
5fb024
3.43.4 See also
4c79b5
---------------
4c79b5
5fb024
3.44 trunk/Scripts/Bash/Functions/Render
5fb024
========================================
4c79b5
5fb024
3.44.1 Goals
4c79b5
------------
4c79b5
4c79b5
   * ...
4c79b5
5fb024
3.44.2 Description
4c79b5
------------------
4c79b5
4c79b5
   * ...
4c79b5
5fb024
3.44.3 Usage
4c79b5
------------
4c79b5
4c79b5
   * ...
4c79b5
5fb024
3.44.4 See also
5fb024
---------------
5fb024
5fb024
3.45 trunk/Scripts/Bash/Functions/Render/Config
5fb024
===============================================
5fb024
5fb024
3.45.1 Goals
5fb024
------------
5fb024
5fb024
The `trunk/Scripts/Bash/Config' directory exists to oraganize
5fb024
pre-rendering configuration scripts.
5fb024
5fb024
3.45.2 Description
5fb024
------------------
5fb024
5fb024
Pre-rendering configuration scripts let you customize the way
5fb024
`centos-art.sh' script renders identity and translation repository
5fb024
entries.  Pre-rendering configuration scripts are `render.conf.sh'
5fb024
files with `render_loadConfig' function definition inside.
5fb024
5fb024
   There is one `render.conf.sh' file for each pre-rendering
5fb024
configuration entry. Pre-rendering configuration entries can be based
5fb024
both on identity and translation repository entires.  Pre-rendering
5fb024
configuration entries are required for each identity entry, but not for
5fb024
translation entries.
5fb024
5fb024
3.45.2.1 The `render.conf.sh' identity model
5fb024
............................................
5fb024
5fb024
Inside CentOS Artwork Repository, we consider identity entries to all
5fb024
directories under `trunk/Identity' directory. Identity entries can be
5fb024
image-based or text-based. When you render image-based identity entries
5fb024
you need to use image-based pre-rendering configuration scripts.
5fb024
Likewise, when you render text-based identity entries you need to use
5fb024
text-based pre-rendering configuration scripts.
5fb024
5fb024
   Inside identity pre-rendering configuration scripts, image-based
5fb024
pre-rendering configuration scripts look like the following:
5fb024
5fb024
5fb024
#!/bin/bash
5fb024
5fb024
function render_loadConfig {
5fb024
5fb024
    # Define rendering actions.
5fb024
    ACTIONS[0]='BASE:renderImage'
5fb024
    ACTIONS[1]='POST:renderFormats: tif xpm pdf ppm'
5fb024
5fb024
}
5fb024
5fb024
   Inside identity pre-rendering configuration scripts, text-based
5fb024
pre-rendering configuration scripts look like the following:
5fb024
5fb024
5fb024
#!/bin/bash
5fb024
5fb024
function render_loadConfig {
5fb024
5fb024
    # Define rendering actions.
5fb024
    ACTIONS[0]='BASE:renderText'
5fb024
    ACTIONS[1]='POST:formatText: --width=70 --uniform-spacing'
5fb024
5fb024
}
5fb024
5fb024
   When using identity pre-rendering configuration scripts, you can
5fb024
extend both image-based and text-based pre-rendering configuration
5fb024
scripts using image-based and text-based post-rendering actions,
5fb024
respectively.
5fb024
5fb024
3.45.2.2 The `render.conf.sh' translation model
5fb024
...............................................
5fb024
5fb024
Translation pre-rendering configuration scripts take precedence before
5fb024
default translation rendering action. Translation pre-rendering actions
5fb024
are useful when default translation rendering action do not fit itself
5fb024
to translation entry rendering requirements.
5fb024
5fb024
3.45.2.3 The `render.conf.sh' rendering actions
5fb024
...............................................
5fb024
5fb024
Inside both image-based and text-based identity pre-rendering
5fb024
configuration scripts, we use the `ACTIONS' array variable to define
5fb024
the way `centos-art.sh' script performs identity rendering.  Identity
5fb024
rendering is organized by one `BASE' action, and optional `POST' and
5fb024
`LAST' rendering actions.
5fb024
5fb024
   The `BASE' action specifies what kind of rendering does the
5fb024
`centos-art.sh' script will perform with the files related to the
5fb024
pre-rendering configuration script. The `BASE' action is required.
5fb024
Possible values to `BASE' action are either `renderImage' or
5fb024
`renderText' only.
5fb024
5fb024
   To specify the `BASE' action you need to set the `BASE:' string
5fb024
followed by one of the possible values. For example, if you want to
5fb024
render images, consider the following definition of `BASE' action:
5fb024
5fb024
5fb024
ACTIONS[0]='BASE:renderImage'
5fb024
5fb024
   Only one `BASE' action must be specified. If more than one `BASE'
5fb024
action is specified, the last one is used. If no `BASE' action is
5fb024
specified at all, an error is triggered and the `centos-art.sh' script
5fb024
ends its execution.
5fb024
5fb024
   The `POST' action specifies which action to apply for each file
5fb024
rendered (at the rendering time). This action is optional.  You can set
5fb024
many different `POST' actions to apply many different actions over the
5fb024
same already rendered file. Possible values to `POST' action are
5fb024
`renderFormats', `renderSyslinux', `renderGrub', etc.
5fb024
5fb024
   To specify the `POST' action, you need to use set the `POST:'
5fb024
followed by the function name of the action you want to perform.  The
5fb024
exact form depends on your needs. For example, consider the following
5fb024
example to produce `xpm', `jpg', and `tif' images, based on already
5fb024
rendered `png' image, and also organize the produced files in
5fb024
directories named as their own extensions:
5fb024
5fb024
5fb024
ACTIONS[0]='BASE:renderImage'
5fb024
ACTIONS[1]='POST:renderFormats: xpm jpg tif'
5fb024
ACTIONS[2]='POST:groupByFormat: png xpm jpg tif'
5fb024
5fb024
   In the previous example, file organization takes place at the moment
5fb024
of rendering, just after producing the `png' base file and before going
5fb024
to the next file in the list of files to render. If you don't want to
5fb024
organized the produced files in directories named as their own
5fb024
extensions, just remove the `POST:groupByFormat' action line:
5fb024
5fb024
5fb024
ACTIONS[0]='BASE:renderImage'
5fb024
ACTIONS[1]='POST:renderFormats: xpm jpg tif'
5fb024
5fb024
   The `LAST' action specifies which actions to apply once the last
5fb024
file in the list of files to process has been rendered. The `LAST'
5fb024
action is optional. Possible values for `LAST' actions may be
5fb024
`groupByFormat', `renderGdmTgz', etc.
5fb024
5fb024
     *Note* *Note trunk Scripts Bash Functions Render::, to know more
5fb024
     about possible values for `BASE', `POST' and `LAST' action
5fb024
     definitions.
5fb024
5fb024
   To specify the `LAST' action, you need to set the `LAST:' string
5fb024
followed by the function name of the action you want to perform.  For
5fb024
example, consider the following example if you want to render all files
5fb024
first and organize them later:
5fb024
5fb024
5fb024
ACTIONS[0]='BASE:renderImage'
5fb024
ACTIONS[1]='POST:renderFormats: xpm jpg tif'
5fb024
ACTIONS[2]='LAST:groupByformat: png xpm jpg tif'
5fb024
5fb024
3.45.3 Usage
5fb024
------------
5fb024
5fb024
Use the following commands to administer both identity and translation
5fb024
pre-rendering configuration scripts:
5fb024
5fb024
`centos-art config 'path/to/dir/' --create'
5fb024
     Use this command to create `path/to/dir' related pre-rendering
5fb024
     configuration script.
5fb024
5fb024
`centos-art config 'path/to/dir/' --edit'
5fb024
     Use this command to edit `path/to/dir' related pre-rendering
5fb024
     configuration script.
5fb024
5fb024
`centos-art config 'path/to/dir/' --read'
5fb024
     Use this command to read `path/to/dir' related pre-rendering
5fb024
     configuration script.
5fb024
5fb024
`centos-art config 'path/to/dir/' --remove'
5fb024
     Use this command to remove `path/to/dir' related pre-rendering
5fb024
     configuration script.
5fb024
5fb024
5fb024
   In the commands above, `path/to/dir' refers to one renderable
5fb024
directory path under `trunk/Identity' or `trunk/Translations'
5fb024
structures only.
5fb024
5fb024
3.45.4 See also
4c79b5
---------------
4c79b5
5fb024
3.46 trunk/Scripts/Bash/Functions/Render/render_getActionsIdentity.sh
300762
=====================================================================
4c79b5
5fb024
3.46.1 Goals
4c79b5
------------
4c79b5
4c79b5
   * ...
4c79b5
5fb024
3.46.2 Description
4c79b5
------------------
4c79b5
4c79b5
   * ...
4c79b5
5fb024
3.46.3 Usage
4c79b5
------------
4c79b5
4c79b5
   * ...
4c79b5
5fb024
3.46.4 See also
4c79b5
---------------
4c79b5
5fb024
3.47 trunk/Scripts/Bash/Functions/Render/render_getActions.sh
300762
=============================================================
4c79b5
5fb024
3.47.1 Goals
4c79b5
------------
4c79b5
4c79b5
   * ...
4c79b5
5fb024
3.47.2 Description
4c79b5
------------------
4c79b5
4c79b5
   * ...
4c79b5
5fb024
3.47.3 Usage
4c79b5
------------
4c79b5
4c79b5
   * ...
4c79b5
5fb024
3.47.4 See also
4c79b5
---------------
4c79b5
5fb024
3.48 trunk/Scripts/Bash/Functions/Render/render_getActionsTranslations.sh
300762
=========================================================================
4c79b5
5fb024
3.48.1 Goals
4c79b5
------------
4c79b5
4c79b5
   * ...
4c79b5
5fb024
3.48.2 Description
4c79b5
------------------
4c79b5
4c79b5
   * ...
4c79b5
5fb024
3.48.3 Usage
4c79b5
------------
4c79b5
4c79b5
   * ...
4c79b5
5fb024
3.48.4 See also
4c79b5
---------------
4c79b5
5fb024
3.49 trunk/Scripts/Bash/Locale
4c79b5
==============================
4c79b5
5fb024
3.49.1 Goals
4c79b5
------------
4c79b5
4c79b5
   * Organize `centos-art.sh' locale files.
4c79b5
5fb024
3.49.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
5fb024
3.49.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
5fb024
   * `trunk/Scripts/Bash/Functions/Help/cli_localeMessages.sh'
4c79b5
5fb024
   * `trunk/Scripts/Bash/Functions/Help/cli_localeMessagesStatus.sh'
4c79b5
5fb024
3.49.3 Usage
4c79b5
------------
4c79b5
5fb024
3.49.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
5fb024
3.49.4 See also
4c79b5
---------------
4c79b5
5fb024
3.50 trunk/Scripts/Perl
4c79b5
=======================
4c79b5
5fb024
3.50.1 Goals
4c79b5
------------
4c79b5
4c79b5
   * ...
4c79b5
5fb024
3.50.2 Description
4c79b5
------------------
4c79b5
5fb024
3.50.3 Usage
4c79b5
------------
4c79b5
5fb024
3.50.4 See also
4c79b5
---------------
4c79b5
5fb024
3.51 trunk/Scripts/Python
4c79b5
=========================
4c79b5
5fb024
3.51.1 Goals
4c79b5
------------
4c79b5
4c79b5
   * ...
4c79b5
5fb024
3.51.2 Description
4c79b5
------------------
4c79b5
4c79b5
   * ...
4c79b5
5fb024
3.51.3 Usage
4c79b5
------------
4c79b5
4c79b5
   * ...
4c79b5
5fb024
3.51.4 See also
4c79b5
---------------
4c79b5
5fb024
3.52 trunk/Translations
4c79b5
=======================
4c79b5
5fb024
3.52.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
5fb024
3.52.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
5fb024
3.52.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
5fb024
3.52.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
5fb024
3.52.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
5fb024
3.52.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
5fb024
3.52.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
5fb024
3.52.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
5fb024
3.52.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
5fb024
3.52.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
5fb024
3.52.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
5fb024
3.52.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
5fb024
3.52.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
5fb024
3.53 trunk/Translations/Identity
4c79b5
================================
4c79b5
5fb024
3.53.1 Goals
4c79b5
------------
4c79b5
4c79b5
   * ...
4c79b5
5fb024
3.53.2 Description
4c79b5
------------------
4c79b5
4c79b5
   * ...
4c79b5
5fb024
3.53.3 Usage
4c79b5
------------
4c79b5
4c79b5
   * ...
4c79b5
5fb024
3.53.4 See also
4c79b5
---------------
4c79b5
5fb024
3.54 trunk/Translations/Identity/Brands
4c79b5
=======================================
4c79b5
5fb024
3.54.1 Goals
4c79b5
------------
4c79b5
4c79b5
   * Organize brands' translation files.
4c79b5
5fb024
3.54.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
5fb024
3.54.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
5fb024
3.54.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
5fb024
3.54.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
5fb024
3.54.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
5fb024
3.54.4 See also
4c79b5
---------------
4c79b5
5fb024
3.55 trunk/Translations/Identity/Brands/Tpl
4c79b5
===========================================
4c79b5
5fb024
3.55.1 Goals
4c79b5
------------
4c79b5
5fb024
3.55.2 Description
4c79b5
------------------
4c79b5
5fb024
3.55.3 Usage
4c79b5
------------
4c79b5
5fb024
3.55.4 See also
4c79b5
---------------
4c79b5
5fb024
3.56 trunk/Translations/Identity/Fonts
4c79b5
======================================
4c79b5
5fb024
3.56.1 Goals
4c79b5
------------
4c79b5
4c79b5
   * Organize fonts' translation files.
4c79b5
5fb024
3.56.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
5fb024
3.56.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
5fb024
3.56.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
5fb024
3.56.4 See also
4c79b5
---------------
4c79b5
5fb024
3.57 trunk/Translations/Identity/Models
4c79b5
=======================================
4c79b5
5fb024
3.57.1 Goals
4c79b5
------------
4c79b5
5fb024
3.57.2 Description
4c79b5
------------------
4c79b5
5fb024
3.57.3 Usage
4c79b5
------------
4c79b5
5fb024
3.57.4 See also
4c79b5
---------------
4c79b5
5fb024
3.58 trunk/Translations/Identity/Release
4c79b5
========================================
4c79b5
5fb024
3.58.1 Goals
4c79b5
------------
4c79b5
5fb024
3.58.2 Description
4c79b5
------------------
4c79b5
5fb024
3.58.3 Usage
4c79b5
------------
4c79b5
5fb024
3.58.4 See also
4c79b5
---------------
4c79b5
5fb024
3.59 trunk/Translations/Identity/Themes
4c79b5
=======================================
4c79b5
5fb024
3.59.1 Goals
4c79b5
------------
4c79b5
5fb024
3.59.2 Description
4c79b5
------------------
4c79b5
5fb024
3.59.3 Usage
4c79b5
------------
4c79b5
5fb024
3.59.4 See also
4c79b5
---------------
4c79b5
5fb024
3.60 trunk/Translations/Identity/Themes/Backgrounds
4c79b5
===================================================
4c79b5
5fb024
3.60.1 Goals
4c79b5
------------
4c79b5
4c79b5
   * ...
4c79b5
5fb024
3.60.2 Description
4c79b5
------------------
4c79b5
4c79b5
   * ...
4c79b5
5fb024
3.60.3 Usage
4c79b5
------------
4c79b5
4c79b5
   * ...
4c79b5
5fb024
3.60.4 See also
4c79b5
---------------
4c79b5
5fb024
3.61 trunk/Translations/Identity/Themes/Distro/Anaconda/Progress
4c79b5
================================================================
4c79b5
5fb024
3.61.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
5fb024
3.61.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
5fb024
3.61.3 Usage
4c79b5
------------
4c79b5
4c79b5
Translation rendering is described in `trunk/Translations'
4c79b5
documentation entry (*note trunk Translations::).
4c79b5
5fb024
3.61.4 See also
4c79b5
---------------
4c79b5
5fb024
3.62 trunk/Translations/Identity/Widgets
4c79b5
========================================
4c79b5
5fb024
3.62.1 Goals
4c79b5
------------
4c79b5
4c79b5
   * ...
4c79b5
5fb024
3.62.2 Description
4c79b5
------------------
4c79b5
4c79b5
   * ...
4c79b5
5fb024
3.62.3 Usage
4c79b5
------------
4c79b5
4c79b5
   * ...
4c79b5
5fb024
3.62.4 See also
4c79b5
---------------
4c79b5
4c79b5
Index
4c79b5
*****
4c79b5
5fb024
branches:                                      See 1.        (line  368)
5fb024
Common translation files:                      See 3.52.2.5. (line 3168)
5fb024
How to render brands' translation files:       See 3.54.3.   (line 3473)
5fb024
How to render fonts' translation files:        See 3.56.3.   (line 3550)
5fb024
How to render translation files:               See 3.52.3.   (line 3338)
5fb024
Specific translation files:                    See 3.52.2.6. (line 3193)
5fb024
tags:                                          See 2.        (line  371)
5fb024
Template translation files:                    See 3.52.2.4. (line 2998)
5fb024
Translation brands file names:                 See 3.54.2.1. (line 3430)
5fb024
Translation configuration scripts:             See 3.52.2.8. (line 3227)
5fb024
Translation entries:                           See 3.52.2.1. (line 2814)
5fb024
Translation files:                             See 3.52.2.3. (line 2930)
5fb024
Translation markers:                           See 3.52.2.2. (line 2895)
5fb024
Translation paths:                             See 3.52.2.1. (line 2814)
5fb024
Translation pre-rendering configuration scripts:See 3.52.2.8.
5fb024
                                                             (line 3227)
5fb024
Translation rendering:                         See 3.52.2.7. (line 3216)
5fb024
Translation rendering default functionality:   See 3.52.2.9. (line 3313)
5fb024
trunk:                                         See 3.        (line  374)
5fb024
trunk Identity:                                See 3.1.      (line  377)
5fb024
trunk Identity Brands:                         See 3.2.      (line  797)
5fb024
trunk Identity Fonts:                          See 3.3.      (line  814)
5fb024
trunk Identity Icons:                          See 3.4.      (line  831)
5fb024
trunk Identity Isolinux:                       See 3.5.      (line  848)
5fb024
trunk Identity Models:                         See 3.6.      (line  865)
5fb024
trunk Identity Models Css:                     See 3.7.      (line  885)
5fb024
trunk Identity Models Html:                    See 3.8.      (line  907)
5fb024
trunk Identity Models Img Promo Web:           See 3.9.      (line  928)
5fb024
trunk Identity Models Tpl:                     See 3.10.     (line  949)
5fb024
trunk Identity Models Tpl Promo Web:           See 3.11.     (line  970)
5fb024
trunk Identity Models Xcf:                     See 3.12.     (line 1284)
5fb024
trunk Identity Release:                        See 3.13.     (line 1305)
5fb024
trunk Identity Themes:                         See 3.14.     (line 1322)
5fb024
trunk Identity Themes Models:                  See 3.15.     (line 1347)
5fb024
trunk Identity Themes Models Alternative:      See 3.16.     (line 1380)
5fb024
trunk Identity Themes Models Default:          See 3.17.     (line 1407)
5fb024
trunk Identity Themes Models Default Distro:   See 3.18.     (line 1439)
5fb024
trunk Identity Themes Models Default Distro Anaconda:See 3.19.
5fb024
                                                             (line 1523)
5fb024
trunk Identity Themes Models Default Promo:    See 3.20.     (line 1540)
5fb024
trunk Identity Themes Models Default Web:      See 3.21.     (line 1566)
5fb024
trunk Identity Themes Motifs:                  See 3.22.     (line 1591)
5fb024
trunk Identity Themes Motifs Modern Backgrounds:See 3.23.    (line 1695)
5fb024
trunk Identity Themes Motifs Modern Backgrounds Img:See 3.24.
5fb024
                                                             (line 1817)
5fb024
trunk Identity Themes Motifs Modern Backgrounds Tpl:See 3.25.
5fb024
                                                             (line 1838)
5fb024
trunk Identity Themes Motifs Modern Backgrounds Xcf:See 3.26.
5fb024
                                                             (line 1859)
5fb024
trunk Identity Themes Motifs Modern Distro Anaconda Progress:See 3.27.
5fb024
                                                             (line 1886)
5fb024
trunk Identity Themes Motifs Modern Palettes:  See 3.28.     (line 1942)
5fb024
trunk Identity Themes Motifs TreeFlower:       See 3.29.     (line 1964)
5fb024
trunk Identity Widgets:                        See 3.30.     (line 1981)
5fb024
trunk Manuals:                                 See 3.31.     (line 1998)
5fb024
trunk Scripts:                                 See 3.32.     (line 2052)
5fb024
trunk Scripts Bash:                            See 3.33.     (line 2076)
5fb024
trunk Scripts Bash Config Identity:            See 3.34.     (line 2241)
5fb024
trunk Scripts Bash Config Translations:        See 3.35.     (line 2262)
5fb024
trunk Scripts Bash Functions:                  See 3.36.     (line 2283)
5fb024
trunk Scripts Bash Functions Config:           See 3.37.     (line 2304)
5fb024
trunk Scripts Bash Functions Config cli_getActions.sh:See 3.39.
5fb024
                                                             (line 2317)
5fb024
trunk Scripts Bash Functions Config cli_getActionsIdentity.sh:See 3.38.
5fb024
                                                             (line 2310)
5fb024
trunk Scripts Bash Functions Config cli_getActionsTranslations.sh:See 3.40.
1e9202
                                                             (line 2323)
5fb024
trunk Scripts Bash Functions Config cli_getIdentityMatchinglist.sh:See 3.41.
5fb024
                                                             (line 2330)
5fb024
trunk Scripts Bash Functions Config repo_renderIdentitySyslinux.sh:See 3.42.
5fb024
                                                             (line 2339)
5fb024
trunk Scripts Bash Functions Prepare prepare_forUsingPackages.sh:See 3.43.
5fb024
                                                             (line 2360)
5fb024
trunk Scripts Bash Functions Render:           See 3.44.     (line 2381)
5fb024
trunk Scripts Bash Functions Render Config:    See 3.45.     (line 2402)
5fb024
trunk Scripts Bash Functions Render render_getActions.sh:See 3.47.
5fb024
                                                             (line 2601)
5fb024
trunk Scripts Bash Functions Render render_getActionsIdentity.sh:See 3.46.
5fb024
                                                             (line 2580)
5fb024
trunk Scripts Bash Functions Render render_getActionsTranslations.sh:See 3.48.
5fb024
                                                             (line 2622)
5fb024
trunk Scripts Bash Locale:                     See 3.49.     (line 2643)
5fb024
trunk Scripts Perl:                            See 3.50.     (line 2727)
5fb024
trunk Scripts Python:                          See 3.51.     (line 2744)
5fb024
trunk Translations:                            See 3.52.     (line 2765)
5fb024
trunk Translations Identity:                   See 3.53.     (line 3368)
5fb024
trunk Translations Identity Brands:            See 3.54.     (line 3389)
5fb024
trunk Translations Identity Brands Tpl:        See 3.55.     (line 3484)
5fb024
trunk Translations Identity Fonts:             See 3.56.     (line 3499)
5fb024
trunk Translations Identity Models:            See 3.57.     (line 3566)
5fb024
trunk Translations Identity Release:           See 3.58.     (line 3581)
5fb024
trunk Translations Identity Themes:            See 3.59.     (line 3596)
5fb024
trunk Translations Identity Themes Backgrounds:See 3.60.     (line 3611)
5fb024
trunk Translations Identity Themes Distro Anaconda Progress:See 3.61.
5fb024
                                                             (line 3632)
5fb024
trunk Translations Identity Widgets:           See 3.62.     (line 3725)
4c79b5
List of Figures
4c79b5
***************
4c79b5