<?xml version="1.0" encoding="utf-8"?>
<!DOCTYPE book PUBLIC "-//OASIS//DTD DocBook XML 4.1.2//EN" "http://www.oasis-open.org/docbook/xml/4.1.2/docbookx.dtd">
<book id="gq-manual" lang="de">
	<bookinfo>
		<title>GQ Benutzerhandbuch</title>
		<authorgroup>
			<author role="maintainer">
	<firstname>Sven</firstname> <surname>Herzberg</surname>
	<affiliation>
	  <address>
	    <email>herzi@gnome.org</email>
	  </address>
	</affiliation>
			</author>
		</authorgroup>
		<copyright>
			<year>2006</year>
			<year>2007</year>
			<holder>Sven Herzberg</holder>
		</copyright>
		<publisher>
			<publishername>GNOME Documentation Project</publishername>
		</publisher>
		<include xmlns="http://www.w3.org/2001/XInclude" href="legal.xml"/>
		<revhistory>
			<revision>
				<revnumber>0.1</revnumber>
				<date>2006-12-20</date>
				<revremark>Initial Revision (including Themeing Instructions)</revremark>
			</revision>
			<revision>
				<revnumber>0.2</revnumber>
				<date>2007-01-15</date>
				<revremark>Added Section about the Browser Page</revremark>
			</revision>
		</revhistory>

		<abstract role="description"><para>
			The GQ Manual
		</para></abstract>
	</bookinfo>

	<part id="intro">
		<title>Introduction</title>

		<chapter>
			<title>Not finished</title>
			<para><remark>
				This part isn't written yet. You can contribute this chapter.
			</remark></para>
		</chapter>
	</part>

		<part id="Browsing-and-Modifing-LDAP-Directories">
			<title>Browsing and Modifing LDAP Directories</title>

			<chapter>
				<title>Structure of the Browser Page</title>
				<para>
					The browser page is split into two parts:<orderedlist>
						<listitem><para>The LDAP Tree (on the left side)</para></listitem>
						<listitem><para>The Property Browser (on the right side)</para></listitem>
					</orderedlist>
				</para>
			</chapter>

			<chapter>
				<title>Using the LDAP Tree</title>
				<para><remark>
					This part isn't written yet. You can contribute this chapter.
				</remark></para>
			</chapter>

			<chapter>
				<title>Using the Property Browser</title>
				<para>
					The property editor is one of the most powerful interfaces that
					GQ provides. Here's a small overview:<itemizedlist>
						<listitem><para>Typed Editors</para></listitem>
						<listitem><para>Single or Multi-Line Input</para></listitem>
						<listitem><para>Easily edit multi value properties</para></listitem>
					</itemizedlist>
				</para>

				<sect1>
					<title>Typed Editors</title>
					<para>
						GQ provides different editor types for attributes. You can easily select
						the desired editor by right-clicking on the attribute name and then
						choosing a type from "Change Display Type".
					</para>
					<para>
						Currently available types include:<itemizedlist>
							<listitem><para>Text Entry</para></listitem>
							<listitem><para>Password Entry</para></listitem>
							<listitem><para>Image</para></listitem>
							<listitem><para>Object Class</para></listitem>
							<listitem><para>Number</para></listitem>
							<listitem><para>Date</para></listitem>
							<listitem><para>Time</para></listitem>
						</itemizedlist>
					</para>
				</sect1>

				<sect1>
					<title>Single and Multi-Line Input</title>
					<para>
						When editing text properties of values, you sometimes want to edit
						larger parts of text. Then you can easily switch from single line
						entries to multiple lines by using the second toolbar button in the
						property editor.
					</para>
				</sect1>

				<sect1>
					<title>Multi-Value Properties</title>
					<para>
						GQ also contains very good support for properties that consist of
						multiple values. You can easily add new values by pressing the down
						arrow next to the editor fields.
					</para>
				</sect1>
			</chapter>
		</part>
	 
		<part id="themes">
			<title>GTK+ Themes and GQ</title> 

		<chapter id="colors">
			<title>Colors</title>
			<para>
				GQ uses colors in several parts of the user interface. This part is
				supposed to tell you how to customize these parts.
			</para>

			<section id="browser">
				<title>GQ Item Browser</title>
				<para>
					The item browser uses colors to highlight several classes
					if attributes:<itemizedlist>
					<listitem><para><emphasis>Extensible:</emphasis> Attributes
						that are added to an entry of the <glossterm>objectClass</glossterm>
						and that are not specified by a syntax are highlighted in purple.
					</para></listitem>
					<listitem><para><emphasis>Delete:</emphasis> Attributes
						that are supposed to be deleted by an update are highlighted
						in orange.
					</para></listitem>
					<listitem><para><emphasis>Required:</emphasis> Attributes
						that are required by a class are highlighted in blue.
					</para></listitem>
					<listitem><para><emphasis>Unspecified:</emphasis> Attributes
						that aren't defined in the schema of its entry's classes
						are highlighted red.
					</para></listitem>
				</itemizedlist></para>
				<para>
					These colors can be overwritten pretty easily: you just need to specify
					these colors for the class GqInputForm:<itemizedlist>
						<listitem><para>Extensible: "extensible-color"</para></listitem>
						<listitem><para>Delete: "delete-color"</para></listitem>
						<listitem><para>Required: "required-color"</para></listitem>
						<listitem><para>unspecified: "additional-color"</para></listitem>
					</itemizedlist>
				</para>
			</section>
		</chapter>

		<chapter id="stock-images">
			<title>Stock Images</title>
			<para>
				GQ uses a lot of images in the application. These can be replaced by
				images from an icon theme.
			</para>

			<section>
				<title>LDAP Tree</title>
				<para>
					GQ uses some icons the the trees that are taken from GTK+. These are:
					<itemizedlist>
						<listitem><para>GTK_STOCK_CONNECT</para></listitem>
						<listitem><para>GTK_STOCK_DISCONNECT</para></listitem>
					</itemizedlist>
				</para>
				<para>
					Icons used for the visualization of LDAP entries are these:
					<itemizedlist>
						<listitem><para>folder (according to icon-naming-spec)</para></listitem>
						<listitem><para>ldap-group</para></listitem>
						<listitem><para>ldap-person</para></listitem>
						<listitem><para>ldap-organization</para></listitem>
					</itemizedlist>
				</para>
			</section>
		</chapter>
	</part>
</book>
