% Part : Concepts
% Chapter: Frameworks
% ------------------------------------------------------------
% $Id: templates.tex 6207 2010-08-05 13:11:13Z al $
% ------------------------------------------------------------
\section{Design Templates}
\hypertarget{sec:Concepts:Frameworks:Templates}{}
\label{sec:Concepts:Frameworks:Templates}
Design templates are plain text files. Design templates may or may not
contain translation markers inside. Design templates are used to
define the CentOS visual style (the look and feel) of CentOS corporate
identity in all its manifestations. Design templates are the
documents you need to create or edit in order to implement or maintain
the monolithic CentOS corporate visual structure. Design templates
are normative documents that need to be conceived carefully.
Design templates may be based on specific markups (i.e. XHTML, SVG,
CSS, etc.). If that is the case, translation markers may be combined
inside the specific markup design template to create a translatable
markup-specific design template. In contrast, if design templates do
not have specific markup inside, they are considered the simpliest
design templates because they only have translation markers inside.
Design templates can be read, edited, and studied using your favorite
text editor.
Design templates are specific to frameworks using design patterns to
define the visual style of content produced inside them. This is the
case of frameworks inside ``trunk/Identity/'', where design templates
are used to define images' visual style; and ``trunk/Translations/'',
where design tempates are used to define translations' common files.
Inside frameworks, design templates are stored in a directory named
`tpl'. This name is a convenction that scripts use to find framework's
design tempate files. If you want to change the design template
directory's name to something different from `tpl', you need to set
the same name in all design templates' directories along the CentOS
Artwork Repository, and update scripts to recognize the new name you
set. This is something you problably don't need to do, but if you
still want to, please share your reasons in
\href{mailto:centos-devel@centos.org}{centos-devel@centos.org} before
commit your changes. Changing the design template directory's name is
a big chanage that needs to be discussed in the community.
\subsection{Simpliest Design Templates}
The simpliest design templates are inside identity frameworks. The
simpliest design tempaltes are plain text files with translation
markers only. These kind of design templates are used to define
information like ``eula files'' (i.e trunk/Identity/Release/Tpl/eula)
used by Anaconda and similar files. The simpliest design template
files do not use extension.
\subsection{Translation Design Templates}
The translation design templates are inside translation frameworks.
The translation design templats are plain text documents whithout any
kind of markup. Instead, they contain sed's replacements commands.
As convenction, translation file names end with the extension `.sed'.
Translation files are created and edited using your favorite text
editor.
\subsection{SVG Design Templates}
The scalar vector graphics (SVG) design templates are inside identity
frameworks. The SVG design templates are plain text files with
markup, based on SVG standard. The SVG standard is described at
\href{http://www.w3.org/2000/svg}{http://www.w3.org/2000/svg}.
Even SVG design templates can be read and edited with your favorite
text editor, it is better to use a SVG editor like
\href{http://www.inkscape.org/}{Inkscape} (see
http://www.inkscape.org/) to create and edit them. The SVG design
template files are used to define the visual style of images
controlling the visual style of CentOS distribution, CentOS web sites,
CentOS promotion, etc.
Inside SVG design templates, each object has an ``Id'' property. By
default the object's Id is a combination of letters and numbers
granting its uniqueness inside the entire document.
Inside CentOS Artwork Repository, SVG design templates are rendered
automatically using the \texttt{render.sh} identity script. The
\texttt{render.sh} identity script looks for the object's Id property
containing the CENTOSARTWORK uppercase word and exports its area as
bitmap, automatically.
If you are designing SVG templates for CentOS Artwork Repository, and
you are using the \texttt{render.sh} identity script to render them,
you need to set the CENTOSARTWORK uppercase word as object's Id on the
design object you want to export as bitmap during the rendering
process. The CENTOSARTWORK uppercase word is a convenction used by
scripts to find the export area on your SVG design templates.
In CentOS Artwork Repository, SVG design templates are released under
the \href{http://creativecommons.org/licenses/by-sa/3.0/}{Creative
Common Share-Alike License 3.0}.\footnote{See
http://creativecommons.org/licenses/by-sa/3.0/} In Inkscape, you say
so in the ``Document Metadata'' panel, available in the ``File'' menu.
\subsection{XHTML Design Templates}
The XHTML design templates are inside identity frameworks. They are
plain text with markup, based on the
\href{http://www.w3.org/TR/xhtml1}{XHTML standard} described at
\href{http://www.w3.org/TR/xhtml1}{http://www.w3.org/TR/xhtml1}. These
files are created and edited using your favorite text editor. XHTML
design templates are used to define the visual style of files like the
``Release Notes'' (trunk/Identity/Release/Tpl/release-notes.html) used
by Anaconda.