Blame Manual/repository-latex/Distribution/Anaconda/Progress/framework.tex

4c79b5
%    Part: Distribution
4c79b5
% Chapter: Anaconda progress - Framework
4c79b5
% ------------------------------------------------------------
4c79b5
% $Id: framework.tex 6207 2010-08-05 13:11:13Z al $
4c79b5
% ------------------------------------------------------------
4c79b5
    \section{Identity}
4c79b5
\hypertarget{sec:Distribution:Anaconda:Progress:Identity}{}
4c79b5
      \label{sec:Distribution:Anaconda:Progress:Identity}
4c79b5
4c79b5
\begin{description}
4c79b5
\item[framework:] trunk/Identity/Themes/\$THEME/Distro/Anaconda/Progress/
4c79b5
\end{description}
4c79b5
4c79b5
\noindent Anaconda progress identity's framework is stored here.
4c79b5
Anaconda progress identity's framework is illustrated in
4c79b5
\autoref{fig:Distribution:Anaconda:Progress:Identity} and described in
4c79b5
the following sections.
4c79b5
4c79b5
\begin{figure}
4c79b5
\hrulefill
4c79b5
\begin{verbatim}
4c79b5
trunk/Identity/Themes/$THEME/Distro/Anaconda/Progress/
4c79b5
|-- img
4c79b5
|   |-- 3
4c79b5
|   |   |-- bn_IN
4c79b5
|   |   |   |-- 01-welcome.png
4c79b5
|   |   |   |-- 02-donate.png
4c79b5
|   |   |   |-- 03-yum.png
4c79b5
|   |   |   `-- ... (more bn_IN language-specific images)
4c79b5
|   |   |-- cs
4c79b5
|   |   |   |-- 01-welcome.png
4c79b5
|   |   |   |-- 02-donate.png
4c79b5
|   |   |   |-- 03-yum.png
4c79b5
|   |   |   `-- ... (more cs language-specific images)
4c79b5
|   |   |-- ... (more languages here)
4c79b5
|   |   |-- first-lowres.png
4c79b5
|   |   |-- first.png
4c79b5
|   |   |-- ... (more language directories)
4c79b5
|   |   |-- progress_first-lowres.png
4c79b5
|   |   |-- progress_first.png
4c79b5
|   |   `-- ... (more language directories)
4c79b5
|   |-- 4
4c79b5
|   |-- 5
4c79b5
|   `-- ... (more release directories)
4c79b5
|-- render.sh
4c79b5
`-- tpl
4c79b5
    |-- first-lowres.svg
4c79b5
    |-- first.svg
4c79b5
    |-- list.svg
4c79b5
    `-- paragraph.svg
4c79b5
\end{verbatim}
4c79b5
\hrulefill
4c79b5
\caption{Anaconda progress identity's framework.%
4c79b5
   \label{fig:Distribution:Anaconda:Progress:Identity}}
4c79b5
\end{figure}
4c79b5
4c79b5
% ------------------------------------------------------------
4c79b5
 \subsection{Design Templates}
4c79b5
\hypertarget{sec:Distribution:Anaconda:Progress:Identity:Templates}{}
4c79b5
      \label{sec:Distribution:Anaconda:Progress:Identity:Templates}
