Blame Manuals/Latex/Identity/Themes/Distro/BootUp/KDM/manual.tex

183ae8
\documentclass{article}
183ae8
\usepackage{longtable}
183ae8
\usepackage[pdftex]{graphicx}
183ae8
\usepackage{hyperref}
183ae8
\hypersetup{pdfauthor={CentOS Documentation SIG},%
183ae8
            pdftitle={KDE Display Manager (KDM)},%
183ae8
            pdfsubject={CentOS Corporate Visual Identity}%
183ae8
            }
183ae8
183ae8
\title{KDE Display Manager (KDM)}
183ae8
\author{CentOS Documentation SIG}
183ae8
183ae8
\begin{document}
183ae8
183ae8
\maketitle
183ae8
183ae8
\begin{abstract} 
183ae8
This article describes the KDM Visual Style for CentOS Distribution.
183ae8
KDE Display Manager (KDM) is the second choice defined as CentOS
183ae8
Display Manager. If users leave their computers on all the time and
183ae8
don't share their system, they won't see this as often as users who
183ae8
share a desktop system with other users on the system or laptop users
183ae8
who reboot and login more frequently.
183ae8
183ae8
Copyright \copyright\ 2010\ The CentOS Project. Permission is
183ae8
granted to copy, distribute and/or modify this document under the
183ae8
terms of the GNU Free Documentation License, Version 1.2 or any later
183ae8
version published by the Free Software Foundation; with no Invariant
183ae8
Sections, no Front-Cover Texts, and no Back-Cover Texts. A copy of the
183ae8
license is included in the section entitled ``GNU Free Documentation
183ae8
License''.  
183ae8
\end{abstract}
183ae8
183ae8
\tableofcontents
183ae8
183ae8
\section{Workplace}
183ae8
183ae8
\begin{itemize}
183ae8
\item SVN:trunk/Identity/Themes/\$THEME/Distro/BootUp/KDM/
183ae8
\item SVN:trunk/Translations/Identity/Themes/Distro/BootUp/KDM/
183ae8
\item SVN:trunk/Scripts/Identity/Themes/Distro/BootUp/KDM/
183ae8
\end{itemize}
183ae8
183ae8
\section{Theme}
183ae8
183ae8
\input{table-theme.tex}
183ae8
183ae8
\section{Design}
183ae8
183ae8
The centos-release.png and screenshot.png images are rendered for each
183ae8
major release of CentOS. This task is done using the script render.sh
183ae8
available in the workplace.  This script creates the appropriate PNG
183ae8
images under img/\$VERSION/ directory.
183ae8
183ae8
The background.png image is taken from Backgrounds section. This task
183ae8
is done using the script build.sh available in the workplace. This
183ae8
script collects all information needed, groups it and stores it under
183ae8
tgz/\$VERSION/\$RESOLUTION/ with the form \$THEME.tar.gz.
183ae8
183ae8
Whith the build.sh script you can create KDM themes for specific
183ae8
CentOS major releases, and inside each major release for specific
183ae8
screen resolutions.
183ae8
183ae8
KDM theme uses the same standard that GDM theme does. More information
183ae8
about GDM theming is available in the \textit{GNOME Display Manager
183ae8
Reference Manual}. This guide is available online and inside your
183ae8
system's help. As shortcut to get that help, you can run the following
183ae8
command:
183ae8
183ae8
\begin{itemize}
183ae8
\item gnome-help file:///usr/share/gnome/help/gdm/C/gdm.xml\#thememanual
183ae8
\end{itemize}
183ae8
183ae8
\section{Configuration}
183ae8
183ae8
\input{table-config.tex}
183ae8
183ae8
\begin{description}
183ae8
183ae8
\item[Theme]: In the file \emph{kdmrc}, \texttt{Theme} defines which
183ae8
is the KDM theme used by default.
183ae8
183ae8
\texttt{Theme=/usr/share/apps/kdm/themes/Modern/}
183ae8
183ae8
\item[UseTheme]: In the file \emph{kdmrc}, \texttt{UseTheme} defines
183ae8
the precedence of background. If true KDM theme background image takes
183ae8
precedence against KDM background.
183ae8
183ae8
\texttt{UseTheme=true}
183ae8
183ae8
\item[Wallpaper]: In the file \emph{backgroundrc}, \texttt{Wallpaper}
183ae8
defines the default configuration for KDM background.
183ae8
183ae8
\texttt{Wallpaper=/usr/share/backgrounds/images/default.png}
183ae8
183ae8
\end{description}
183ae8
183ae8
The background image used on KDM is one file, and the background image
183ae8
used on KDM theme is another file. Even they are independent files,
183ae8
the monolithic visual structure requires the same visual information
183ae8
in these images.
183ae8
183ae8
More information about KDE login screen, KDM and its configuration can
183ae8
be found in KDE help. As shortcut to get that help, you can run the
183ae8
following commands:
183ae8
183ae8
\begin{itemize}
183ae8
\item khelpcenter help:/kdm/login.html
183ae8
\item khelpcenter help:/kdm/configuring-kdm.html
183ae8
\item khelpcenter help:/kdm/kdm-files.html
183ae8
\end{itemize}
183ae8
183ae8
\section{Rendering}
183ae8
\section{Testing}
183ae8
\section{Issues}
183ae8
183ae8
\begin{description}
183ae8
183ae8
\item[Transition from Greeter to Desktop]: If KDE desktop background
183ae8
and KDM background are the same (and they should because the
183ae8
monolithic visual structure) the transition from login screen to
183ae8
desktop is ``smooth'' because the background image is always visible
183ae8
on the screen.
183ae8
183ae8
\item[Differences between KDM and GDM themes]: KDM and GDM
183ae8
themes\footnote{It refers to the \emph{.xml} files and its related
183ae8
files.} are basically the same except for the following differences:
183ae8
183ae8
\begin{enumerate}
183ae8
183ae8
\item KDM theme requires the ``user-entry'' and ``pw-entry'' stocks.
183ae8
This forces the using of two boxes, one for username and one for
183ae8
password. This boxes are visibly appart one from another. In GDM we
183ae8
use just one box (the ``user-pw-entry'' stock), both for
183ae8
username and password.
183ae8
183ae8
\item In KDM theme, messages were centered on the screen to fit the
183ae8
KDM two-boxes design. In GDM they are centered to the
183ae8
``user-pw-entry'' stock width.
183ae8
183ae8
\item In KDM theme, the ``language'' stock shows nothing. It creates
183ae8
an empty space in the screen. The language block was commented to save
183ae8
space on the screen. In GDM laguage buttom is present and when clicked
183ae8
a box pops up with a list of languages to choose.
183ae8
183ae8
\item Both KDM and GDM themes use the same font defintion in the
183ae8
\emph{.xml} file, but in presentation they look quiet different. For
183ae8
example the KDM clock's \emph{Sans 10 Bold} theme definition does not
183ae8
take effect. Probably font definition in \emph{kdmrc} file takes
183ae8
precedence against theme's one.
183ae8
183ae8
\end{enumerate}
183ae8
183ae8
\item[Different resolutions]: Designing of KDM theme needs to be
183ae8
expandable through different screen resolutions. By default, KDM theme
183ae8
uses a background image of 2048x1536 pixels. When screen resolution
183ae8
changes the predifined behaviour is to scale this image to fit the
183ae8
current display resolution. If the screen resolution is higher, or
183ae8
differs in ratio (for example when it is a wide screens) the design of
183ae8
KDM theme could loose quality or look different from the original one.
183ae8
183ae8
As a workaround, if KDM theme looks narrow or deformed to you, use the
183ae8
build.sh script to create the KDM theme in your specific screen
183ae8
resolution.
183ae8
183ae8
\item[KDM theme installation]: To install a KDM theme you need to copy
183ae8
its files from the workplace to its location in the filesytem. If you
183ae8
want to make that KDM theme your default one, then you also need to
183ae8
update the KDM configuration files to match your theme location. Both
183ae8
of these actions require you to have \emph{root} privileges.
183ae8
183ae8
\item[Default Display Manager]: By default KDM is the second display
183ae8
manager choice\footnote{See the file \emph{/etc/X11/prefdm}.}. To use
183ae8
KDM as first choise, run the following command (as \emph{root}) and
183ae8
reboot:
183ae8
183ae8
\texttt{echo "DISPLAYMANAGER=KDE" > /etc/sysconfig/desktop}
183ae8
183ae8
\item[Package content]: CentOS Default KDM Theme seems to be inside
183ae8
the package redhat-artwork. In contrast with GDM which has some files in
183ae8
redhat-logos and others in redhat-artwork. Could we standardize this ?
183ae8
All files in just one package (redhat-artwork) or files divided in two
183ae8
packages (redhat-artwork, and redhat-logos).
183ae8
183ae8
\end{description}
183ae8
183ae8
% License section
183ae8
\input{../../../../../Licenses/GFDL.tex}
183ae8
183ae8
\end{document}