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

4c79b5
4c79b5
<html>
4c79b5
4c79b5
can you do inside it.
4c79b5
4c79b5
Copyright C 2009, 2010 CentOS Artwork SIG. All rights
4c79b5
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
-->
12494b
4c79b5
4c79b5
Written by: Lionel Cons <Lionel.Cons@cern.ch> (original author)
4c79b5
            Karl Berry  <karl@freefriends.org>
4c79b5
            Olaf Bachmann <obachman@mathematik.uni-kl.de>
4c79b5
            and many others.
4c79b5
Maintained by: Many creative people <dev@texi2html.cvshome.org>
4c79b5
Send bugs and suggestions to <users@texi2html.cvshome.org>
4c79b5
4c79b5
-->
4c79b5
<head>
4c79b5
<title>CentOS Artwork Repository: 3.1 trunk/Identity</title>
4c79b5
4c79b5
<meta name="description" content="CentOS Artwork Repository: 3.1 trunk/Identity">
4c79b5
<meta name="keywords" content="CentOS Artwork Repository: 3.1 trunk/Identity">
4c79b5
<meta name="resource-type" content="document">
4c79b5
<meta name="distribution" content="global">
4c79b5
<meta name="Generator" content="texi2html 1.76">
4c79b5
<meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
4c79b5
<style type="text/css">
4c79b5
1e9202
@import "/home/centos/artwork/trunk/Identity/Models/Css/Texi2html/common.css";
4c79b5
4c79b5
a.summary-letter {text-decoration: none}
4c79b5
pre.display {font-family: serif}
4c79b5
pre.format {font-family: serif}
4c79b5
pre.menu-comment {font-family: serif}
4c79b5
pre.menu-preformatted {font-family: serif}
4c79b5
pre.smalldisplay {font-family: serif; font-size: smaller}
4c79b5
pre.smallexample {font-size: smaller}
4c79b5
pre.smallformat {font-family: serif; font-size: smaller}
4c79b5
pre.smalllisp {font-size: smaller}
4c79b5
span.sansserif {font-family:sans-serif; font-weight:normal;}
4c79b5
ul.toc {list-style: none}
4c79b5
-->
4c79b5
</style>
4c79b5
4c79b5
4c79b5
</head>
4c79b5
4c79b5
<body lang="en" bgcolor="#FFFFFF" text="#000000" link="#0000FF" vlink="#800080" alink="#FF0000">
4c79b5
4c79b5
4c79b5
[ < ]
4c79b5
[ > ]
4c79b5
   
4c79b5
[ << ]
4c79b5
[ Up ]
b8013f
[ >> ]
4c79b5
   
4c79b5
   
4c79b5
   
4c79b5
   
4c79b5
[Top]
4c79b5
[Contents]
b8013f
[Index]
4c79b5
[ ? ]
4c79b5
4c79b5
4c79b5
4c79b5

3.1 trunk/Identity

4c79b5
4c79b5
4c79b5
4c79b5

3.1.1 Goals

4c79b5
4c79b5