4c79b5
4c79b5
\begin{description}
4c79b5
\item[framework:] trunk/Identity/Themes/\$THEME/Distro/Anaconda/Progress/Tpl/
4c79b5
\end{description}
4c79b5
4c79b5
\noindent Anaconda progress design templates are stored here.
4c79b5
Anaconda progress design templates are organized in: Anaconda progress
4c79b5
first slide and Anaconda progress language-specific slides set of
4c79b5
images.
4c79b5
4c79b5
Anaconda progress first slide is the one used to open the package
4c79b5
installation process.  Anaconda progress first slide design has no
4c79b5
translation. It is used just as it is, no matter what the current
4c79b5
Anaconda's installation language be.  Anaconda progress first slide
4c79b5
design is controlled by \texttt{first.svg}, and
4c79b5
\texttt{first-lowres.svg} design templates
4c79b5
(\autoref{fig:Distribution:Anaconda:Progress:Identity:Models:First}).
4c79b5
If the screen resolution is less than 800 x 600 pixels, the
4c79b5
\texttt{first-lowres.svg} design is used. If the screen resolution is
4c79b5
equal or greater that 800 x 600 pixels, the \texttt{first.svg} design
4c79b5
is used.
4c79b5
4c79b5
Anaconda progress language-specific slides set of images start to
4c79b5
rotate a few seconds after progress first slide.  Anaconda progress
4c79b5
language-specific slides set of images design is defined by
4c79b5
\texttt{list.svg}
4c79b5
(\autoref{fig:Distribution:Anaconda:Progress:Identity:Models:Paragraph})
4c79b5
and \texttt{paragraph.svg}
4c79b5
(\autoref{fig:Distribution:Anaconda:Progress:Identity:Models:List})
4c79b5
design templates. 
4c79b5
4c79b5
Anaconda progress language-specific slides set of images resumes
4c79b5
relevant features coming on the CentOS distribution that is being
4c79b5
installed.  As graphic designer, you need not to care very much about
4c79b5
translating Anaconda progress language-specific slides set of images,
4c79b5
this is job for translators.  As graphic designer, most of your
4c79b5
attention is focused on how the slides set of images looks like.
4c79b5
4c79b5
Anaconda progress language-specific slides set of images are loaded
4c79b5
based on Anaconda's installation language.  By default, Anaconda's
4c79b5
installation language is English. But you can change Anaconda's
4c79b5
default language in the screen ``Installation Language'' to whatever
4c79b5
your preferred language be. 
4c79b5
4c79b5
If Anaconda's installation language is English, Anaconda progress
4c79b5
language-specific slides set of images are loaded in English.  If
4c79b5
Anaconda's installation language is different from English, Anaconda
4c79b5
looks for the language-specific slides set of images that matches the
4c79b5
current Anaconda's installation language and uses them in the
4c79b5
rotation, if that slides set of images exists of course.  If there is
4c79b5
no language-specific slides set of images available for the current
4c79b5
Anaconda's installation language, Anaconda uses the English slides set
4c79b5
of images.
4c79b5
4c79b5
To verify the final look and feel of your Anaconda progress slide
4c79b5
images, you need to render them. To render Anaconda progress slide
4c79b5
images you use the \texttt{render.sh} identity script as described in
4c79b5
``\hyperlink{sec:Distribution:Anaconda:Progress:Identity:Image:Rendering}{Image
4c79b5
Files Rendering}''
4c79b5
(\autoref{sec:Distribution:Anaconda:Progress:Identity:Image:Rendering}).
4c79b5
The \texttt{render.sh} identity script helps you automate the
4c79b5
rendering process of Anaconda progress slide images.
4c79b5
4c79b5
% ------------------------------------------------------------
4c79b5
 \subsection{Design Models}
4c79b5
\hypertarget{sec:Distribution:Anaconda:Progress:Identity:Models}{}
4c79b5
      \label{sec:Distribution:Anaconda:Progress:Identity:Models}
4c79b5
4c79b5
\begin{description}
4c79b5
\item[framework:] trunk/Identity/Models/Tpl/Distro/Anaconda/Progress/
4c79b5
\end{description}
4c79b5
4c79b5
\noindent Anaconda progress design models are stored here.  Anaconda
4c79b5
progress design models are described in
4c79b5
\autoref{fig:Distribution:Anaconda:Progress:Identity:Models:Slides},
4c79b5
\autoref{fig:Distribution:Anaconda:Progress:Identity:Models:Release},
4c79b5
\autoref{fig:Distribution:Anaconda:Progress:Identity:Models:First},
4c79b5
\autoref{fig:Distribution:Anaconda:Progress:Identity:Models:Paragraph},
4c79b5
and \autoref{fig:Distribution:Anaconda:Progress:Identity:Models:List}.
4c79b5
4c79b5
\begin{figure}[!hbp]
4c79b5
\begin{center}
4c79b5
\fbox{\includegraphics[width=0.8\textwidth]{%
4c79b5
../Identity/Models/Img/en/Distro/Anaconda/Progress/view-1.pdf}}
4c79b5
\end{center}
4c79b5
\caption[Anaconda progress design model]{Anaconda progress design\
4c79b5
model. A = ``Header'', B = ``Slide rotation'', C =\
4c79b5
``Action/Navigation''.%
4c79b5
   \label{fig:Distribution:Anaconda:Progress:Identity:Models:Slides}}
