|
|
3c5068 |
<sect1 id="repo-convs-worklines">
|
|
|
3c5068 |
|
|
|
3c5068 |
<title>Repository Work Lines</title>
|
|
|
3c5068 |
|
|
|
3c5068 |
<para>
|
|
|
3c5068 |
To organize content production inside &TCAR;, production has
|
|
|
3c5068 |
been divided into individual work lines that relate one
|
|
|
3c5068 |
another based on the idea of doing one thing well. Later, the
|
|
|
3c5068 |
results produced individually by each work line are combined
|
|
|
3c5068 |
to achieve a higher purpose. Work lines, as conceived here,
|
|
|
3c5068 |
provide the relayable output components the production cycle
|
|
|
3c5068 |
inside &TCAR; needs to let everyone to work syncronized in a
|
|
|
3c5068 |
descentralized environment.
|
|
|
3c5068 |
</para>
|
|
|
3c5068 |
|
|
|
3c5068 |
<sect2 id="repo-convs-worklines-idenity">
|
|
|
3c5068 |
|
|
|
3c5068 |
<title>Visual Identity</title>
|
|
|
3c5068 |
|
|
|
3c5068 |
<para>
|
|
|
3c5068 |
In the production cycle, the first step takes place through
|
|
|
3c5068 |
graphic design. It is focused on preparing design models for
|
|
|
3c5068 |
all the visual manifestation &TC;; is made of. Here, graphic
|
|
|
3c5068 |
designers describe the visual characteristics of each visual
|
|
|
3c5068 |
manifestation (e.g., image dimensions, position of text in the
|
|
|
3c5068 |
visible area, translation markers, etc.).
|
|
|
3c5068 |
Later, once design models have been defined, graphic designers
|
|
|
3c5068 |
take care of artistic motifs to define the visual style of
|
|
|
3c5068 |
those design models already created (e.g., how they look and
|
|
|
3c5068 |
feel).
|
|
|
3c5068 |
</para>
|
|
|
3c5068 |
|
|
|
3c5068 |
<para>
|
|
|
3c5068 |
Finally, graphic designers use the
|
|
|
3c5068 |
<function>render</function> functionality of
|
|
|
3c5068 |
<command>centos-art.sh</command> script to combine both design
|
|
|
3c5068 |
models and artistic motifs in order to produce the final
|
|
|
3c5068 |
images required by each visual manifestaions.
|
|
|
3c5068 |
</para>
|
|
|
3c5068 |
|
|
|
3c5068 |
</sect2>
|
|
|
3c5068 |
|
|
|
3c5068 |
<sect2 id="repo-convs-worklines-l10n">
|
|
|
3c5068 |
|
|
|
3c5068 |
<title>Localization</title>
|
|
|
3c5068 |
|
|
|
3c5068 |
<para>
|
|
|
3c5068 |
The second step in the production cycle is to localize
|
|
|
3c5068 |
source files (e.g., SVG, DocBook, Shell scripts). This step
|
|
|
3c5068 |
makes possible to produce localized images, localized
|
|
|
3c5068 |
documentation and localized automation scripts.
|
|
|
3c5068 |
</para>
|
|
|
3c5068 |
|
|
|
3c5068 |
<para>
|
|
|
3c5068 |
The localization tasks are carried on by translators using the
|
|
|
3c5068 |
<function>locale</function> functionality of the
|
|
|
3c5068 |
<command>centos-art.sh</command> script which take care of
|
|
|
3c5068 |
retriving translatable strings from source files and provide a
|
|
|
3c5068 |
consistent localization interface based on GNU
|
|
|
3c5068 |
<application>gettext</application> multi-lingual message
|
|
|
3c5068 |
production tool set and <command>xml2po</command> command.
|
|
|
3c5068 |
</para>
|
|
|
3c5068 |
|
|
|
3c5068 |
</sect2>
|
|
|
3c5068 |
|
|
|
3c5068 |
<sect2 id="repo-convs-worklines-manuals">
|
|
|
3c5068 |
|
|
|
3c5068 |
<title>Documentation</title>
|
|
|
3c5068 |
|
|
|
3c5068 |
<para>
|
|
|
3c5068 |
The third step in the production cycle is to document &TCAR;,
|
|
|
3c5068 |
what it is and how to use it. This step provides the
|
|
|
3c5068 |
conceptual ideas used as base to edificate &TCPCVI; and is
|
|
|
3c5068 |
implemented through &TCARUG;.
|
|
|
3c5068 |
</para>
|
|
|
3c5068 |
|
|
|
3c5068 |
<para>
|
|
|
3c5068 |
To write documentation, documentors use the
|
|
|
3c5068 |
<function>help</function> functionality of
|
|
|
3c5068 |
<command>centos-art.sh</command> script which provide an
|
|
|
3c5068 |
consistent interface for building documentation through
|
|
|
3c5068 |
different documentation backends (e.g., Texinfo and DocBook).
|
|
|
3c5068 |
</para>
|
|
|
3c5068 |
|
|
|
3c5068 |
</sect2>
|
|
|
3c5068 |
|
|
|
3c5068 |
<sect2 id="repo-convs-worklines-scripts">
|
|
|
3c5068 |
|
|
|
3c5068 |
<title>Automation</title>
|
|
|
3c5068 |
|
|
|
3c5068 |
<para>
|
|
|
3c5068 |
The fourth step in the production cycle is to automate
|
|
|
3c5068 |
frequent tasks inside &TCAR;. This step closes the production
|
|
|
3c5068 |
cycle and provides the production standards needed by all
|
|
|
3c5068 |
different work lines to coexist together. Here is where
|
|
|
3c5068 |
the <command>centos-art.sh</command> script and all
|
|
|
3c5068 |
its functionalities (e.g., <function>render</function> for
|
|
|
3c5068 |
rendition, <function>help</function> for documentation,
|
|
|
3c5068 |
<function>locale</function> for localization, etc.) are
|
|
|
3c5068 |
developed.
|
|
|
3c5068 |
</para>
|
|
|
3c5068 |
|
|
|
3c5068 |
<para>
|
|
|
3c5068 |
At this point it should be obvious, but we consider worth to
|
|
|
3c5068 |
remember that: there is no need to type several tasks, time
|
|
|
3c5068 |
after time, if they can be programmed into just one executable
|
|
|
3c5068 |
script.
|
|
|
3c5068 |
</para>
|
|
|
3c5068 |
|
|
|
3c5068 |
</sect2>
|
|
|
3c5068 |
|
|
|
3c5068 |
</sect1>
|