Blame Manuals/Repository/repository-html/repository_56.html

4c79b5
4c79b5
<html>
ccb7a3
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
-->
bf28e1
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>
2c3589
<title>CentOS Artwork Repository: 3.53 trunk/Scripts/Bash/Functions/Render</title>
4c79b5
2c3589
<meta name="description" content="CentOS Artwork Repository: 3.53 trunk/Scripts/Bash/Functions/Render">
2c3589
<meta name="keywords" content="CentOS Artwork Repository: 3.53 trunk/Scripts/Bash/Functions/Render">
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
2c3589
[ < ]
2c3589
[ > ]
4c79b5
   
300762
[ << ]
300762
[ Up ]
2c3589
[ >> ]
4c79b5
   
4c79b5
   
4c79b5
   
4c79b5
   
4c79b5
[Top]
4c79b5
[Contents]
2c3589
[Index]
4c79b5
[ ? ]
4c79b5
2c3589
2c3589
2c3589

3.53 trunk/Scripts/Bash/Functions/Render

7e35dc
2c3589

The render functionality exists to produce both identity and

2c3589
translation files on different levels of information (i.e., different
2c3589
languages, release numbers, architectures, etc.).
2c3589

2c3589

The render functionality relies on "renderable directory

2c3589
structures" to produce files. Renderable directory structures can be
2c3589
either "identity directory structures" or "translation directory
2c3589
structures" with special directories inside.
2c3589

7e35dc
2c3589
2c3589

3.53.1 Renderable identity directory structures

7e35dc
2c3589

Renderable identity directory structures are the starting point of

2c3589
identity rendition. Whenever we want to render a component of CentOS
2c3589
corporate visual identity, we need to point <tt>`centos-art.sh'</tt> to a
2c3589
renderable identity directory structure. If such renderable identity
2c3589
directory structure doesn't exist, then it is good time to create it. 
2c3589

2c3589

Inside the working copy, one renderable identity directory structures

2c3589
represents one visual manifestation of CentOS corporate visual
2c3589
identity, or said differently, each visual manifestation of CentOS
2c3589
corporate visual identity should have one renderable identity
2c3589
directory structure.
2c3589

2c3589

Inside renderable identity directory structures, <tt>`centos-art.sh'</tt>

2c3589
can render both image-based and text-based files. Specification of
2c3589
whether a renderable identity directory structure produces image-based
2c3589
or text-based content is a configuration action that takes place in
2c3589
the pre-rendition configuration script of that renderable identity
2c3589
directory structure.
2c3589

2c3589

Inside renderable identity directory structures, content production is

2c3589
organized in different configurations. A content production
2c3589
configuration is a unique combination of the components that make an
2c3589
identity directory structure renderable. One content production
2c3589
configuration does one thing only (e.g., to produce untranslated
2c3589
images), but it can be extended (e.g., adding translation files) to
2c3589
achieve different needs (e.g., to produce translated images).
2c3589

7e35dc
2c3589
2c3589

3.53.1.1 Design template without translation

7e35dc
2c3589

The design template without translation configuration is based on a

2c3589
renderable identity directory structure with an empty translation
2c3589
directory structure. In this configuration, one design template
2c3589
produces one untranslated file. Both design templates and final
2c3589
untranslated files share the same file name, but they differ one
2c3589
another in file-type and file-extension.
2c3589

2c3589

For example, to produce images without translations (there is no much

2c3589
use in producing text-based files without translations), consider the
2c3589
following configuration:
2c3589

2c3589
2c3589
One renderable identity directory structure:
2c3589
2c3589

In this example we used <tt>`Identity/Path/To/Dir'</tt> as the identity

2c3589
component we want to produce untranslated images for.  Identity
2c3589
components can be either under <tt>`trunk/'</tt> or <tt>`branches/'</tt>
2c3589
directory structure.
2c3589

2c3589