4c79b5
\end{figure}
4c79b5
4c79b5
\begin{figure}[!hbp]
4c79b5
\begin{center}
4c79b5
\fbox{\includegraphics[width=0.8\textwidth]{%
4c79b5
../Identity/Models/Img/en/Distro/Anaconda/Progress/view-2.pdf}}
4c79b5
\end{center}
4c79b5
\caption[Anaconda progress release notes]{Anaconda progress release\
4c79b5
notes. A = ``Release notes'', B = ``Action/Navigation''.%
4c79b5
   \label{fig:Distribution:Anaconda:Progress:Identity:Models:Release}}
4c79b5
\end{figure}
4c79b5
4c79b5
4c79b5
\begin{figure}[!hbp]
4c79b5
\begin{center}
4c79b5
\includegraphics[width=0.8\textwidth]{%
4c79b5
../Identity/Models/Img/en/Distro/Anaconda/Progress/first.pdf}
4c79b5
\end{center}
4c79b5
\caption[Anaconda progress first slide template]{Anaconda progress\
4c79b5
first slide template. A = ``The CentOS Symbol'', B = ``The CentOS\
4c79b5
Default Artistic Motif'', C = ``The CentOS Release Brand'', D = ``The\
4c79b5
CentOS Copyright''.%
4c79b5
   \label{fig:Distribution:Anaconda:Progress:Identity:Models:First}}
4c79b5
\end{figure}
4c79b5
4c79b5
\begin{figure}[!hbp]
4c79b5
\begin{center}
4c79b5
\includegraphics[width=0.8\textwidth]{%
4c79b5
../Identity/Models/Img/en/Distro/Anaconda/Progress/list.pdf}
4c79b5
\end{center}
4c79b5
\caption{Anaconda progress list template.%
4c79b5
   \label{fig:Distribution:Anaconda:Progress:Identity:Models:Paragraph}}
4c79b5
\end{figure}
4c79b5
4c79b5
\begin{figure}[!hbp]
4c79b5
\begin{center}
4c79b5
\includegraphics[width=0.8\textwidth]{%
4c79b5
../Identity/Models/Img/en/Distro/Anaconda/Progress/paragraph.pdf}
4c79b5
\end{center}
4c79b5
\caption{Anaconda progress paragraph template.%
4c79b5
   \label{fig:Distribution:Anaconda:Progress:Identity:Models:List}}
4c79b5
\end{figure}
4c79b5
4c79b5
% ------------------------------------------------------------
4c79b5
 \subsection{Image Files}
4c79b5
\hypertarget{sec:Distribution:Anaconda:Progress:Identity:Image}{}
4c79b5
      \label{sec:Distribution:Anaconda:Progress:Identity:Image}
4c79b5
4c79b5
\begin{description}
4c79b5
\item[framework:] trunk/Identity/Themes/\$THEME/Distro/Anaconda/Progress/Img/
4c79b5
\end{description}
4c79b5
4c79b5
\noindent Anaconda progress final images are stored here.
4c79b5
4c79b5
% ------------------------------------------------------------
4c79b5
 \subsection{Image Files Rendering}
4c79b5
\hypertarget{sec:Distribution:Anaconda:Progress:Identity:Image:Rendering}{}
4c79b5
      \label{sec:Distribution:Anaconda:Progress:Identity:Image:Rendering}