The <tt>`trunk/Identity'</tt> directory exists to organize CentOS

4c79b5
corporate identity artworks. 
4c79b5

4c79b5
4c79b5
4c79b5

3.1.2 Description

4c79b5
4c79b5

The CentOS Project corporate identity is the "persona" of the

4c79b5
organization known as The CentOS Project.  The CentOS Project
4c79b5
corporate identity plays a significant role in the way the CentOS
4c79b5
Project, as organization, presents itself to both internal and
4c79b5
external stakeholders. In general terms, the CentOS Project corporate
4c79b5
visual identity expresses the values and ambitions of the CentOS
4c79b5
Project organization, its business, and its characteristics.  
4c79b5

4c79b5

The CentOS Project corporate identity provides visibility,

4c79b5
recognizability, reputation, structure and identification to the
4c79b5
CentOS 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
4c79b5
The CentOS Project uses one unique name (The CentOS Brand) and one
4c79b5
unique visual style (The CentOS Default Theme) in all its
4c79b5
manifestations. 
4c79b5

4c79b5
4c79b5
The CentOS Brands
4c79b5

The CentOS brand is the name or trademark that conncects the producer

4c79b5
with their products. In this case, the producer is The CentOS Project
4c79b5
and the products are the CentOS distributions, the CentOS web sites,
4c79b5
the CentOS promotion stuff, etc. 
4c79b5

4c79b5

See section trunk/Identity/Brands, for more information.

4c79b5

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 (e.g.,
4c79b5
distributions, websites, promotion stuff, etc.).
4c79b5

5fb024

See section trunk/Identity/Themes, for more information.

4c79b5

4c79b5
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
4c79b5
you are visiting websites, using the distribution, or acting on social
4c79b5
events, the one unique name and one unique visual style conect them
4c79b5
all to say: Hey! we are all parts of the CentOS project.  And,
4c79b5
probably, some vister will say: Can I join the party?  Yes you can, it
4c79b5
is free. :)
4c79b5

4c79b5
4c79b5
4c79b5

3.1.3 Usage

4c79b5
4c79b5

To produce identity artworks, use the following commands:

4c79b5

4c79b5
4c79b5
<samp>`centos-art render 'path/to/dir''</samp>
4c79b5
4c79b5

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

4c79b5
<tt>`trunk/Identity'</tt>, this command renders identity artworks using
4c79b5
both related design models and related translation files.
4c79b5

4c79b5
4c79b5
<samp>`centos-art render 'path/to/dir' --filter='pattern''</samp>
4c79b5
4c79b5

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

4c79b5
<tt>`trunk/Identity'</tt>, this command renders identity artworks using
4c79b5
both related design models and related translation files that match
4c79b5
the regular expression passed in <samp>`--filter='pattern''</samp> argument.
4c79b5

4c79b5

To control the number of files produced by centos-art

4c79b5
command, you need to look into the translation path and provide a
4c79b5
regular expression pattern that matches the translation path, or
4c79b5
paths, related to the file, or files, you want to produce.  
4c79b5

4c79b5

The regular expression pattern you provide to centos-art

4c79b5
command is applied to the translation path from its very beginning.
4c79b5
It is not the same to say <samp>`5/en/01-welcome'</samp> that
4c79b5
<samp>`01-welcome'</samp>, the frist expression matches but the last one does
4c79b5
not.
4c79b5

4c79b5

When using <samp>`--filter='pattern''</samp> you don't need to specify the

4c79b5
file extension. It is removed from translation path before applying
4c79b5
the pattern, so it doesn't count here.
4c79b5

4c79b5
4c79b5
4c79b5
4c79b5
4c79b5

3.1.4 Renderable directories

4c79b5
4c79b5

Inside <tt>`trunk/Identity'</tt>, renderable directories should have one

4c79b5
of the following directory layouts:
4c79b5

4c79b5
4c79b5
4c79b5

3.1.4.1 Layout 1: Simple image rendering

4c79b5
4c79b5

This directory layout contains one <tt>`Img/'</tt> directory (to store

4c79b5
final images), one <tt>`Tpl/'</tt> directory to store design templates,
4c79b5
and the translation entry is empty (there isn't translation files in
4c79b5
this configuration).  In this configuration, one design template
4c79b5
produces one untranslated PNG image, just as it is in the template.
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
4c79b5
4c79b5

3.1.4.2 Layout 2: Simple image rendering (extended)

4c79b5
4c79b5

This directory layout contains one <tt>`Img/'</tt> directory (to store

4c79b5
final images), one <tt>`Tpl/'</tt> directory to store design templates,
4c79b5
and the translation entry is empty (there isn't translation files in
4c79b5
this configuration).  When images are rendered, the <tt>`Img/'</tt>
4c79b5
directory structure is created automatically using the <tt>`Tpl/'</tt>
4c79b5
directory structure as reference.  In this configuration, one design
4c79b5
template produces one untranslated PNG image, just as it is in the
4c79b5
template.
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
4c79b5
4c79b5