The identity component (i.e., <tt>`Identity/Path/To/Dir'</tt>, in this

2c3589
case) is also the bond component we use to connect the identity
2c3589
directory structures with their respective auxiliar directories (i.e.,
2c3589
translation directory structres and pre-rendition configuration
2c3589
structures).  The bond component is the path convenction that
2c3589
<tt>`centos-art.sh'</tt> uses to know where to look for related
2c3589
translations, configuration scripts and whatever auxiliar thing a
2c3589
renderable directory structure may need to have.
2c3589

2c3589
      | The bond component
2c3589
      |----------------->|
2c3589
trunk/Identity/Path/To/Dir  <-- Renderable identity directory structure.
2c3589
|-- Tpl                     <-- Design template directory.
2c3589
|   `-- file.svg            <-- Design template file.
2c3589
`-- Img                     <-- Directory used to store final files.
2c3589
    `-- file.png            <-- Final image-based file produced from
2c3589
                                design template file.
2c3589
2c3589

Inside design template directory, design template files are based on

2c3589
SVG (Scalable Vector Graphics) and use the extension
2c3589
.svg.  Design template files can be organized using several
2c3589
directory levels to create a simple but extensible configuration,
2c3589
specially if translated images are not required.
2c3589

2c3589

In order for SVG (Scalable Vector Graphics) files to be

2c3589
considered "design template" files, they should be placed under the
2c3589
design template directory and to have set a CENTOSARTWORK
2c3589
object id inside.
2c3589

2c3589

The CENTOSARTWORK word itself is a convenction name we use to

2c3589
define which object/design area, inside a design template, the
2c3589
<tt>`centos-art.sh'</tt> script will use to export as
2c3589
PNG (Portable Network Graphic) image at rendition time.
2c3589
Whithout such object id specification, the <tt>`centos-art.sh'</tt> script
2c3589
cannot know what object/design area you (as designer) want to export
2c3589
as PNG (Portable Network Graphic) image file.
2c3589

2c3589
info

Note

At rendition time, the content of <tt>`Img/'</tt> directory

2c3589
structure is produced by <tt>`centos-art.sh'</tt> automatically.
2c3589

7e35dc
2c3589

When a renderable identity directory structure is configured to

2c3589
produce image-based content, <tt>`centos-art.sh'</tt> produces
2c3589
PNG (Portable Network Graphics) files with the .png
2c3589
extension. Once the base image format has been produced, it is
2c3589
possible for <tt>`centos-art.sh'</tt> to use it in order to automatically
2c3589
create other image formats that may be needed (see section trunk/Scripts/Bash/Functions/Render/Config).
2c3589

2c3589

Inside the working copy, you can find an example of "design template

2c3589
without translation" configuration at <tt>`trunk/Identity/Models/'</tt>.
2c3589

2c3589

See section trunk/Identity, for more information.

2c3589

2c3589
2c3589
One translation directory structure:
2c3589
2c3589

In order for an identity entry to be considered an identity renderable

2c3589
directory structure, it should have a translation entry. The content
2c3589
of the translation entry is relevant to determine how to process the
2c3589
identity renderable directory entry.
2c3589

2c3589

If the translation entry is empty (i.e., there is no file inside it),

2c3589
<tt>`centos-art.sh'</tt> interprets the identity renderable directory
2c3589
structure as a "design templates without translation" configuration.
2c3589

2c3589
                   | The bond component
2c3589
                   |----------------->|
2c3589
trunk/Translations/Identity/Path/To/Dir
2c3589
`-- (empty)
2c3589
2c3589

If the translation entry is not empty, <tt>`centos-art.sh'</tt> can

2c3589
interpret the identity renderable directory structure as one of the
2c3589
following configurations: "design template with translation
2c3589
(one-to-one)" or "design template with translation (optimized)".
2c3589
Which one of these configurations is used depends on the value
2c3589
assigned to the matching list (MATCHINGLIST) variable in the
2c3589
pre-rendition configuration script of the renderable identity
2c3589
directory structure we are producing images for.
2c3589

2c3589

If the matching list variable is empty (as it is by default), then

2c3589
"design template with translation (one-to-one)" configuration is
2c3589
used. In this configuration it is required that both design templates
2c3589
and translation files have the same file names. This way, one
2c3589
translation files is applied to one design template, to produce
2c3589
one translated image.
2c3589

2c3589

If the matching list variable is not empty (because you redefine it in

2c3589
the pre-rendition configuration script), then "design template with
2c3589
translation (optimized)" configuration is used instead. In this
2c3589
configuration, design templates and translation files don't need to
2c3589
have the same names since such name relationship between them is
2c3589
specified in the matching list properly.
2c3589

2c3589

-- Removed(xref:trunk Translations) --, for more information.

2c3589

2c3589
2c3589
One pre-rendition configuration script:
2c3589
2c3589

In order to make an identity directory structure renderable, a

2c3589
pre-rendition configuration script should exist for it.  The
2c3589
pre-rendition configuration script specifies what type of rendition
2c3589
does <tt>`centos-art.sh'</tt> will perform over the identity directory
2c3589
structure and how does it do that.
2c3589

2c3589
                                           | The bond component
2c3589
                                           |----------------->|
2c3589
trunk/Scripts/Bash/Functions/Render/Config/Identity/Path/To/Dir
2c3589
`-- render.conf.sh
2c3589
2c3589

In this configuration the pre-rendition configuration script

2c3589
(<tt>`render.conf.sh'</tt>) would look like the following:
2c3589

2c3589
function render_loadConfig {
2c3589
2c3589
    # Define rendition actions.
2c3589
    ACTIONS[0]='BASE:renderImage'
2c3589
2c3589
}
2c3589
2c3589

Since translation directory structure is empty, <tt>`centos-art.sh'</tt>

2c3589
assumes a "design template without translation" configuration to
2c3589
produce untranslated images.
2c3589

2c3589

To produce untranslated images, <tt>`centos-art.sh'</tt> takes one design

2c3589
template and creates one temporal instance from it.  Later,
2c3589
<tt>`centos-art.sh'</tt> uses the temporal design template instance as
2c3589
source file to export the final untranslated image. The action of
2c3589
exporting images from SVG (Scalable Vector Graphics) to
2c3589
PNG (Portable Network Graphics) is possible thanks to
2c3589
Inkscape's command-line interface and the CENTOSARTWORK object
2c3589
id we previously set inside design templates.
2c3589

2c3589
centos-art.sh render --identity=trunk/Identity/Path/To/Dir
2c3589
-------------------------------------------------
2c3589
0 | Execute centos-art.sh on renderable identity directory structure.
2c3589
--v----------------------------------------------
2c3589
trunk/Identity/Path/To/Dir/Tpl/file.svg
2c3589
-------------------------------------------------
2c3589
1 | Create instance from design template.
2c3589
--v----------------------------------------------
2c3589
/tmp/centos-art.sh-a07e824a-5953-4c21-90ae-f5e8e9781f5f-file.svg
2c3589
-------------------------------------------------
2c3589
2 | Render untranslated image from design template instance.
2c3589
--v----------------------------------------------
2c3589
trunk/Identity/NewDir/Img/file.png
2c3589
-------------------------------------------------
2c3589
3 | Remove design template instance.
2c3589
2c3589

Finally, when the untranslated image has been created, the temporal

2c3589
design template instance is removed. At this point,
2c3589
<tt>`centos-art.sh'</tt> takes the next design template and repeats the
2c3589
whole production flow once again (design template by design template),
2c3589
until all design templates be processed.
2c3589

2c3589

See section trunk/Scripts/Bash/Functions/Render/Config, for more

2c3589
information.
2c3589

2c3589
2c3589
2c3589
2c3589
2c3589

3.53.1.2 Design template with translation (one-to-one)

2c3589
2c3589

Producing untranslated images is fine in many cases, but not always.

2c3589
Sometimes it is required to produce images in different languages and
2c3589
that is something that untrasnlated image production cannot achieve.
2c3589
However, if we fill its empty translation entry with translation files
2c3589
(one for each design template) we extend the production flow from
2c3589
untranslated image production to translated image production.
2c3589

2c3589

In order for <tt>`centos-art.sh'</tt> to produce images correctly, each

2c3589
design template should have one translation file and each translation
2c3589
file should have one design template.  Otherwise, if there is a
2c3589
missing design template or a missing translation file,
2c3589
<tt>`centos-art.sh'</tt> will not produce the final image related to the
2c3589
missing component.
2c3589

2c3589

In order for <tt>`centos-art.sh'</tt> to know which is the relation

2c3589
between translation files and design templates the translation
2c3589
directory structure is taken as reference.  For example, the
2c3589
<tt>`trunk/Translations/Identity/Path/To/Dir/file.sed'</tt> translation
2c3589
file does match <tt>`trunk/Identity/Path/To/Dir/Tpl/file.svg'</tt> design
2c3589
template, but it doesn't match
2c3589
<tt>`trunk/Identity/Path/To/Dir/File.svg'</tt> or
2c3589
<tt>`trunk/Identity/Path/To/Dir/Tpl/File.svg'</tt> or
2c3589
<tt>`trunk/Identity/Path/To/Dir/Tpl/SubDir/file.svg'</tt> design
2c3589
templates.
2c3589

2c3589

The pre-rendition configuration script used to produce untranslated

2c3589
images is the same we use to produce translated images. There is no
2c3589
need to modify it. So, as we are using the same pre-rendition
2c3589
configuration script, we can say that translated image production is
2c3589
somehow an extended/improved version of untranslated image production.
2c3589

2c3589
info

Note

If we use no translation file in the translation entry

2c3589
(i.e., an empty directory), <tt>`centos-art.sh'</tt> assumes the
2c3589
untranslated image production. If we fill the translation entry with
2c3589
translation files, <tt>`centos-art.sh'</tt> assumes the translated image
2c3589
production.  
2c3589

2c3589
2c3589

To produce final images, <tt>`centos-art.sh'</tt> applies one translation

2c3589
file to one design template and produce a translated design template
2c3589
instance. Later, <tt>`centos-art.sh'</tt> uses the translated template
2c3589
instance to produce the translated image. Finally, when the translated
2c3589
image has been produced, <tt>`centos-art.sh'</tt> removes the translated
2c3589
design template instance. This production flow is repeated for each
2c3589
translation file available in the translatio entry. 
2c3589

2c3589
centos-art.sh render --identity=trunk/Identity/Path/To/Dir
2c3589
-------------------------------------------------
2c3589
0 | Execute centos-art.sh on directory structure.
2c3589
--v----------------------------------------------
2c3589
trunk/Translations/Identity/Path/To/Dir/file.sed
2c3589
-------------------------------------------------
2c3589
1 | Apply translation to design template.
2c3589
--v----------------------------------------------
2c3589
trunk/Identity/Path/To/Dir/Tpl/file.svg
2c3589
-------------------------------------------------
2c3589
2 | Create design template instance.
2c3589
--v----------------------------------------------
2c3589
/tmp/centos-art.sh-a07e824a-5953-4c21-90ae-f5e8e9781f5f-file.svg
2c3589
-------------------------------------------------
2c3589
3 | Render PNG image from template instance.
2c3589
--v----------------------------------------------
2c3589
trunk/Identity/NewDir/Img/file.png
2c3589
-------------------------------------------------
2c3589
4 | Remove design template instance.
2c3589
2c3589
2c3589
2c3589

3.53.1.3 Design template with translation (optimized)

2c3589
2c3589

Producing translated images satisfies almost all our production images

2c3589
needs, but there is still a pitfall in them. In order to produce
2c3589
translated images as in the "one-to-one" configuration describes
2c3589
previously, it is required that one translation file has one design
2c3589
template. That's useful in many cases, but what would happen if we
2c3589
need to apply many different translation files to the same design
2c3589
template?  Should we have to duplicate the same design template file
2c3589
for each translation file, in order to satisfy the "one-to-one"
2c3589
relation? What if we need to assign translation files to design
2c3589
templates arbitrarily?
2c3589

2c3589

Certenly, that's something the "one-to-one" configuration cannot

2c3589
handle.  So, that's why we had to "optimize" it. The optimized
2c3589
configuration consists on using a matching list (MATCHINGLIST)
2c3589
variable that specifies the relationship between translation files and
2c3589
design templates in an arbitrary way. Using such matching list between
2c3589
translation files and design templates let us use as many assignment
2c3589
combinations as translation files and design templates we are working
2c3589
with.
2c3589

2c3589

The MATCHINGLIST variable is set in the pre-rendition

2c3589
configuration script of the component we want to produce images for.
2c3589
By default, the MATCHINGLIST variable is empty which means no
2c3589
matching list is used. Otherwise, if MATCHINGLIST variable has a
2c3589
value different to empty value then, <tt>`centos-art.sh'</tt> interprets
2c3589
the matching list in order to know how translation files are applied
2c3589
to design templates.
2c3589

2c3589

For example, consider the following configuration:

2c3589

2c3589
2c3589
One entry under <tt>`trunk/Identity/'</tt>:
2c3589
2c3589

In this configuration we want to produce three images using a

2c3589
paragraph-based style, controlled by <tt>`paragraph.svg'</tt> design
2c3589
template; and one image using a list-based style, controlled by
2c3589
<tt>`list.svg'</tt> design template.
2c3589

2c3589
trunk/Identity/Path/To/Dir
2c3589
|-- Tpl
2c3589
|   |-- paragraph.svg
2c3589
|   `-- list.svg
2c3589
`-- Img
2c3589
    |-- 01-welcome.png
2c3589
    |-- 02-donate.png
2c3589
    |-- 03-docs.png
2c3589
    `-- 04-support.png
2c3589
2c3589
2c3589
One entry under <tt>`trunk/Translations/'</tt>:
2c3589
2c3589

In order to produce translated images we need to have one translation

2c3589
file for each translated image we want to produce. Notice how
2c3589
translation names do match final image file names, but how translation
2c3589
names do not match design template names. When we use matching list
2c3589
there is no need for translation files to match the names of design
2c3589
templates, such name relation is set inside the matching list itself.
2c3589

2c3589
trunk/Translations/Identity/Path/To/Dir
2c3589
|-- 01-welcome.sed
2c3589
|-- 02-donate.sed
2c3589
|-- 03-docs.sed
2c3589
`-- 04-support.sed
2c3589
2c3589
2c3589
One entry under <tt>`trunk/trunk/Scripts/Bash/Functions/Render/Config/'</tt>:
2c3589
2c3589

In order to produce different translated images using specific design

2c3589
templates, we need to specify the relation between translation files
2c3589
and design templates in a way that <tt>`centos-art.sh'</tt> could know
2c3589
exactly what translation file to apply to what design template. This
2c3589
relation between translation files and design templates is set using
2c3589
the matching list MATCHINGLIST variable inside the pre-rendition
2c3589
configuration script of the component we want to produce images for.  
2c3589

2c3589
trunk/Scripts/Bash/Functions/Render/Config/Identity/Path/To/Dir
2c3589
`-- render.conf.sh
2c3589
2c3589

In this configuration the pre-rendition configuration script

2c3589
(<tt>`render.conf.sh'</tt>) would look like the following:
2c3589

2c3589
function render_loadConfig {
2c3589
2c3589
    # Define rendition actions.
2c3589
    ACTIONS[0]='BASE:renderImage'
7e35dc
2c3589
    # Define matching list.
2c3589
    MATCHINGLIST="\
2c3589
    paragraph.svg:\
2c3589
        01-welcome.sed\
2c3589
        02-donate.sed\
2c3589
        04-support.sed
2c3589
    list.svg:\
2c3589
        03-docs.sed
2c3589
    "
2c3589
2c3589
}
2c3589
2c3589

As result, <tt>`centos-art.sh'</tt> will produce <tt>`01-welcome.png'</tt>,

2c3589
<tt>`02-donate.png'</tt> and <tt>`04-support.png'</tt> using the
2c3589
paragraph-based design template, but <tt>`03-docs.png'</tt> using the
2c3589
list-based design template.
2c3589

2c3589
2c3589
2c3589
2c3589
2c3589

3.53.1.4 Design template with translation (optimized+flexibility)

2c3589
2c3589

In the production models we've seen so far, there are design templates

2c3589
to produce untranslated images and translation files which combiend
2c3589
with design templates produce translated images. That may seems like
2c3589
all our needs are covered, doesn't it? Well, it almost does.
2c3589

2c3589

Generally, we use design templates to define how final images will

2c3589
look like. Generally, each renderable directory structure has one
2c3589
<tt>`Tpl/'</tt> directory where we organize design templates for that
2c3589
identity component. So, we can say that there is only one unique
2c3589
design template definition for each identity component; or what is the
2c3589
same, said differently, identity components can be produced in one way
2c3589
only, the way its own design template directory specifies.  This is
2c3589
not enough for theme production. It is a limitation, indeed.
2c3589

2c3589

Initially, to create one theme, we created one renderable directory

2c3589
structure for each theme component. When we found ourselves with many
2c3589
themes, and components inside them, it was obvious that the same
2c3589
design model was duplicated inside each theme. As design models were
2c3589
independently one another, if we changed one theme's design model,
2c3589
that change was useless to other themes. So, in order to reuse design
2c3589
model changes, we unified design models into one common directory
2c3589
structure.
2c3589

2c3589

With design models unified in a common structure, another problem rose

2c3589
up. As design models also had the visual style of theme components,
2c3589
there was no difference between themes, so there was no apparent need
2c3589
to have an independent theme directory structure for each different
2c3589
theme.  So, it was also needed to separate visual styles from design
2c3589
models.
2c3589

2c3589

At this point there are two independent worklines: one directory

2c3589
structure to store design models (the final image characteristics
2c3589
[i.e., dimensions, translation markers, etc.]) and one directory
2c3589
structure to store visual styles (the final image visual style [i.e.,
2c3589
the image look and feel]).  So, it is possible to handle both
2c3589
different design models and different visual styles independtly one
2c3589
another and later create combinations among them using
2c3589
<tt>`centos-art.sh'</tt>. 
2c3589

2c3589

For example, consider the following configuration:

2c3589

2c3589
2c3589
One entry under <tt>`trunk/Identity/Themes/Models/'</tt>:
2c3589
2c3589

The design model entry exists to organize design model files (similar

2c3589
to design templates). Both design models and design templates are very
2c3589
similar; they both should have the CENTOSARTWORK export id
2c3589
present to identify the exportation area, translation marks, etc.
2c3589
However, design models do use dynamic backgrounds inclusion while
2c3589
design templates don't.
2c3589

2c3589
                        THEMEMODEL | | The bond component
2c3589
                             |<----| |--------------------->|
2c3589
trunk/Identity/Themes/Models/Default/Distro/Anaconda/Progress/
2c3589
|-- paragraph.svg
2c3589
`-- list.svg
2c3589
2c3589

Inisde design models, dynamic backgrounds are required in order for

2c3589
different artistic motifs to reuse common design models. Firstly, in
2c3589
order to create dynamic backgrounds inside design models, we import a
2c3589
bitmap to cover design model's background and later, update design
2c3589
model's path information to replace fixed values to dynamic values.
2c3589

2c3589
2c3589
One entry under <tt>`trunk/Identity/Themes/Motifs/'</tt>:
2c3589
2c3589

The artistic motif entry defines the visual style we want to produce

2c3589
images for, only. Final images (i.e., those built from combining both
2c3589
design models and artistic motif backrounds) are not stored here, but
2c3589
under branches directory structure. In the artistic motif entry, we
2c3589
only define those images that cannot be produced automatically by
2c3589
<tt>`centos-art.sh'</tt> (e.g., Backgrounds, Color information,
2c3589
Screenshots, etc.).
2c3589

2c3589
                  Artistic motif name | | Artistic motif backgrounds
2c3589
                             |<-------| |-------->|
2c3589
trunk/Identity/Themes/Motifs/TreeFlower/Backgrounds/
2c3589
|-- Img
2c3589
|   |-- Png
2c3589
|   |   |-- 510x300.png
2c3589
|   |   `-- 510x300-final.png
2c3589
|   `-- Jpg
2c3589
|       |-- 510x300.jpg
2c3589
|       `-- 510x300-final.jpg
2c3589
|-- Tpl
2c3589
|   `-- 510x300.svg
2c3589
`-- Xcf
2c3589
    `-- 510x300.xcf
2c3589
2c3589
2c3589
One entry under <tt>`trunk/Translations/'</tt>:
2c3589
2c3589

The translation entry specifies, by means of translation files, the

2c3589
language-specific information we want to produce image for. When we
2c3589
create the translation entry we don't use the name of neither design
2c3589
model nor artistic motif, just the design model component we want to
2c3589
produce images for.
2c3589

2c3589
                                   | The bond component
2c3589
                                   |--------------------->|
2c3589
trunk/Translations/Identity/Themes/Distro/Anaconda/Progress/
2c3589
`-- 5
2c3589
    |-- en
2c3589
    |   |-- 01-welcome.sed
2c3589
    |   |-- 02-donate.sed
2c3589
    |   `-- 03-docs.sed
2c3589
    `-- es
2c3589
        |-- 01-welcome.sed
2c3589
        |-- 02-donate.sed
2c3589
        `-- 03-docs.sed
2c3589
2c3589
2c3589
One entry under <tt>`trunk/Scripts/Bash/Functions/Render/Config/'</tt>:
2c3589
2c3589

There is one pre-rendition configuration script for each theme

2c3589
component. So, each time a theme component is rendered, its
2c3589
pre-rendition configuration script is evaluated to teach
2c3589
<tt>`centos-art.sh'</tt> how to render the component.
2c3589

2c3589
trunk/Scripts/Bash/Functions/Render/Config/Identity/Themes/Distro/Anaconda/Progress/
2c3589
`-- render.conf.sh
2c3589
2c3589

In this configuration the pre-rendition configuration script

2c3589
(<tt>`render.conf.sh'</tt>) would look like the following:
2c3589

2c3589
function render_loadConfig {
2c3589
2c3589
    # Define rendition actions.
2c3589
    ACTIONS[0]='BASE:renderImage'
2c3589
2c3589
    # Define matching list.
2c3589
    MATCHINGLIST="\
2c3589
    paragraph.svg:\
2c3589
        01-welcome.sed\
2c3589
        02-donate.sed
2c3589
    list.svg:\
2c3589
        03-docs.sed
2c3589
        "
2c3589
2c3589
    # Deifne theme model.
2c3589
    THEMEMODEL='Default'
2c3589
2c3589
}
2c3589
2c3589
2c3589
2c3589

The production flow of "optimize+flexibility" configuration…

2c3589

2c3589
2c3589

3.53.2 Renderable translation directory structures

2c3589
2c3589

Translation directory structures are auxiliar structures of renderable

2c3589
identity directory structures. There is one translation directory
2c3589
structure for each renderable identity directory structure.  Inside
2c3589
translation directory structures we organize translation files used by
2c3589
renderable identity directory structures that produce translated
2c3589
images. Renderable identity directory structures that produce
2c3589
untranslated images don't use translation files, but they do use a
2c3589
translation directory structure, an empty translation directory
2c3589
structure, to be precise.
2c3589

2c3589

In order to aliviate production of translation file, we made

2c3589
translation directory structures renderable adding a template
2c3589
(<tt>`Tpl/'</tt>) directory structure to handle common content inside
2c3589
translation files.  This way, we work on translation templates and
2c3589
later use <tt>`centos-art.sh'</tt> to produce specific translation files
2c3589
(based on translation templates) for different information (e.g.,
2c3589
languages, release numbers, architectures, etc.).  
2c3589

2c3589

If for some reason, translation files get far from translation

2c3589
templates and translation templates become incovenient to produce such
2c3589
translation files then, care should be taken to avoid replacing the
2c3589
content of translation files with the content of translation templates
2c3589
when <tt>`centos-art.sh'</tt> is executed to produce translation files
2c3589
from translation templates.
2c3589

2c3589

Inside renderable translation directory structures,

2c3589
<tt>`centos-art.sh'</tt> can produce text-based files only.
2c3589

2c3589
2c3589
2c3589

3.53.3 Copying renderable directory structures

2c3589
2c3589

A renderable layout is formed by design models, design images,

2c3589
pre-rendition configuration scripts and translations files. This way,
2c3589
when we say to duplicate rendition stuff we are saying to duplicate
2c3589
these four directory structures (i.e., design models, design images,
2c3589
pre-rendition configuration scripts, and related translations files).
2c3589

2c3589

When we duplicate directories, inside `trunk/Identity' directory

2c3589
structure, we need to be aware of renderable layout described above
2c3589
and the source location used to perform the duplication action.  The
2c3589
source location is relevant to centos-art.sh script in order to
2c3589
determine the required auxiliar information inside directory
2c3589
structures that need to be copied too (otherwise we may end up with
2c3589
orphan directory structures unable to be rendered, due the absence of
2c3589
required information).
2c3589

2c3589

In order for a renderable directory structure to be valid, the new

2c3589
directory structure copied should match the following conditions:
2c3589

2c3589
    2c3589
  1. To have a unique directory structure under
  2. 2c3589
    <tt>`trunk/Identity'</tt>, organized by any one of the above
    2c3589
    organizational designs above.
    2c3589
    2c3589
  3. To have a unique directory structure under
  4. 2c3589
    <tt>`trunk/Translations'</tt> to store translation files.
    2c3589
    2c3589
  5. To have a unique directory structure under
  6. 2c3589
    <tt>`trunk/Scripts/Bash/Functions/Render/Config'</tt> to set pre-rendition
    2c3589
    configuration script.
    2c3589
    2c3589
    2c3589

    As convenction, the render_doCopy function uses

    2c3589
    <tt>`trunk/Identity'</tt> directory structure as source location.  Once
    2c3589
    the <tt>`trunk/Identity'</tt> directory structure has been specified and
    2c3589
    verified, the related path information is built from it and copied
    2c3589
    automatically to the new location specified by FLAG_TO variable.
    2c3589

    2c3589

    Design templates + No translation:

    2c3589

    2c3589

    Command:

    2c3589
    - centos-art render -copy=trunk/Identity/Path/To/Dir -to=trunk/Identity/NewPath/To/Dir
    2c3589

    2c3589

    Sources:

    2c3589
    - trunk/Identity/Path/To/Dir
    2c3589
    - trunk/Translations/Identity/Path/To/Dir
    2c3589
    - trunk/Scripts/Bash/Functions/Render/Config/Identity/Path/To/Dir
    2c3589

    2c3589

    Targets:

    2c3589
    - trunk/Identity/NewPath/To/Dir
    2c3589
    - trunk/Translations/Identity/NewPath/To/Dir
    2c3589
    - trunk/Scripts/Bash/Functions/Render/Config/Identity/NewPath/To/Dir
    2c3589

    2c3589

    Renderable layout 2:

    2c3589

    2c3589

    Command:

    2c3589
    - centos-art render -copy=trunk/Identity/Themes/Motifs/TreeFlower \
    2c3589
                        -to=trunk/Identity/Themes/Motifs/NewPath/To/Dir
    2c3589

    2c3589

    Sources:

    2c3589
    - trunk/Identity/Themes/Motifs/TreeFlower
    2c3589
    - trunk/Translations/Identity/Themes
    2c3589
    - trunk/Translations/Identity/Themes/Motifs/TreeFlower
    2c3589
    - trunk/Scripts/Bash/Functions/Render/Config/Identity/Themes
    2c3589
    - trunk/Scripts/Bash/Functions/Render/Config/Identity/Themes/Motifs/TreeFlower
    2c3589

    2c3589

    Targets:

    2c3589
    - trunk/Identity/Themes/Motifs/NewPath/To/Dir
    2c3589
    - trunk/Translations/Identity/Themes
    2c3589
    - trunk/Translations/Identity/Themes/Motifs/NewPath/To/Dir
    2c3589
    - trunk/Scripts/Bash/Functions/Render/Config/Identity/Themes
    2c3589
    - trunk/Scripts/Bash/Functions/Render/Config/Identity/Themes/Motifs/NewPath/To/Dir
    2c3589

    2c3589

    Notice that design models are not included in source or target

    2c3589
    locations. This is intentional. In "Renderable layout 2", design
    2c3589
    models live by their own, they just exist, they are there, available
    2c3589
    for any artistic motif to use. By default `Themes/Models/Default'
    2c3589
    design model directory structure is used, but other design models
    2c3589
    directory structures (under Themes/Models/) can be created and used
    2c3589
    changing the value of THEMEMODEL variable inside the pre-rendition
    2c3589
    configuration script of the artistic motif source location you want to
    2c3589
    produce.
    2c3589

    2c3589

    Notice how translations and pre-rendition configuration scripts may

    2c3589
    both be equal in source and target. This is because such structures
    2c3589
    are common to all artistic motifs (the default values to use when no
    2c3589
    specific values are provided).
    2c3589

    2c3589

    - The common directory structures are not copied or deleted. We cannot

    2c3589
      copy a directory structure to itself.
    2c3589

    2c3589

    - The common directory structures represent the default value to use

    2c3589
      when no specific translations and/or pre-rendition configuration
    2c3589
      script are provided inside source location.
    2c3589

    2c3589

    - The specific directory structures, if present, are both copiable and

    2c3589
      removable. This is, when you perform a copy or delete action from
    2c3589
      source, that source specific auxiliar directories are transfered in
    2c3589
      the copy action to a new location (that specified by FLAG_TO
    2c3589
      variable).
    2c3589

    2c3589

    - When translations and/or pre-rendition configuration scripts are

    2c3589
      found inside the source directory structure, the centos-art.sh
    2c3589
      script loads common auxiliar directories first and later specific
    2c3589
      auxiliar directories.  This way, identity rendition of source
    2c3589
      locations can be customized idividually over the base of common
    2c3589
      default values.
    2c3589

    2c3589

    - The specific auxiliar directories are optional.

    2c3589

    2c3589

    - The common auxiliar directories should be present always. This is,

    2c3589
      in order to provide the information required by render functionality
    2c3589
      (i.e., to make it functional in the more basic level of its
    2c3589
      existence).
    2c3589

    2c3589

    Notice how the duplication process is done from `trunk/Identity' on,

    2c3589
    not the oposite. If you try to duplicate a translation structure (or
    2c3589
    similar auxiliar directory structures like pre-rendition configuration
    2c3589
    scripts), the `trunk/Identity' for that translation is not created.
    2c3589
    This limitation is impossed by the fact that many `trunk/Identity'
    2c3589
    directory structures may reuse/share the same translation directory
    2c3589
    structure. We cannot delete one translation (or similar) directory
    2c3589
    structures while a related `trunk/Identity/' directory structure is
    2c3589
    still in need of it.
    2c3589

    2c3589

    The `render_doCopy' functionality does duplicate directory structures

    2c3589
    directly involved in rendition process only. Once such directories
    2c3589
    have been duplicated, the functionality stops thereat. 
    2c3589

    7e35dc
    2c3589
    2c3589

    3.53.4 Usage

    4a9d2a
    d11e55
      d11e55
    • ...
    • d11e55
      4a9d2a
      2dc146
      2c3589
      2c3589

      3.53.5 See also

      300762
      2c3589
      2c3589
      3.54 trunk/Scripts/Bash/Functions/Render/Config  
      2c3589
      2c3589
      4c79b5
      4c79b5
      4c79b5
      2c3589
      [ < ]
      2c3589
      [ > ]
      4c79b5
         
      300762
      [ << ]
      2c3589
      [ Up ]
      2c3589
      [ >> ]
      4c79b5
      4c79b5

      4c79b5
       <font size="-1">
      bf28e1
        This document was generated on February, 27 2011 using texi2html 1.76.
      4c79b5
       </font>
      4c79b5
       
      4c79b5
      4c79b5

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