<?xml version="1.0" encoding="utf-8"?>
<!DOCTYPE article PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN" "http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd" [
<!ENTITY appversion "0.4.2">
<!ENTITY manrevision "1.0">
<!ENTITY date "February 2007">
<!ENTITY app "Agave">
]>
<!--
(Do not remove this comment block.)
Maintained by the GNOME Documentation Project
http://developer.GNOME.org/projects/gdp
Template version: 2.0 beta
Template last modified Jan 30, 2002

-->
<!-- =============Document Header ============================= -->
<article id="index" lang="de">
    <!-- please do not change the id; for translations, change lang to -->
    <!-- appropriate code -->
    <articleinfo>
        <title>Agave Manual</title>
        <copyright>
            <year>2007</year>
            <holder>GNOME Documentation Project</holder> </copyright>

        <!-- translators: uncomment this:

        <copyright>
            <year>2003</year>
            <holder>ME-THE-TRANSLATOR (Latin translation)</holder>
        </copyright>

        -->
        <publisher role="maintainer">
            <publishername>GNOME Documentation Project</publishername>
        </publisher>

        <xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="legal.xml"/>

        <authorgroup>
            <author>
                <firstname>GNOME Documentation Project</firstname>
                <surname/>
                <affiliation>
                    <orgname>GNOME</orgname>
                </affiliation>
            </author>

            <!-- This is appropriate place for other contributors: translators,
            maintainers,  etc. Commented out by default.
            <othercredit role="translator">
                <firstname>Latin</firstname>
                <surname>Translator 1</surname>
                <affiliation>
                    <orgname>Latin Translation Team</orgname>
                    <address> <email>translator@gnome.org</email> </address>
                </affiliation>
                <contrib>Latin translation</contrib>
            </othercredit>
            -->
        </authorgroup>

        <!-- According to GNU FDL, revision history is mandatory if you are -->
        <!-- modifying/reusing someone else's document.  If not, you can omit it. -->
        <revhistory>
            <!-- Remember to remove the &manrevision; entity from the revision entries other
            than the current revision. -->
            <revision>
                <revnumber>1.0</revnumber>
                <date>2007</date>
                <revdescription>
                    <para>Initial version</para>
                </revdescription>
            </revision>
        </revhistory>
        <releaseinfo> This manual describes version 0.4.2 of Agave.
        </releaseinfo>
        <legalnotice>
            <title>Feedback</title>
            <para>To report a bug or make a suggestion regarding the <application>Agave</application> application or this manual, follow the directions in the <ulink url="ghelp:gnome-feedback" type="help">GNOME Feedback Page</ulink>.
            </para>
            <!-- Translators may also add here feedback address for translations -->
        </legalnotice>
        <abstract role="description">
            <para>Agave is a colorscheme designer for the GNOME desktop.</para>
        </abstract>
    </articleinfo>
    <indexterm><primary>agave</primary></indexterm>
    <indexterm><primary>colorscheme designer</primary></indexterm>

    <!-- ============= Document Body ============================= -->
    <!-- ============= Introduction ============================== -->
    <sect1 id="agave-intro">
        <title>Einleitung</title>

        <para>
            <application>Agave</application> is an application for the GNOME
            desktop that allows you to select an initial color and generate a
            variety of different colorschemes from that color.  The primary
            audience of this application is graphic designers (and particularly web
            designers) though it can be used for anything where you might need to
            pick several colors that go well together, such as painting rooms in
            your house.
        </para>

    </sect1>
    <sect1>
        <title>Der Anfang</title>
        <para>Dieses Kapitel erklärt, wie Agave gestartet wird und gibt eine grundlegende Übersicht über dieses Programm.</para>
        <sect2>
            <title>Agave starten</title>
            <para>Agave kann auf folgende Arten gestartet werden:</para>
            <variablelist>
                <varlistentry>
                    <term><guimenu>Applications</guimenu> menu</term>
                    <listitem>
                        <para>
                            Choose <menuchoice> <guisubmenu>Graphics</guisubmenu>
                                <guimenuitem>Agave</guimenuitem> </menuchoice>.
                        </para>
                    </listitem>
                </varlistentry>
                <varlistentry>
                    <term>Kommandozeile</term>
                    <listitem>
                        <para>
                            Type <command>agave</command>, then press 
                            <keycap>Return</keycap>.
                        </para>
                    </listitem>
                </varlistentry>
            </variablelist>

        </sect2>
        <sect2>
            <title>Das Agave Fenster</title>
            <para>
                When you start Agave, you will see a window that looks very much like the following:
            </para>
            <figure id="agave-window">
                <title>Agave Window</title>
                <screenshot>
                    <mediaobject>
                        <imageobject>
                            <imagedata fileref="figures/main-window.png" format="PNG"/>
                        </imageobject>
                        <textobject> <phrase>Shows Agave main window.</phrase>
                        </textobject>
                    </mediaobject>
                </screenshot>
            </figure>
            <para>The <application>Agave</application> window contains the following
                elements: </para>
            <variablelist>
                <varlistentry> <term>Menüleiste</term>
                    <listitem>
                        <para>The menus on the menubar contain all of the commands you need to use <application>Agave</application>.</para>
                    </listitem>
                </varlistentry>
                <varlistentry> <term>Werkzeugleiste</term>
                    <listitem>
                        <para>Die Werkzeugleiste beinhaltet einen Teil der Befehle, auf die mit der Menüleiste zugegriffen werden kann.</para>
                    </listitem>
                </varlistentry>
                <varlistentry> <term>Schema Darstellungsbereich</term>
                    <listitem>
                        <para>Die Schema Darstellungsbox beinhaltet verschiedene umfangreiche Farbmuster welche ein Farbschema darstellen, die auf den aktuellen Einstellungen basieren. Es beinhaltet auch die Möglichkeit, eine neue Basisfarbe und Schema auszuwählen.</para>
                    </listitem>
                </varlistentry>
                <varlistentry> <term>Palette</term>
                    <listitem>
                        <para>
                            The palette offers a selection of color presets that
                            you can click in order to change the current base
                            color.  You can choose from several built-in
                            palettes and you can also create and add your own
                            palettes. See <xref linkend="sect-palettes"/> for
                            more information.
                        </para>
                    </listitem>
                </varlistentry>
                <varlistentry> <term>Favoriten</term>
                    <listitem>
                        <para>Die Favoriten Liste stellt eine Liste von Farben dar, die gespeichert wurden, sowie eine kleine Toolbar, die es erlaubt die Liste zu bearbeiten.</para>
                    </listitem>
                </varlistentry>
                <varlistentry> <term>Statusleiste</term>
                    <listitem>
                        <para>Die Statusleite ist so ziemlich unbrauchbar. Ich sollte sie loswerden.</para>
                    </listitem>
                </varlistentry>
            </variablelist>
        </sect2>
    </sect1>

    <sect1>
        <title>Agave verwenden</title>
        <sect2>
            <title>Eine Basisfarbe wählen</title>
            <para>Es gibt viele verschiedene Wege eine Farbe auszuwählen, die als Basis für das Farbschema verwendet wird.</para>
            <sect3>
                <title>Der Knopf Farbauswahl</title>
                <para>Der einfachste Weg, eine Farbe auszuwählen, ist über den Knopf Farbwauswahl. Ein Klick auf diesen Knopf öffnet folgenden Dialog aus:</para>
                <figure id="gtk-color-selector">
                    <title>Color Selection Dialog</title>
                    <screenshot>
                        <mediaobject>
                            <imageobject>
                                <imagedata fileref="figures/gtk-color-selector.png" format="PNG"/>
                            </imageobject>
                            <textobject>
                                <phrase>Color Selection Dialog</phrase>
                            </textobject>
                        </mediaobject>
                    </screenshot>
                </figure>
                <para>Der Dialog Farbauswahl ermöglicht es, eine Basisfarbe auf verschiedene Arten zu wählen:</para>
                <itemizedlist>
                    <listitem>
                        <para>Angabe von Farbton, Sättigung und Wert</para>
                    </listitem>
                    <listitem>
                        <para>Angabe der Komponenten Rot, Grün und Blau</para>
                    </listitem>
                    <listitem>
                        <para>Auswahl aus einem Farbkreis</para>
                    </listitem>
                    <listitem>
                        <para>Wahl einer Farbe von einem beliebigen Punkt auf dem Bildschirm (Werkzeug Pipette)</para>
                    </listitem>
                </itemizedlist>
                <para>Das Verwenden des Knopfes Farbauswahl ist wahrscheinlich die beste Art, wenn bekannt ist, welche Farbe als Basisfarbe verwenden werden soll.</para>
            </sect3>
            <sect3 id="sect-palettes">
                <title>Paletten</title>
                <para>Ein anderer Weg eine Basisfarbe auszuwählen ist eine der Farbpaletten im unteren Bereich des Programmfensters auszuwählen. Diese Paletten stellen eine Vielzahl von voreingestellten Farben dar, die als Startpunkt verwendet werden können. Eine der Farben kann als Basisfarbe ausgewählt werden, indem man einfach darauf klickt.</para>
                <para>
                    You can add your own custom palettes to Agave so that they
                    will show up in the palettes selector.  To do so, you must
                    first create a palette file.  A palette file is a file in
                    the gimp palette format.  An trivial example file follows:
                </para>
                <para>
