<!-- 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; is een programma in KDE om Aardrijkskunde te leren. Hiermee kun je iets leren over de politieke indeling van sommige landen (onderdelen ervan, de bijbehorende hoofdsteden en eventuele vlaggen). </para>
<para
>In de huidige versie zijn er kaarten van: Afrika, Azië, Oostenrijk, Brazilië, Canada, China, Europa, Frankrijk, Duitsland, Italië, Italië per provincie, Noord- en Midden-Amerika, Noorwegen, Polen, Zuid-Amerika, Spanje, VS en de wereld. </para>
</chapter>
<chapter id="quick-start">
<title
>Snelgids voor &kgeography;</title>
<para
>Bij de eerste keer dat &kgeography; wordt gestart vraagt het met welke kaart je wilt beginnen. <screenshot>
<screeninfo
>Dit is een schermbeeld van &kgeography; na de eerste keer dat het wordt gestart</screeninfo>
>Kies de hoofdstad van een kaartgedeelte: je krijgt een hoofdstad en vier namen van provincies waarvan je de goede moet kiezen. Zoals hiervoor zie je als je klaar bent een scherm met de resultaten. </para>
<para
>Geef de naam van het kaartgedeelte bij de vlag: je ziet een vlag waarna je moet antwoorden bij welke provincie die vlag hoort. <screenshot>
> een hulpprogramma vinden (gemaakt door Yann Verley, waarmee hij de kaart van Frankrijk heeft gemaakt). Om te leren hoe het moet worden gebruikt moet u het gewoon uitvoeren en de hulptekst lezen. In principe maakt het van een gewoon tekstbestand een <literal role="extension"
>.kgm</literal
>-bestand en maakt het een bestand aan met daarin de kleuren die het aan elk kaartgedeelte heeft toegekend, en waarmee dus de kaart kan worden ingevuld.</para>
</sect1>
<sect1 id="description-file">
<title
>Bestand met beschrijving</title>
<para
>De extensie hiervan is <literal role="extension"
>.kgm</literal
> en het bestand moet moet beginnen met <sgmltag class="starttag"
>map</sgmltag
> en eindigen met <sgmltag class="endtag"
>map</sgmltag
>. </para>
<para
>Binnen deze "tags" moet aanwezig zijn: <itemizedlist>
<listitem>
<para
><sgmltag class="starttag"
>mapFile</sgmltag
> en <sgmltag class="endtag"
>mapFile</sgmltag
>: de naam van het bestand (zonder pad) dat de kaartafbeelding bevat,zoals bijvoorbeeld <quote
>europe.png</quote
>.</para>
</listitem>
<listitem>
<para
><sgmltag class="starttag"
>name</sgmltag
> en <sgmltag class="endtag"
>name</sgmltag
>: de naam van de kaart, zoals bijvoorbeeld <quote
>Europa</quote
>.</para>
</listitem>
<listitem>
<para
>Een <sgmltag class="starttag"
>division</sgmltag
> en <sgmltag class="endtag"
>division</sgmltag
> voor elk kaartgedeelte.</para>
</listitem>
</itemizedlist>
</para>
<para
>Elk kaartgedeelte heeft deze "tags": <itemizedlist>
<listitem>
<para
><sgmltag class="starttag"
>name</sgmltag
> en <sgmltag class="endtag"
>name</sgmltag
>: de naam van het kaartgedeelte, zoals bijvoorbeeld <quote
>Albanië</quote
>.</para>
</listitem>
<listitem>
<para
><sgmltag class="starttag"
>capital</sgmltag
> en <sgmltag class="endtag"
>capital</sgmltag
>: de naam van de hoofdstad van het kaartgedeelte, zoal bijvoorbeeld <quote
>Tirana</quote
>.</para>
</listitem>
<listitem>
<para
><sgmltag class="starttag"
>ignore</sgmltag
> en <sgmltag class="endtag"
>ignore</sgmltag
>: moet zijn <userinput
>yes</userinput
> indien het kaartgedeelte moet worden overgeslagen waneer er naar gedeelten in die kaart wordt gevraagd. Indien <userinput
>allowClickMode</userinput
> is opgegeven zal &kgeography; het kaartgedeelte vragen in de Klik-op-kaartgedeelte-modus maar anders niet. Deze "tag" is optioneel: bijvoorbeeld bij <quote
>Algerije</quote
> staat deze "tag" op <userinput
>yes</userinput
> in de kaart van <quote
>Europa</quote
>.</para>
</listitem>
<listitem>
<para
><sgmltag class="starttag"
>flag</sgmltag
> en <sgmltag class="endtag"
>flag</sgmltag
>: het bestand (zonder pad) met de vlag van het kaartgedeelte, bijvoorbeeld <quote
>albania.png</quote
>. Deze "tag" is optioneel. Niet nodig voor die kaartgedeelten waarvan de "tag" <sgmltag class="starttag"
>ignore</sgmltag
> op <userinput
>yes</userinput
> is ingesteld.</para>
</listitem>
<listitem>
<para
><sgmltag class="starttag"
>color</sgmltag
> en <sgmltag class="endtag"
>color</sgmltag
>: de kleur van het kaartgedeelte.</para>
</listitem>
</itemizedlist>
</para>
<para
>De kleur wordt met behulp van drie "tags" gegeven: <itemizedlist>
<listitem>
<para
><sgmltag class="starttag"
>red</sgmltag
> en <sgmltag class="endtag"
>red</sgmltag
>: rode kleurcomponent. Geldige waarden zijn tussen 0 en 255.</para>
</listitem>
<listitem>
<para
><sgmltag class="starttag"
>green</sgmltag
> en <sgmltag class="endtag"
>green</sgmltag
>: groene kleurcomponent. Geldige waarden zijn tussen 0 en 255.</para>
</listitem>
<listitem>
<para
><sgmltag class="starttag"
>blue</sgmltag
> en <sgmltag class="endtag"
>blue</sgmltag
>: blauwe kleurcomponent. Geldige waarden zijn tussen 0 en 255.</para>
</listitem>
</itemizedlist>
</para>
<tip>
<para
>Het is gemakkelijk om 2 of 3 oneigenlijke kaartgedeelten te maken zoals voor <quote
>Water</quote
>, <quote
>Grens</quote
> en <quote
>Kust</quote
> en daarna de "tag" <sgmltag class="starttag"
>ignore</sgmltag
> op <userinput
>ja</userinput
> in te stellen. </para>
</tip>
<important>
<para
>Alle namen (hoofdsteden en kaartgedeelten) moeten in het Engels zijn.</para>
</important>
</sect1>
<sect1 id="map-file">
<title
>Het kaartbestand</title>
<para
>Het is vrij eenvoudig om dit bestand te maken, maar het vereist wel veel werk. Het moet een <acronym
>PNG</acronym
> -bestand zijn. U kunt enige kaarten vinden op <ulink url="http://www.odci.gov/cia/publications/factbook/docs/refmaps.html"
>Cia Reference Maps</ulink
> die u kunt aanpassen. Als er geen kaarten bij zijn die u kunt gebruiken kunt u de <ulink url="http://www.odci.gov/cia/publications/factbook/reference_maps/pdf/political_world.pdf"
>world pdf</ulink
> ophalen van het internet, een schermbeeld ervan maken en van daaruit werken. Ieder kaartgedeelte moet een en slechts een kleur hebben. Om dit voor elkaar te krijgen kunt u gebruik maken van beeldbewerkingsprogramma's zoals <application
>The Gimp</application
> en <application
>Kolourpaint</application
>. </para>
</sect1>
<sect1 id="flags">
<title
>Vlaggen</title>
<para
>Indien u de "tag" <sgmltag class="starttag"
>flag</sgmltag
> gebruikt moet u de bestanden met de vlaggen ter beschikking stellen. Die moeten <acronym
>PNG</acronym
>-bestanden zijn en het is beter als zij 300x200 pixels (beeldpunten) bevatten en u er een <acronym
>SVG</acronym
>-bestand bij levert. U kunt <acronym
>SVG</acronym
>-vlaggen van bijna alle landen in de wereld en sommige andere kaartgedeelten verkrijgen op de <ulink url="http://www.sodipodi.com/index.php3?section=clipart/flags"
>Vlaggenverzameling van Sodipodi</ulink
>. </para>
</sect1>
<sect1 id="how-to-test">
<title
>Hoe te testen</title>
<para
>Voordat u uw kaart opstuurt naar Albert <email
>tsdgeos@terra.es</email
> moet u die testen op fouten. U kunt dit als volgt doen: <itemizedlist
> <listitem
> <para
>Plaats de beschrijving en het beeldbestand van de kaart in de map <filename class="directory"
>Is het mogelijk om niet-politieke kaarten te maken? Ja zeker! <screenshot>
<screeninfo
>Voorbeeld van het maken van een niet-politieke kaart</screeninfo>
<mediaobject>
<imageobject>
<imagedata fileref="river.png" format="PNG"/>
</imageobject>
<textobject>
<phrase
>Voorbeeld van het maken van een niet-politieke kaart</phrase>
</textobject>
</mediaobject>
</screenshot>
</para>
<para
>Natuurlijk, het idee van kaartgedeelten kan worden uitgebreid tot een rivier of een berg. Tijdens het maken van de kaart zult u eraan moeten denken dat de rivier of berg meestal zo klein is dat u in een extra klikbare oppervlakte moet voorzien. In dit voorbeeld krijgt de rivier een kastanjebruine oppervlakte met de naam in de kleur <20,76,34>. </para>
</sect1>
</chapter>
<chapter id="commands">
<title
>Overzicht van de opdrachten</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
>Het hoofdvenster van &kgeography;</title>
<sect2>
<title
>Het menu <guimenu
>Bestand</guimenu
> </title>
<para>
<variablelist>
<varlistentry>
<term
><menuchoice
><shortcut
> <keycombo action="simul"
>&Ctrl;<keycap
>O</keycap
></keycombo
> </shortcut
> <guimenu
>Bestand</guimenu
> <guimenuitem
>Kaart openen...</guimenuitem
> </menuchoice
></term>
<listitem
><para
><action
>Openen van het dialoogvenster voor het kiezen van een kaart</action
></para
></listitem>
</varlistentry>
<varlistentry>
<term
><menuchoice
><shortcut
> <keycombo action="simul"
>&Ctrl;<keycap
>Q</keycap
></keycombo
> </shortcut
> <guimenu
>Bestand</guimenu
> <guimenuitem
>Afsluiten</guimenuitem
> </menuchoice
></term>
<listitem
><para
>&kgeography; <action
>Afsluiten</action
></para
></listitem>
</varlistentry>
</variablelist>
</para>
</sect2>
<sect2>
<title
>Het menu <guimenu
>Beeld</guimenu
></title>
<para>
<variablelist>
<varlistentry>
<term
><menuchoice
><guimenu
>Beeld</guimenu
> <guimenuitem
>Zoom</guimenuitem
> </menuchoice
></term>
<listitem
><para
><action
>In zoom-modus gaan</action
></para
></listitem>
</varlistentry>
<varlistentry>
<term
><menuchoice
><guimenu
>Beeld</guimenu
> <guimenuitem
>Originele grootte</guimenuitem
> </menuchoice
></term>
<listitem
><para
><action
>Instellen</action
> van de originele grootte van de kaart</para
></listitem>
</varlistentry>
<varlistentry>
<term
><menuchoice
><guimenu
>Beeld</guimenu
> <guimenuitem
>Verplaatsen</guimenuitem
> </menuchoice
></term>
<listitem
><para
><action
>Verplaatsen</action
> binnen de huidige kaart</para
></listitem>
</varlistentry>
</variablelist>
</para>
</sect2>
<sect2>
<title
>Het menu <guimenu
>Instellingen</guimenu
></title>
<para>
<variablelist>
<varlistentry>
<term
><menuchoice
><guimenu
>Instellingen</guimenu
> <guimenuitem
>Werkbalk aan/uit</guimenuitem
> </menuchoice
></term>
<listitem
><para
><action
>Het tonen of niet tonen van de werkbalk van &kgeography;.</action
></para
></listitem>
</varlistentry>
<varlistentry>
<term
><menuchoice
><guimenu
>Instellingen</guimenu
> <guimenuitem
>Sneltoetsen...</guimenuitem
> </menuchoice
></term>
<listitem
><para
><action
>Instellen van sneltoetsen in &kgeography;.</action
></para
></listitem>
</varlistentry>
<varlistentry>
<term
><menuchoice
><guimenu
>Instellingen</guimenu
> <guimenuitem
>Werkbalk instellen...</guimenuitem
> </menuchoice
></term>
<listitem
><para
><action
>Instellen van de werkbalk in &kgeography;.</action
></para
></listitem>
</varlistentry>
</variablelist>
</para>
</sect2>
<sect2>
<title
>Het menu <guimenu
>Help</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 can't I 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
>Dankbetuigingen en Licentie</title>
<para
>&kgeography; </para>
<para
>Programma copyright 2004-2005 Albert Astals Cid <email