Blame Manual/repository-latex/centos-art.sh-latex/Distribution/Anaconda/Firstboot/framework.tex

0668a4
\section{Identity}
0668a4
\hypertarget{sec:Distribution:Anaconda:Firstboot:Identity}{}
0668a4
\label{sec:Distribution:Anaconda:Firstboot:Identity}
0668a4
0668a4
\begin{description}
0668a4
\item[framework:]
0668a4
trunk/Identity/Themes/\$THEME/Distro/Anaconda/Firstboot/
0668a4
\end{description}
0668a4
0668a4
\noindent Here is where CentOS firstboot design templates and image
0668a4
rendering take place. Firstboot identity file structure is illustrated
0668a4
in \autoref{fig:Distribution:Anaconda:Firstboot:Identity} and
0668a4
described in the following sections.
0668a4
0668a4
\begin{figure}
0668a4
\hrulefill
0668a4
\begin{verbatim}
0668a4
trunk/Identity/Themes/$THEME/Distro/Anaconda/Firstboot/
0668a4
|-- img
0668a4
|   |-- 3
0668a4
|   |   `-- splash-small.png
0668a4
|   |-- 4
0668a4
|   |   `-- splash-small.png
0668a4
|   |-- 5
0668a4
|   |   `-- splash-small.png
0668a4
|   |-- ... (more releases here)
0668a4
|   `-- firstboot-left.png
0668a4
|-- render.sh
0668a4
`-- tpl
0668a4
    |-- firstboot-left.svg
0668a4
        `-- splash-small.svg
0668a4
\end{verbatim}
0668a4
\hrulefill
0668a4
\caption{Firstboot identity framework.%
0668a4
   \label{fig:Distribution:Anaconda:Firstboot:Identity}}
0668a4
\end{figure}
0668a4
0668a4
\subsection{Design Templates}
0668a4
0668a4
\begin{description}
0668a4
\item[framework:]
0668a4
trunk/Identity/Themes/\$THEME/Distro/Anaconda/Firstboot/Tpl/
0668a4
\end{description}
0668a4
0668a4
\noindent Here is where Firstboot design templates are stored.
0668a4
Firstboot design templates control Firstboot's visual style. 
0668a4
0668a4
\begin{description}
0668a4
0668a4
\item[firstboot-left.svg:] This design is common for all major
0668a4
releases of CentOS Distribution. It is visible in all firstboot
0668a4
screens. In
0668a4
\autoref{fig:Distribution:Anaconda:Firstboot:Identity:Models}, this
0668a4
design is illustraded by the number 8.
0668a4
0668a4
\item[splash-small.svg:] This design is specific for each major
0668a4
release of CentOS Distribution.  There is one splash-small.png image
0668a4
for each major release of CentOS Distribution. This image is visible
0668a4
only in the first (Welcome) screen of Firstboot. In
0668a4
\autoref{fig:Distribution:Anaconda:Firstboot:Identity:Models}, this
0668a4
design is illustraded by number 5.
0668a4
0668a4
\end{description}
0668a4
0668a4
\subsection{Design Models}
0668a4
0668a4
\begin{description}
0668a4
\item[framework:]
0668a4
trunk/Identity/Models/Distro/Anaconda/Firstboot/
0668a4
\end{description}
0668a4
0668a4
\noindent Here is where firstboot design models are stored. Firstboot
0668a4
design model is shown in
0668a4
\autoref{fig:Distribution:Anaconda:Firstboot:Identity:Models} and described
0668a4
below: 
0668a4
0668a4
\begin{figure}
0668a4
\begin{center}
0668a4
\fbox{\includegraphics[width=0.8\textwidth]{%
0668a4
../Identity/Models/Img/en/Distro/Anaconda/Firstboot/splash-small.pdf}}
0668a4
\end{center}
0668a4
\caption{Firstboot design model.%
0668a4
   \label{fig:Distribution:Anaconda:Firstboot:Identity:Models}}