<programlisting>GIMP Palette
Name: MyPalette
#
  0   0   0 Black
255   0   0 Red
  0 255   0 Green
  0   0 255 Blue
255 255 255 White</programlisting>
                </para>
                <para>
                    All palette files must start with the
                    <code>GIMP Palette</code> header and a palette name.  You
                    can optionally include a comment starting with a
                    <code>#</code>.  The remaining lines define individual
                    colors' red, green, and blue
                    components ranging from 0 to 255.
                </para>
                <para>
                    Your palette file should be saved with a <filename>.gpl</filename> extension
                    and saved in home home directory at
                    <filename>.local/share/agave/palettes/</filename>.  If your file is
                    well-formed, Agave will load your custom palette next time you restart the
                    application.
                </para>
            </sect3>
            <sect3>
                <title>Favoriten</title>
                <para>Wenn vorher bereits Farben als Favoriten in der Favoritenliste gespeichert wurden, kann eine dieser Farben als Basisfarbe für das Farbschema verwenden, indem es in der Liste ausgewählt wird.</para>
            </sect3>
            <sect3>
                <title>Zufällig</title>
                <para>
                    If you're really stuck and need some inspiration, you can
                    also have Agave generate a random base color for you.  You
                    can do this by clicking the <guibutton>Random</guibutton>
                    button on the toolbar.  Alternately, you can select
                    <menuchoice>
                        <shortcut>
                            <keycombo>
                                <keycap>Ctrl</keycap>
                                <keycap>R</keycap>
                            </keycombo>
                        </shortcut>
                        <guimenu>Edit</guimenu>
                        <guimenuitem>Random</guimenuitem>
                    </menuchoice>
                    from the menu.
                </para>
            </sect3>
        </sect2>
        <sect2 id="sect-choosing-scheme-type">
            <title>Wahl eines Schema Typs</title>
            <para>
                Agave allows you choose from several different types of color
                schemes.  These color schemes are explained below.  In addition,
                a diagram is provided for each scheme which shows the
                relationships between the generated colors on a color wheel.
            </para>
            <variablelist>
                <varlistentry>
                    <term>Komplementare Farbe</term>
                    <listitem>
                        <para>Erzeugt ein 2-farbiges Schema bestehend aus der Basisfarbe und einer Farbe im Farbkreis direkt gegenüber der Basisfarbe</para>
                        <figure id="complements-scheme">
                            <title>Komplementare Farbe</title>
                            <mediaobject>
                                <imageobject>
                                    <imagedata fileref="figures/complements.png" format="PNG"/>
                                </imageobject>
                                <textobject> <phrase>Shows complementary color scheme</phrase>
                                </textobject>
                            </mediaobject>
                        </figure>
                    </listitem>
                </varlistentry>
                <varlistentry>
                    <term>zwei halb-komplementäre Farben</term>
                    <listitem>
                        <para>Erzeugt ein 3-farbiges Schema bestehend aus der Basisfarbe und zwei Farben die ein bisschen versetzt von der Komplementärfarbe sind</para>
                        <figure id="split-complements-scheme">
                            <title>Split Complements</title>
                            <mediaobject>
                                <imageobject>
                                    <imagedata fileref="figures/split-complements.png" format="PNG"/>
                                </imageobject>
                                <textobject> <phrase>Shows split-complementary color scheme</phrase>
                                </textobject>
                            </mediaobject>
                        </figure>
                    </listitem>
                </varlistentry>
                <varlistentry>
                    <term>Dreiergruppe</term>
                    <listitem>
                        <para>Erzeugt ein 3-farbiges Schema bestehend aus der Basisfarbe und zwei anderen Farben mit gleichem Abstand auf dem Farbkreis</para>
                        <figure id="triads-scheme">
                            <title>Dreiergruppe</title>
                            <mediaobject>
                                <imageobject>
                                    <imagedata fileref="figures/triads.png" format="PNG"/>
                                </imageobject>
                                <textobject> <phrase>Shows triads color scheme</phrase>
                                </textobject>
                            </mediaobject>
                        </figure>
                    </listitem>
                </varlistentry>
                <varlistentry>
                    <term>Vierergruppe</term>
                    <listitem>
                        <para>Erzeugt ein 4-farbiges Schema bestehend aus der Basisfarbe und drei weiteren Farben mit gleichem Abstand auf dem Farbkreis</para>
                        <figure id="tetrads-scheme">
                            <title>Vierergruppe</title>
                            <mediaobject>
                                <imageobject>
                                    <imagedata fileref="figures/tetrads.png" format="PNG"/>
                                </imageobject>
                                <textobject> <phrase>Shows tetrads color scheme</phrase>
                                </textobject>
                            </mediaobject>
                        </figure>
                    </listitem>
                </varlistentry>
                <varlistentry>
                    <term>sinngemässe Farben</term>
                    <listitem>
                        <para>Erzeugt ein 3-farbiges Schema bestehend aus der Basisfarbe und zwei weiteren Farben mit ein wenig Abstand</para>
                        <figure id="analogous-scheme">
                            <title>sinngemässe Farben</title>
                            <mediaobject>
                                <imageobject>
                                    <imagedata fileref="figures/analogous.png" format="PNG"/>
                                </imageobject>
                                <textobject> <phrase>Shows analogous color scheme</phrase>
                                </textobject>
                            </mediaobject>
                        </figure>
                    </listitem>
                </varlistentry>
                <varlistentry>
                    <term>Einfarbig</term>
                    <listitem>
                        <para>Erzeugt ein 3-farbiges Schema bestehend aus der Basisfarbe und zwei weiteren Farben mit dem gleichen Farbton, aber mit abweichender Sättigung</para>
                    </listitem>
                </varlistentry>
            </variablelist>
        </sect2>
    </sect1>

    <!-- This should be the last section in the manual -->
    <sect1>
        <title>Über Agave</title>
        <para>
            <application>Agave</application> was written by Jonathon Jongsma.
            To find more information about Agave, please visit the <ulink url="http://home.gna.org/colorscheme/" type="http">Agave project
                website</ulink>.
        </para>
        <para>
            To report a bug or make a suggestion regarding this application or
            this manual, see the Feedback section of the <ulink url="ghelp:user-guide?feedback-bugs" type="help">GNOME User
                Guide</ulink>.
        </para>

        <para>
            This program is distributed under the terms of the GNU General
            Public license as published by the Free Software Foundation; either
            version 2 of the License, or (at your option) any later version. A
            copy of this license can be found at this <ulink url="ghelp:gpl" type="help">link</ulink>, or in the file COPYING included with
            the source code of this program.
        </para>
  </sect1>
</article>
