Blame Manuals/Repository/repository-latex/Distribution/Anaconda/Firstboot/rebranding.tex

4c79b5
\section{Rebranding}
4c79b5
4c79b5
\subsection{Package: redhat-logos}
4c79b5
4c79b5
The \texttt{redhat-logos} package contains files created by the CentOS
4c79b5
Project to replace the Red Hat ``Shadow Man'' logo and  RPM logo.  The
4c79b5
Red Hat ``Shadow Man'' logo, RPM, and the RPM logo are trademarks or
4c79b5
registered trademarks of Red Hat, Inc. Firstboot images that need to
4c79b5
be rebranded in \texttt{redhat-logos} package are illustrated in
4c79b5
\autoref{fig:Distribution:Anaconda:Firstboot:Rebranding:Logos}.
4c79b5
4c79b5
Replacements for these files are available in the Firstboot image
4c79b5
directory (
4c79b5
\autoref{sec:Distribution:Anaconda:Firstboot:Identity:Images}) of
4c79b5
Firstboot (\autoref{cha:Distribution:Anaconda:Firstboot}) inside your
4c79b5
working copy of CentOS Artwork Repository.
4c79b5
4c79b5
Once you rebrand the image files inside the SRPM package, you need to
4c79b5
rebuild it with the new brand information.
4c79b5
4c79b5
\subsection{Package: redhat-artwork}
4c79b5
4c79b5
The \texttt{redhat-artworks} package contains the themes and icons
4c79b5
that make up the CentOS default look and feel.  Relevant files to
4c79b5
firstboot rebranding are described below:
4c79b5
4c79b5
The following files in \texttt{redhat-artwork} need to be rebranded:
4c79b5
4c79b5
Once you rebrand the image files inside the \texttt{redhat-artwork}
4c79b5
SRPM package, you need to rebuild it with the new brand information.
4c79b5
4c79b5
\subsection{Package: firstboot}
4c79b5
4c79b5
Firstboot messages locale contains the upstream brand, so they need to
4c79b5
be rebranded too. The .po files you need to rebrand are inside the
4c79b5
firstboot package.  The \texttt{firstboot} package contains the
4c79b5
firstboot utility that runs after installation.  Once you rebrand the
4c79b5
content of .po files inside \texttt{firstboot} SRPM package, you need
4c79b5
to rebuild it with the new brand information.  The rebranded .mo files
4c79b5
are created in the installation process.
4c79b5
4c79b5
\subsection{Package: firstboot-tui}
4c79b5
4c79b5
The \texttt{firstboot-tui} package contains a text interface for the
4c79b5
\texttt{firstboot} package.  Once you rebrand the content of
4c79b5
\texttt{.po} files inside the \texttt{firstboot-tui} SRPM package, you
4c79b5
need to rebuild it with the new brand information.  The rebranded
4c79b5
\texttt{.mo} files are created in the installation process.
4c79b5
4c79b5
\subsection{Package: centos-release}
4c79b5
4c79b5
The CentOS License Agreement, shown after the welcome screen of
4c79b5
firstboot, is controled by the file \texttt{eula.en\_US} which is
4c79b5
controlled by the \texttt{centos-release} package.  The
4c79b5
\texttt{centos-release} package contains the CentOS release notes and
4c79b5
eula files.
4c79b5
4c79b5
The file \texttt{eula.en\_US} contains the English translation of
4c79b5
CentOS License Agreement. English language is the reference for
4c79b5
specific language translations of CentOS License Agreement. Specific
4c79b5
language translations of CentOS License Agreement are accepted by
4c79b5
Firstboot in the path \texttt{/usr/share/eula/}. 
4c79b5
4c79b5
File names of eula specific language translations should have the
4c79b5
format \texttt{eula.lang} or \texttt{eula.lang\_COUNTRY}.  Where
4c79b5
\texttt{lang} is a two-lowercase-letters code representing the
4c79b5
translation language and \texttt{COUNTRY} a two-uppercase-letters code
4c79b5
representing the country of that translation language. Languages' and
4c79b5
countries' codes are specified as described in the standards ISO639
4c79b5
and ISO3166 respectively.
4c79b5
4c79b5
When using Anaconda in a language different from English firstboot
4c79b5
checks if there is any eula translation file for the currenct
4c79b5
language. If so, the specific language eula file is loaded and shown
4c79b5
to the user.  Otherwise the \texttt{eula.en\_US} file is used.
4c79b5
4c79b5
The CentOS eula files, described in the previous list, have their own
4c79b5
framework inside CentOS Artwork Repository. They are rendered similar
4c79b5
to images using templates and translation files, as well as rendering
4c79b5
scripts. 
4c79b5
4c79b5
The files \texttt{EULA} and \texttt{eula.en\_US} should have the same
4c79b5
information. The \texttt{GPL} file contains the GPL license with a
4c79b5
brief description of how it applies to CentOS Distribution.
4c79b5
4c79b5
Once you rebrand the text files inside the \texttt{centos-release}
4c79b5
SRPM package, you need to rebuild it with the new brand information.
4c79b5
4c79b5
\begin{figure}[!hbp]
4c79b5
\hrulefill
4c79b5
\begin{verbatim}
4c79b5
/usr/share/firstboot/pixmaps/
4c79b5
|-- shadowman-round-48.png
4c79b5
\end{verbatim}
4c79b5
\hrulefill
4c79b5
\caption{Firstboot rebranding (package: redhat-logos)%
4c79b5
   \label{fig:Distribution:Anaconda:Firstboot:Rebranding:Logos}}
4c79b5
\end{figure}
4c79b5
4c79b5
\begin{figure}[!hbp]
4c79b5
\hrulefill
4c79b5
\begin{verbatim}
4c79b5
/usr/share/firstboot/pixmaps/
4c79b5
|-- firstboot-left.png
4c79b5
|-- splash-small.png
4c79b5
\end{verbatim}
4c79b5
\hrulefill
4c79b5
\caption{Firstboot rebranding (package: redhat-artwork)%
4c79b5
   \label{fig:Distribution:Anaconda:Firstboot:Rebranding:Artwork}}
4c79b5
\end{figure}
4c79b5
4c79b5
\begin{figure}[!hbp]
4c79b5
\hrulefill
4c79b5
\begin{verbatim}
4c79b5
/usr/share/eula/
4c79b5
|-- eula.en_US
4c79b5
/usr/share/doc/centos-release-5/
4c79b5
|-- EULA
4c79b5
|-- GPL
4c79b5
\end{verbatim}
4c79b5
\hrulefill
4c79b5
\caption{Firstboot rebranding (package: centos-release)%
4c79b5
   \label{fig:Distribution:Anaconda:Firstboot:Rebranding:Release}}
4c79b5
\end{figure}
4c79b5
\begin{verbatim}
4c79b5
\end{verbatim}