0668a4
\end{figure}
0668a4
0668a4
\begin{description}
0668a4
0668a4
\item[1:] List of labels and a pointer showing in which configuration
0668a4
screen you are.
0668a4
0668a4
\item[2:] Screen icon. The screen icon is visible in all firstboot
0668a4
screens. Each firsboot screen may have its own screen icon.
0668a4
0668a4
\item[3:] Screen label.
0668a4
0668a4
\item[4:] Screen description. 
0668a4
0668a4
\item[5:] Splash image (splash-small.png). The splash
0668a4
image is visible in firstboot welcome screen only.
0668a4
0668a4
\item[6:] Configuration stuff.
0668a4
0668a4
\item[7:] Navigation area. Basically two buttons to navegate
0668a4
configuration back and forward.
0668a4
0668a4
\item[8:] List of labels' background image (firtboot-left.png).  This
0668a4
image is visible in all firstboot screens.
0668a4
0668a4
\end{description}
0668a4
0668a4
\subsection{Image Files}
0668a4
\hypertarget{sec:Distribution:Anaconda:Firstboot:Identity:Images}{}
0668a4
\label{sec:Distribution:Anaconda:Firstboot:Identity:Images}
0668a4
0668a4
\begin{description}
0668a4
\item[framework:]
0668a4
trunk/Identity/Themes/\$THEME/Distro/Anaconda/Firstboot/Img/
0668a4
\end{description}
0668a4
0668a4
\noindent Here is where firstboot final images are stored. 
0668a4
0668a4
\subsection{Image Files Rendering}
0668a4
\hypertarget{sec:Distribution:Anaconda:Firstboot:Identity:ImagesRendering}{}
0668a4
\label{sec:Distribution:Anaconda:Firstboot:Identity:ImagesRendering}
0668a4
0668a4
\begin{description}
0668a4
\item[framework:]
0668a4
trunk/Identity/Themes/\$THEME/Distro/Anaconda/Firstboot/
0668a4
\end{description}
0668a4
0668a4
\noindent Here is where you produce firstboot images. The following
0668a4
rendering examples, based on
0668a4
\autoref{fig:Distribution:Anaconda:Firstboot:Translations}, illustrate
0668a4
the firstboot image files rendering process.\\
0668a4
\\
0668a4
\fbox{\texttt{./render.sh}}\\
0668a4
\\
0668a4
\fbox{\texttt{./render.sh '(5|6)/splash'}}\\
0668a4
\\
0668a4
\fbox{\texttt{./render.sh '(firstboot-left|5|4)/splash'}}
0668a4
0668a4
\section{Translations}
0668a4
\hypertarget{sec:Distribution:Anaconda:Firstboot:Translations}{}
0668a4
\label{sec:Distribution:Anaconda:Firstboot:Translations}
0668a4
0668a4
\begin{description}
0668a4
\item[framework:]
0668a4
trunk/Translations/Identity/Themes/Distro/Anaconda/Firstboot
0668a4
\end{description}
0668a4
0668a4
\noindent Here is where translators locale firstboot images. Image
0668a4
localization is defined inside .sed files, also known as translation
0668a4
files.  Translation files can be common or specific. The given
0668a4
organization of translation files defines the translation path.
0668a4
0668a4
\begin{figure}[!hbp]
0668a4
\hrulefill
0668a4
\begin{verbatim}
0668a4
trunk/Translations/Identity/Themes/Distro/Anaconda/Firstboot
0668a4
|-- 3
0668a4
|   `-- splash-small.sed
0668a4
|-- 4
0668a4
|   `-- splash-small.sed
0668a4
|-- 5
0668a4
|   `-- splash-small.sed
0668a4
|-- ... (more release directories)
0668a4
`-- firstboot-left.sed
0668a4
\end{verbatim}
0668a4
\hrulefill
0668a4
\caption{Firstboot translation path.%
0668a4
   \label{fig:Distribution:Anaconda:Firstboot:Translations}}
0668a4
\end{figure}
0668a4
0668a4
\subsection{Translation Markers}
0668a4
0668a4
In firstboot, markers are used in the file splash-small.svg only,
0668a4
specifically to set the major release number of CentOS Distribution in
0668a4
CentOS Release Brand. Since firstboot-left.svg design is common for
0668a4
all CentOS Distribution there is no need to set any marker on it.
0668a4
0668a4
Markers used in firstboot design templates and translation files are
0668a4
described in \autoref{tab:Distribution:Anaconda:Firstboot:Markers}.
0668a4
0668a4
\begin{table}
0668a4
\centering
0668a4
\begin{tabular}{rl}
0668a4
\hline
0668a4
\textbf{Marker} & \textbf{Description}\\
0668a4
\hline
0668a4
=MAJOR\_RELEASE= & Major release number of CentOS Distribution.\\
0668a4
\hline
0668a4
\end{tabular}
0668a4
\caption{Firstboot translation markers.%
0668a4
   \label{tab:Distribution:Anaconda:Firstboot:Markers}}
0668a4
\end{table}
0668a4
0668a4
\section{Manuals}
0668a4
\hypertarget{sec:Distribution:Anaconda:Firstboot:Manuals}{}
0668a4
\label{sec:Distribution:Anaconda:Firstboot:Manuals}
0668a4
0668a4
\begin{description}
0668a4
\item[framework:]
0668a4
trunk/Manuals/Distribution/Anaconda/Firstboot/
0668a4
\end{description}
0668a4
0668a4
\noindent Here is where firstboot documentation is stored.  If you
0668a4
want to help improving Firstboot documentation this is the place you
0668a4
need to go.
0668a4
0668a4
\section{Scripts}
0668a4
\hypertarget{sec:Distribution:Anaconda:Firstboot:Scripts}{}
0668a4
0668a4
\begin{description}
0668a4
\item[framework:] trunk/Scripts/Config/Identity/Themes/Distro/Anaconda/Firstboot/
0668a4
\end{description}
0668a4
0668a4
\noindent Here is stored the Firstboot \texttt{render.conf.sh}
0668a4
configuration script.  To render Firstboot images correctly, the
0668a4
\texttt{ARTCOMP} configuration variable inside Anaconda progress
0668a4
configuration script should be defined as illustrated in
0668a4
\autoref{fig:Distribution:Anaconda:Firstboot:Scripts:Config}. 
0668a4
0668a4
\begin{figure}
0668a4
\hrulefill
0668a4
\begin{verbatim}
0668a4
# Define artwork component.
0668a4
ARTCOMP='Identity/Themes/Distro/Anaconda/Firstboot'
0668a4
\end{verbatim}
0668a4
\hrulefill
0668a4
\caption{Firstboot configuration layout.%
0668a4
   \label{fig:Distribution:Anaconda:Firstboot:Scripts:Config}}
0668a4
\end{figure}
0668a4