4c79b5
4c79b5
\begin{description}
4c79b5
\item[framework:] trunk/Identity/Themes/\$THEME/Distro/Anaconda/Progress/
4c79b5
\end{description}
4c79b5
4c79b5
\noindent Here is where you produce Anaconda progress slide images.
4c79b5
Take a look at the following rendering examples based on the
4c79b5
translation path shown in
4c79b5
\autoref{fig:Distribution:Anaconda:Progress:Translations}:\\
4c79b5
\\
4c79b5
\fbox{\texttt{./render.sh}}\\
4c79b5
\\
4c79b5
\fbox{\texttt{./render.sh '5'}}\\
4c79b5
\\
4c79b5
\fbox{\texttt{./render.sh '(3|4|5)'}}\\
4c79b5
\\
4c79b5
\fbox{\texttt{./render.sh '5/(progress|first|en)'}}\\
4c79b5
\\
4c79b5
\fbox{\texttt{./render.sh '(4|5)/(progress|first|en|es)'}}\\
4c79b5
\\
4c79b5
\fbox{\texttt{./render.sh '(4|5)/(en|es)/01-welcome'}}
4c79b5
4c79b5
% ------------------------------------------------------------
4c79b5
    \section{Translations}
4c79b5
\hypertarget{sec:Distribution:Anaconda:Progress:Translations}{}
4c79b5
      \label{sec:Distribution:Anaconda:Progress:Translations}{}
4c79b5
4c79b5
\begin{description}
4c79b5
\item[framework:] trunk/Translations/Identity/Themes/Distro/Anaconda/Progress/
4c79b5
\end{description}
4c79b5
4c79b5
\noindent Here is where translators locale Anaconda progress
4c79b5
language-specific slide set of images. Anaconda progress translation
4c79b5
framework is illustrated in
4c79b5
\autoref{fig:Distribution:Anaconda:Progress:Translations}.  Anaconda
4c79b5
progress translation framework defines the Anaconda progress slide
4c79b5
images translation path.  The translation path shown in
4c79b5
\autoref{fig:Distribution:Anaconda:Progress:Translations} is an
4c79b5
incomplet version of the real one.  It was cropped in the sake of
4c79b5
keeping it in just one page.  To make yourself a better idea of the
4c79b5
real Anaconda progress translation path, check the one inside your
4c79b5
working copy of CentOS Artwork Repository. That is the one you should
4c79b5
use in order to build your REGEX patterns when rendering Anaconda
4c79b5
progress slide images.
4c79b5
4c79b5
\begin{figure}
4c79b5
\hrulefill
4c79b5
\begin{verbatim}
4c79b5
trunk/Translations/Identity/Themes/Distro/Anaconda/Progress/
4c79b5
|-- 3
4c79b5
|   |-- bn_IN
4c79b5
|   |   |-- 01-welcome.sed
4c79b5
|   |   |-- 02-donate.sed
4c79b5
|   |   |-- 03-yum.sed
4c79b5
|   |   `-- ... (more bn_IN translation files)
4c79b5
|   |-- ... (more language directories)
4c79b5
|   |-- first-lowres.sed
4c79b5
|   |-- first.sed
4c79b5
|   |-- ... (more language directories)
4c79b5
|   |-- progress_first-lowres.sed
4c79b5
|   |-- progress_first.sed
4c79b5
|   `-- ... (more language directories)
4c79b5
|-- 4
4c79b5
|-- 5
4c79b5
|-- ... (more release directories)
4c79b5
|-- render.sh
4c79b5
`-- tpl
4c79b5
    |-- bn_IN
4c79b5
    |   |-- 01-welcome.sed
4c79b5
    |   |-- 02-donate.sed
4c79b5
    |   |-- 03-yum.sed
4c79b5
    |   `-- ... (more bn_IN translation files)
4c79b5
    |-- ... (more language directories)
4c79b5
    |-- first-lowres.sed
4c79b5
    |-- first.sed
4c79b5
    |-- ... (more language directories)