3.1.4.3 Layout 3: Language specific image rendering

4c79b5
4c79b5

This directory layout extends previous one in order to produce

4c79b5
language-specific images.  This directory layout contains one
4c79b5
<tt>`Img/'</tt> directory (to store final images), one <tt>`Tpl/'</tt>
4c79b5
directory to store design templates, and the translation entry
4c79b5
contains translation files inside (organized by language codes). 
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 <tt>`Img/'</tt> directory structure is

4c79b5
created automatically using the translation entry structure as
4c79b5
reference (see above).  
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
4c79b5
the one design template path that matches it is used.  
4c79b5

4c79b5

If no design template is found for one 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
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
trunk/Identity/path/to/dir/Tpl/Corporate/monolithic.svg
4c79b5
4c79b5

in order to produce the following PNG image files:

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
4c79b5
4c79b5

3.1.4.4 Layout 4: Release and language specific image rendering

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 <tt>`Img/'</tt> directory (to store

4c79b5
final images), one <tt>`Tpl/'</tt> directory to store design templates,
4c79b5
and the translation entry contains translation files inside (organized
4c79b5
by language codes and major release numbers). 
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 <tt>`Img/'</tt> directory structure is

4c79b5
created automatically using the translation entry structure as
4c79b5
reference (see above).  
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
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
trunk/Identity/path/to/dir/Tpl/Corporate/monolithic.svg
4c79b5
4c79b5

in order to produce the following PNG image files:

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
4c79b5
4c79b5

3.1.4.5 Layout 5: Brands specific image rendering

4c79b5
4c79b5

See section trunk/Identity/Brands, for more information about themes

4c79b5
specific image rendering and directory layout.
4c79b5

4c79b5
4c79b5
4c79b5

3.1.4.6 Layout 6: Themes specific image rendering

4c79b5
5fb024

See section trunk/Identity/Themes, for more information about themes

4c79b5
specific image rendering and directory layout.
4c79b5

4c79b5
4c79b5
4c79b5

3.1.5 File name convenctions

4c79b5
4c79b5

As file name convenction, inside CentOS Artwork Repository, both

4c79b5
text-based and image-based file name produced by centos-art.sh
4c79b5
script has the same name of their translation files without
4c79b5
the <samp>`.sed'</samp> extension. The file extension is set as follow:
4c79b5

4c79b5
4c79b5
4c79b5

3.1.5.1 When text-based files are rendered

4c79b5
4c79b5

Text-based files end up having the same extension of their design

4c79b5
template file.
4c79b5

4c79b5
4c79b5
4c79b5

3.1.5.2 When image-based files are rendered

4c79b5
4c79b5

Image-based files always end up having the <tt>`.png'</tt> extension.

4c79b5

4c79b5
Info

Tip

Once <tt>`.png'</tt> images are created, other image formats

4c79b5
may be created using the renderFormats post-rendering
4c79b5
action, inside the image-based related pre-rendering configuration
4c79b5
script.
4c79b5

d06c98

See section trunk/Scripts/Bash, for more information.

4c79b5

4c79b5
4c79b5
4c79b5
4c79b5

3.1.6 See also

4c79b5
4c79b5
b8013f
3.51 trunk/Translations  
4c79b5
4c79b5
4c79b5
4c79b5
4c79b5
4c79b5

3.1.7 References

4c79b5
4c79b5
    1a6d31
  • http://en.wikipedia.org/Corporate_identity (and related
  • 4c79b5
    links).
    4c79b5
    4c79b5
    4c79b5
    4c79b5
    4c79b5
    4c79b5
    [ < ]
    4c79b5
    [ > ]
    4c79b5
       
    4c79b5
    [ << ]
    4c79b5
    [ Up ]
    b8013f
    [ >> ]
    4c79b5
    4c79b5

    4c79b5
     <font size="-1">
    12494b
      This document was generated on October, 29 2010 using texi2html 1.76.
    4c79b5
     </font>
    4c79b5
     
    4c79b5
    4c79b5

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