Blame Manual/repository-latex/centos-art.sh-latex/Identity/Themes/Distro/BootUp/GDM/manual.tex

0668a4
\documentclass{article}
0668a4
\usepackage{longtable}
0668a4
\usepackage[pdftex]{graphicx}
0668a4
\usepackage{hyperref}
0668a4
\hypersetup{pdfauthor={CentOS Documentation SIG},%
0668a4
            pdftitle={GNOME Display Manager (GDM)},%
0668a4
            pdfsubject={CentOS Corporate Visual Identity}%
0668a4
            }
0668a4
0668a4
\title{GNOME Display Manager (GDM)}
0668a4
\author{CentOS Documentation SIG}
0668a4
0668a4
\begin{document}
0668a4
0668a4
\maketitle
0668a4
0668a4
\begin{abstract} 
0668a4
This article describes the GDM Visual Style for CentOS Distribution.
0668a4
GDM is the first choice defined as CentOS Display Manager (DM). If
0668a4
users leave their computers on all the time and don't share their
0668a4
system, they won't see this as often as users who share a desktop
0668a4
system with other users on the system or laptop users who reboot and
0668a4
login more frequently.
0668a4
0668a4
Copyright \copyright\ 2010\ The CentOS Project. Permission is
0668a4
granted to copy, distribute and/or modify this document under the
0668a4
terms of the GNU Free Documentation License, Version 1.2 or any later
0668a4
version published by the Free Software Foundation; with no Invariant
0668a4
Sections, no Front-Cover Texts, and no Back-Cover Texts. A copy of the
0668a4
license is included in the section entitled ``GNU Free Documentation
0668a4
License''.  
0668a4
\end{abstract}
0668a4
0668a4
\tableofcontents
0668a4
0668a4
\section{Workplace}
0668a4
0668a4
\begin{itemize}
0668a4
\item SVN:trunk/Identity/Themes/\$THEME/Distro/BootUp/GDM/
0668a4
\item SVN:trunk/Translations/Identity/Themes/Distro/BootUp/GDM/
0668a4
\item SVN:trunk/Scripts/Identity/Themes/Distro/BootUp/GDM/
0668a4
\end{itemize}
0668a4
0668a4
\section{Theme}
0668a4
0668a4
\input{table-theme.tex}
0668a4
0668a4
\section{Design}
0668a4
0668a4
The centos-release.png and screenshot.png images are rendered for each
0668a4
major release of CentOS. This task is done using the rendering script
0668a4
(render.sh) available in the workplace.  This script creates the
0668a4
appropriate PNG images under img/\$VERSION/ directory. 
0668a4
0668a4
The background.png image is taken from Backgrounds section. This task
0668a4
is done using the building script(build.sh) available in the
0668a4
workplace. This script collects all information, groups it and stores
0668a4
it under tgz/\$VERSION/\$RESOLUTION/ with the form \$THEME.tar.gz.
0668a4
0668a4
Whith the building script you can create GDM themes for specific
0668a4
CentOS major releases, and inside each major release for specific
0668a4
screen resolutions.
0668a4
0668a4
More information about GDM theming is available in the \emph{GNOME
0668a4
Display Manager Reference Manual}. This guide is available online and
0668a4
inside your system's help. As shortcut to get that help, you can run
0668a4
the following command:
0668a4
0668a4
\begin{itemize}
0668a4
\item gnome-help file:///usr/share/gnome/help/gdm/C/gdm.xml\#thememanual
0668a4
\end{itemize}
0668a4
0668a4
\section{Configuration}
0668a4
0668a4
\begin{description}
0668a4
0668a4
\item[GraphicalTheme]: The graphical theme that the Themed Greeter
0668a4
should use.  It should refer to a directory in the theme directory set
0668a4
by \emph{GraphicalThemeDir}.
0668a4
0668a4
\texttt{GraphicalTheme=\$THEME}\\
0668a4
                                              
0668a4
\item[GraphicalThemeDir]: The directory where themes for the Themed
0668a4
Greeter are installed.
0668a4
0668a4
\texttt{GraphicalThemeDir=/usr/share/gdm/themes/}
0668a4
0668a4
\item[BackgroundColor]: The Standard greeter (gdmlogin) background
0668a4
color. If the BackgroundType is 2, use this color in the background of
0668a4
the greeter.  Also use it as the back of transparent images set on the
0668a4
background and if the BackgroundRemoteOnlyColor is set and this is a
0668a4
remote display.  This only affects the GTK+ Greeter.
0668a4
0668a4
\texttt{BackgroundColor=\#204C8D}
0668a4
0668a4
\item[GraphicalThemeColor]: Use this color in the background of the
0668a4
Themed Greeter. This only affects the Themed Greeter.
0668a4
0668a4
\texttt{GraphicalThemeColor=\#000000}
0668a4
0668a4
\end{description}
0668a4
0668a4
More information about GDM and its configuration can be found in its
0668a4
reference guide. As shortcut to get that help, you can run the
0668a4
following command:
0668a4
0668a4
\begin{itemize}
0668a4
\item gnome-help file:///usr/share/gnome/help/gdm/C/gdm.xml\#index
0668a4
\end{itemize}
0668a4
0668a4
\section{Rendering}
0668a4
\section{Testing}
0668a4
\section{Issues}
0668a4
0668a4
\begin{description}
0668a4
0668a4
\item[Transition from Greeter to Desktop]: This seems to be available
0668a4
when using the variable \emph{BackgroundImage} in GTK+ Greeter only.
0668a4
In Themed Greeter the best we have is the variable
0668a4
\emph{GraphicalThemedColor} to specify the background color of the
0668a4
transition.
0668a4
0668a4
\item[Different resolutions]: Designing of GDM theme needs to be
0668a4
expandable through different screen resolutions. By default, GDM theme
0668a4
uses a background image of 2048x1536 pixels. When screen resolution
0668a4
changes the predifined behaviour is to scale this image to fit the
0668a4
current display resolution. If the screen resolution is higher, or
0668a4
differs in ratio (for example when it a wide screens) the design of
0668a4
GDM them could loose quality or look different from the original one.
0668a4
0668a4
As a workaround, if GDM theme looks narrow or deformed to you, use the
0668a4
building script to create the GDM theme in your specific screen
0668a4
resolution.
0668a4
0668a4
\item[GDM theme installation]: Use the login screen administrator
0668a4
(gdmsetup). This action requires you to have \emph{root} privileges.
0668a4
0668a4
\item[Default Display Manager]: By default GDM is the first display
0668a4
manager choice\footnote{See the file /etc/X11/prefdm.}. If you
0668a4
changed this and want to go back then, run the following command (as
0668a4
\emph{root}) and reboot:
0668a4
0668a4
\texttt{echo "DISPLAYMANAGER=GNOME" > /etc/sysconfig/desktop}
0668a4
0668a4
\end{description}
0668a4
0668a4
% License section
0668a4
\input{../../../../../Licenses/GFDL.tex}
0668a4
0668a4
\end{document}