4c79b5
    |-- progress_first-lowres.sed
4c79b5
    |-- progress_first.sed
4c79b5
    `-- ... (more language directories)
4c79b5
\end{verbatim}
4c79b5
\hrulefill
4c79b5
\caption{Anaconda progress translation framework.%
4c79b5
   \label{fig:Distribution:Anaconda:Progress:Translations}}
4c79b5
\end{figure}
4c79b5
4c79b5
% ------------------------------------------------------------
4c79b5
 \subsection{Translation Markers}
4c79b5
\hypertarget{sec:Distribution:Anaconda:Progress:Translations:Markers}{}
4c79b5
      \label{sec:Distribution:Anaconda:Progress:Translations:Markers}
4c79b5
4c79b5
In Anaconda progress, translation files and design templates use the
4c79b5
translation markers specified in
4c79b5
\autoref{tab:Distribution:Identity:Markers}. 
4c79b5
4c79b5
\begin{table}[!hbp]
4c79b5
\centering
4c79b5
\begin{tabular}{ll}
4c79b5
\hline
4c79b5
\textbf{Marker}& \textbf{Description}\\
4c79b5
\hline
4c79b5
=TITLE=          & Slide's title.\\
4c79b5
=DESCRIPTION=    & Slide's list description.\\
4c79b5
=TEXT1-12=       & Slide's content.\\
4c79b5
=URL=            & Slide's URL.\\
4c79b5
=COPYRIGHT=      & Copyright notice.\\
4c79b5
=RELEASE=        & CentOS Distribution full release number.\\
4c79b5
=MAJOR\_RELEASE= & CentOS Distribution major release number.\\
4c79b5
=MINOR\_RELEASE= & CentOS Distribution update release number.\\
4c79b5
\hline
4c79b5
\end{tabular}
4c79b5
\caption{Anaconda progress translation markers.%
4c79b5
   \label{tab:Distribution:Identity:Markers}}
4c79b5
\end{table}
4c79b5
4c79b5
% ------------------------------------------------------------
4c79b5
    \section{Manuals}
4c79b5
\hypertarget{sec:Distribution:Anaconda:Progress:Manuals}{}
4c79b5
      \label{sec:Distribution:Anaconda:Progress:Manuals}
4c79b5
4c79b5
\begin{description}
4c79b5
\item[framework:] trunk/Manuals/Distribution/Anaconda/Progress/
4c79b5
\end{description}
4c79b5
4c79b5
\noindent Anaconda progress documentation files are prepared here.  If
4c79b5
you want to help improving Anaconda progress documentation this is
4c79b5
where you need to go.
4c79b5
4c79b5
% ------------------------------------------------------------
4c79b5
    \section{Scripts}
4c79b5
\hypertarget{sec:Distribution:Anaconda:Progress:Scripts}{}
4c79b5
      \label{sec:Distribution:Anaconda:Progress:Scripts}
4c79b5
4c79b5
\begin{description}
4c79b5
\item[framework:] trunk/Scripts/Config/Identity/Themes/Distro/Anaconda/Progress/
4c79b5
\end{description}
4c79b5
4c79b5
\noindent Here is stored the Anaconda progress \texttt{render.conf.sh}
4c79b5
configuration script.  To render Anaconda progress slide images
4c79b5
correctly, the \texttt{ARTCOMP} configuration variable inside Anaconda
4c79b5
progress configuration script should be defined as illustrated in
4c79b5
\autoref{fig:Distribution:Anaconda:Progress:Scripts:Config}. 
4c79b5
4c79b5
\begin{figure}
4c79b5
\hrulefill
4c79b5
\begin{verbatim}
4c79b5
# Define artwork component.
4c79b5
ARTCOMP='Distro/Anaconda/Progress'
4c79b5
\end{verbatim}
4c79b5
\hrulefill
4c79b5
\caption{Anaconda progress configuration layout.%
4c79b5
   \label{fig:Distribution:Anaconda:Progress:Scripts:Config}}
4c79b5
\end{figure}
4c79b5