<!-- The introduction chapter contains a brief introduction for the
application that explains what it does and where to report
problems. Basically a long version of the abstract. Don't include a
revision history. (see installation appendix comment) -->
<para
>&kgeography; ist ein Erdkunde-Lernprogramm für &kde;. Damit können Sie die politischen Daten einiger Länder lernen (Länder, ihre Hauptstädte und ihre Flaggen). </para>
<para
>In der aktuellen Version sind folgende Karten enthalten: Afrika, Asien, Australien, Brasilien, Kanada, China, Europa, Frankreich, Deutschland, Italien, Italienische Provinzen, Nord- und Zentralamerika, Norwegen, Polen, Südamerika, Spanien, USA und die Welt. </para>
</chapter>
<chapter id="quick-start">
<title
>Kurze Einführung in &kgeography;</title>
<para
>Beim ersten Start von &kgeography; müssen Sie eine Karte auswählen. <screenshot>
<screeninfo
>Bildschirmphoto von &kgeography; beim ersten Start</screeninfo>
>Hauptstadt eines Landes raten: Die Hauptstadt eines Landes müssen Sie aus vier vorgegeben Ländernamen erraten. Wie bei den vorherigen Übungen wird am Ende Ihr Ergebnis angezeigt. </para>
<para
>Land anhand der Flagge erkennen: Eine Flagge wird angezeigt und Sie müssen das zugehörige Land erraten. <screenshot>
> finden Sie ein Hilfsprogramm Erstellung von Karten, geschrieben von Yann Verley, um die Karte von Frankreich herzustellen. Starten Sie das Programm, um eine Hilfe zu Anwendung zu lesen. Das Programm erzeugt eine <literal role="extension"
>.kgm</literal
>-Datei mit den zugewiesenen Farben für jedes Land aus einer Textdatei zur weiteren Bearbeitung. Dann können Sie in der Kartendatei die Länder mit den angegebenen Farben kolorieren.</para>
</sect1>
<sect1 id="description-file">
<title
>Beschreibungsdatei</title>
<para
>Die Beschreibungsdatei ist zwingend erforderlich und muss die Dateierweiterung <literal role="extension"
>.kgm</literal
> haben. Diese Datei muss mit <sgmltag class="starttag"
>map</sgmltag
> beginnen und mit <sgmltag class="endtag"
>map</sgmltag
> enden. </para>
<para
>Innerhalb dieser Marken sind folgende Einträge nötig: <itemizedlist>
<listitem>
<para
><sgmltag class="starttag"
>mapFile</sgmltag
> und <sgmltag class="endtag"
>mapFile</sgmltag
>: Der Name der Datei (ohne Pfad) mit dem Kartenbild, ⪚ <quote
>europe.png</quote
>.</para>
</listitem>
<listitem>
<para
><sgmltag class="starttag"
>name</sgmltag
> und <sgmltag class="endtag"
>name</sgmltag
>: der Name der Karte, ⪚ <quote
>Europa</quote
>.</para>
</listitem>
<listitem>
<para
>Eine Marke <sgmltag class="starttag"
>division</sgmltag
> und <sgmltag class="endtag"
>division</sgmltag
> für jedes Land in der Karte.</para>
</listitem>
</itemizedlist>
</para>
<para
>Jedes Land muss diese Marken enthalten: <itemizedlist>
<listitem>
<para
><sgmltag class="starttag"
>name</sgmltag
> und <sgmltag class="endtag"
>name</sgmltag
>: Der Name des Landes, ⪚ <quote
>Albanien</quote
>.</para>
</listitem>
<listitem>
<para
><sgmltag class="starttag"
>capital</sgmltag
> ud <sgmltag class="endtag"
>capital</sgmltag
>: der Name der Hauptstadt des Landes, ⪚ <quote
>Tirana</quote
>.</para>
</listitem>
<listitem>
<para
><sgmltag class="starttag"
>ignore</sgmltag
> und <sgmltag class="endtag"
>ignore</sgmltag
>: Mögliche Werte sind <userinput
>yes</userinput
>, <userinput
>allowClickMode</userinput
> und <userinput
>no</userinput
>. Mit <userinput
>yes</userinput
> wird dieses Land bei der Abfrage nach Ländern übergangen, als wenn es nicht vorhanden wäre. Mit <userinput
>allowClickMode</userinput
> wird nach dem Land nur in der Übung <guibutton
>Klicken Sie ein Land auf der Karte an ...</guibutton
> gefragt, aber nicht in den anderen Übungen. Setzen Sie diese Marke auf den Wert <userinput
>no</userinput
>, um damit das Land in alle Übungen (Erkunden und Abfragen) aufgenommen wird. Diese Marke <sgmltag class="starttag"
>ignore</sgmltag
> darf fehlen, dann wird als Wert <userinput
>no</userinput
> angenommen. Für <quote
>Algerien</quote
> zum Beispiel ist der Wert auf <userinput
>yes</userinput
> in der <quote
>Europa</quote
>karte gesetzt, damit ist <quote
>Algerien</quote
> aus allen Fragen zur <quote
>Europa</quote
>karte ausgeschlossen.</para>
</listitem>
<listitem>
<para
><sgmltag class="starttag"
>flag</sgmltag
> und <sgmltag class="endtag"
>flag</sgmltag
>: Die Datei (ohne Dateipfad) mit der Flagge des Landes, ⪚ <quote
>albania.png</quote
>. Diese Marke darf auch fehlen. Sie ist für Länder mit dem Wert<userinput
>yes</userinput
> für die Marke <sgmltag class="starttag"
>ignore</sgmltag
> nicht erforderlich.</para>
</listitem>
<listitem>
<para
><sgmltag class="starttag"
>color</sgmltag
> und <sgmltag class="endtag"
>color</sgmltag
>: Die Farbe der Länder in der Karte.</para>
</listitem>
</itemizedlist>
</para>
<para
>Die Farbe wird durch drei Marken festgelegt: <itemizedlist>
<listitem>
<para
><sgmltag class="starttag"
>red</sgmltag
> und <sgmltag class="endtag"
>red</sgmltag
>: Rotanteil der Farbe mit gültigen Werten zwischen 0 und 255.</para>
</listitem>
<listitem>
<para
><sgmltag class="starttag"
>green</sgmltag
> und <sgmltag class="endtag"
>green</sgmltag
>: Grünanteil der Farbe mit gültigen Werten zwischen 0 und 255.</para>
</listitem>
<listitem>
<para
><sgmltag class="starttag"
>blue</sgmltag
> und <sgmltag class="endtag"
>blue</sgmltag
>: Blauanteil der Farbe mit gültigen Werten zwischen 0 und 255.</para>
</listitem>
</itemizedlist>
</para>
<tip>
<para
>Es ist sinnvoll, zwei oder drei falsche "Länder" wie <quote
>Wasser</quote
>, <quote
>Grenze</quote
> und <quote
>Küste</quote
> zu erstellen und ihnen mit der Marke <sgmltag class="starttag"
>ignore</sgmltag
> den Wert <userinput
>yes</userinput
> zu geben. </para>
</tip>
<important>
<para
>Schreiben Sie alle Namen von Städten und Ländern in Englisch.</para>
</important>
</sect1>
<sect1 id="map-file">
<title
>Kartendatei</title>
<para
>Die Kartendatei ist einfach aufgebaut, aber schwierig zu erstellen. Die Datei muss das <acronym
>PNG</acronym
> Format haben. Unter <ulink url="https://www.cia.gov/cia/publications/factbook/docs/refmaps.html"
>Cia-Referenz-Karten</ulink
> finden Sie einige Karten für die weitere Bearbeitung. Außerdem können Sie die <ulink url="https://www.cia.gov/cia/publications/factbook/reference_maps/pdf/political_world.pdf"
>Politische Weltkarte</ulink
> herunterladen, ein Bildschirmphoto aufnehmen und damit weiter arbeiten. Jedes Land auf der Karte sollte eine eindeutige Farbe haben. Verwenden Sie dazu Bildbearbeitungsprogramme wie <application
>Gimp</application
> oder <application
>Kolourpaint</application
>. </para>
</sect1>
<sect1 id="flags">
<title
>Flaggen</title>
<para
>Wenn Sie die Marke <sgmltag class="starttag"
>flag</sgmltag
> benutzt haben, sollten Sie auch die erforderlichen Flaggendateien erstellen. Diese Dateien müssen in eine Größe von 300x200 Pixeln im <acronym
>PNG</acronym
>-Format haben, oder noch besser als <acronym
>SVG</acronym
>-Datei vorliegen. <acronym
>SVG</acronym
>-Dateien fast aller Länder der Erde und weiterer Provinzen sollten Sie in der <ulink url="http://www.sodipodi.com/index.php3?section=clipart/flags"
>Sodipodi Flaggensammlung</ulink
> suchen. </para>
</sect1>
<sect1 id="how-to-test">
<title
>Test der Karten</title>
<para
>Bevor Sie Ihre Karte an Albert <email
>tsdgeos@terra.es</email
> schicken, sollten Sie sie auf Fehler überprüfen, Dazu sind folgende Schritte erforderlich: <itemizedlist
> <listitem
> <para
>Kopieren Sie die Beschreibungsdatei und die Kartendatei in den Ordner <filename class="directory"
> Ihrer Installation nicht kennen, geben Sie den Befehl <userinput
><command
>kde-config</command
> <option
>--prefix</option
></userinput
> auf der Konsole ein. </para>
</sect1>
<sect1 id="non-political-maps">
<title
>Nicht politische Karten</title>
<para
>Ist es möglich nichtpolitische Karten zu erstellen? Natürlich! <screenshot>
<screeninfo
>Beispiel einer nichtpolitischen Karte</screeninfo>
<mediaobject>
<imageobject>
<imagedata fileref="river.png" format="PNG"/>
</imageobject>
<textobject>
<phrase
>Beispiel einer nichtpolitischen Karte</phrase>
</textobject>
</mediaobject>
</screenshot>
</para>
<para
>Sebstverständlich kann das Länderkonzept um geographische Objekte wie Flüsse und Berge erweitert werden. Denken Sie bei der Bearbeitung der Karte daran, dass Flüsse und Berge in der Karte zu klein sind und daher einen zusätzlichen Fläche zum Anklicken brauchen. In diesem Beispiel hat der Fluss eine kastanienbraune Fläche und <20,76,34> als Farbe. </para>
</sect1>
</chapter>
<chapter id="commands">
<title
>Befehlsreferenz</title>
<!-- (OPTIONAL, BUT RECOMMENDED) This chapter should list all of the
application windows and their menubar and toolbar commands for easy reference.
Also include any keys that have a special function but have no equivalent in the
menus or toolbars. This may not be necessary for small apps or apps with no tool
or menu bars. -->
<sect1 id="kapp-mainwindow">
<title
>Das Hauptfenster von &kgeography;</title>
<sect2>
<title
>Das Menü <guimenu
>Datei</guimenu
></title>
<para>
<variablelist>
<varlistentry>
<term
><menuchoice
><shortcut
> <keycombo action="simul"
>&Ctrl;<keycap
>O</keycap
></keycombo
> </shortcut
> <guimenu
>Datei</guimenu
> <guimenuitem
>Karte öffnen ...</guimenuitem
> </menuchoice
></term>
<listitem
><para
><action
>Öffnet den Dialog Kartenauswahl</action
></para
></listitem>
</varlistentry>
<varlistentry>
<term
><menuchoice
><shortcut
> <keycombo action="simul"
>&Strg;<keycap
>Q</keycap
></keycombo
> </shortcut
> <guimenu
>Datei</guimenu
> <guimenuitem
>Beenden</guimenuitem
> </menuchoice
></term>
<listitem
><para
><action
>Beendet</action
> &kgeography;</para
></listitem>
</varlistentry>
</variablelist>
</para>
</sect2>
<sect2>
<title
>Das Menü <guimenu
>Ansicht</guimenu
></title>
<para>
<variablelist>
<varlistentry>
<term
><menuchoice
><guimenu
>Ansicht</guimenu
> <guimenuitem
>Zoom</guimenuitem
> </menuchoice
></term>
<listitem
><para
><action
>Schaltet in den Zoommodus</action
></para
></listitem>
</varlistentry>
<varlistentry>
<term
><menuchoice
><guimenu
>Ansicht</guimenu
> <guimenuitem
>Originalgröße</guimenuitem
> </menuchoice
></term>
<listitem
><para
><action
>Zeigt</action
> die Karte wieder in der ursprünglichen Größe an.</para
></listitem>
</varlistentry>
<varlistentry>
<term
><menuchoice
><guimenu
>Ansicht</guimenu
> <guimenuitem
>Verschieben</guimenuitem
> </menuchoice
></term>
<listitem
><para
><action
>Verschiebt</action
> den aktuellen Kartenausschnitt</para
></listitem>
</varlistentry>
</variablelist>
</para>
</sect2>
<sect2>
<title
>Das Menü <guimenu
>Einstellungen</guimenu
></title>
<para>
<variablelist>
<varlistentry>
<term
><menuchoice
><guimenu
>Einstellungen</guimenu
> <guimenuitem
>Werkzeugleiste anzeigen/ausblenden</guimenuitem
> </menuchoice
></term>
<listitem
><para
><action
>Zeigt die Werkzeugleiste von &kgeography; an oder blendet sie aus.</action
></para
></listitem>
</varlistentry>
<varlistentry>
<term
><menuchoice
><guimenu
>Einstellungen</guimenu
> <guimenuitem
>Kurzbefehle festlegen ...</guimenuitem
> </menuchoice
></term>
<listitem
><para
><action
>Einstellung der Tastenkürzel für &kgeography;</action
></para
></listitem>
</varlistentry>
<varlistentry>
<term
><menuchoice
><guimenu
>Einstellungen</guimenu
> <guimenuitem
>Werkzeugleisten einrichten ...</guimenuitem
> </menuchoice
></term>
<listitem
><para
><action
>Einstellung der Werkzeugleiste für &kgeography;</action
></para
></listitem>
</varlistentry>
</variablelist>
</para>
</sect2>
<sect2>
<title
>Das Menü <guimenu
>Hilfe</guimenu
></title>
&help.menu.documentation; </sect2>
</sect1>
</chapter>
<!--<chapter id="faq">
<title
>Questions and Answers</title>
&reporting.bugs;
&updating.documentation;
<qandaset id="faqlist">
<qandaentry>
<question>
<para
>My Mouse doesn't work. How do I quit &kgeography;?</para>
</question>
<answer>
<para
>You silly goose! Check out the <link linkend="commands"
>Commands
Section</link
> for the answer.</para>
</answer>
</qandaentry>
<qandaentry>
<question>
<para
>Why am I not able to twiddle my documents?</para>
</question>
<answer>
<para
>You can only twiddle your documents if you have the foobar.lib
installed.</para>
</answer>
</qandaentry>
</qandaset>
</chapter
>-->
<chapter id="credits">
<!-- Include credits for the programmers, documentation writers, and
contributors here. The license for your software should then be included below
the credits with a reference to the appropriate license file included in the KDE
distribution. -->
<title
>Danksagungen und Lizenz</title>
<para
>&kgeography; </para>
<para
>Programm Copyright 2004-2005 Albert Astals Cid <email
