<!-- 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; est un outil d'apprentissage de la géographie dans &kde;. Il vous permet d'apprendre les subdivisions politiques de certains pays (régions, capitales de ces régions et les drapeaux associés s'il y a lieu). </para>
<para
>Les cartes disponibles dans la version actuelle sont: l'Afrique, l'Asie, l'Autriche, le Brésil, le Canada, la Chine, l'Europe, la France, l'Allemagne, l'Italie, l'Italie et ses provinces, L'Amérique du Nord et l'Amérique Centrale, la Norvège, la Pologne, l'Amérique du sud, l'Espagne, les USA et le monde. </para>
</chapter>
<chapter id="quick-start">
<title
>Démarrage rapide avec &kgeography;</title>
<para
>Lorsque vous démarrez &kgeography; pour la première fois, il vous demande de choisir une carte. <screenshot>
<screeninfo
>Voici une capture d'écran de &kgeography; au premier démarrage</screeninfo>
>Lorsque vous avez terminé toutes les questions, une boîte de dialogue avec les résultats s'affiche, montrant vos réponses correctes et fausses. <screenshot>
>Trouver la capitale d'une région: on vous donne le nom d'une capitale et quatre noms de régions et vous devez choisir le nom correct de la région. Comme précédemment, à la fin, une boîte de dialogue avec vos résultats s'affiche. </para>
<para
>Trouver une région à partir de son drapeau: on vous montre un drapeau et vous devez trouver la région auquel il appartient. <screenshot>
> un outil (fait par Yann Verley) qui l'a aidé à faire la carte de France. Pour comprendre son fonctionnement, lancez-le simplement et lisez le message d'aide. Cet outil crée le fichier <literal role="extension"
>.kgm</literal
> depuis un fichier texte et crée un fichier avec les couleurs qu'il a données à chaque région, ainsi vous pouvez remplir la carte grâce à lui.</para>
</sect1>
<sect1 id="description-file">
<title
>Fichier de description</title>
<para
>Ce fichier de description est indispensable et son extension est <literal role="extension"
>.kgm</literal
>. Il doit commencer par <sgmltag class="starttag"
>map</sgmltag
> et se terminer par <sgmltag class="endtag"
>map</sgmltag
>. </para>
<para
>À l'intérieur de ces balises doivent se trouver: <itemizedlist>
<listitem>
<para
><sgmltag class="starttag"
>mapFile</sgmltag
> et <sgmltag class="endtag"
>mapFile</sgmltag
>: le nom du fichier (sans aucun chemin) qui contient l'image de la carte, &pex; <quote
>europe.png</quote
>.</para>
</listitem>
<listitem>
<para
><sgmltag class="starttag"
>name</sgmltag
> et <sgmltag class="endtag"
>name</sgmltag
>: le nomde la carte, &pex; <quote
>Europe</quote
>.</para>
</listitem>
<listitem>
<para
>Une balise <sgmltag class="starttag"
>division</sgmltag
> et <sgmltag class="endtag"
>division</sgmltag
> pour chaque région de la carte.</para>
</listitem>
</itemizedlist>
</para>
<para
>Chaque région contient ces balises: <itemizedlist>
<listitem>
<para
><sgmltag class="starttag"
>name</sgmltag
> et <sgmltag class="endtag"
>name</sgmltag
>: le nom de la région, &pex; <quote
>Albanie</quote
>.</para>
</listitem>
<listitem>
<para
><sgmltag class="starttag"
>capital</sgmltag
> et <sgmltag class="endtag"
>capital</sgmltag
>: le nom de la capitale de la région, &pex; <quote
>Tirana</quote
>.</para>
</listitem>
<listitem>
<para
><sgmltag class="starttag"
>ignore</sgmltag
> et <sgmltag class="endtag"
>ignore</sgmltag
>: peut être mise sur <userinput
>yes</userinput
>, <userinput
>allowClickMode</userinput
> et <userinput
>no</userinput
>. Si cette balise indique <userinput
>yes</userinput
> alors la région sera ignorée lors des questions sur les régions de la carte. Ce sera comme si la région n'existait pas dans le mode test de &kgeography;. Si cette balise indique <userinput
>allowClickMode</userinput
> alors &kgeography; va inclure cette région dans le mode <guibutton
>Trouver une région sur la carte...</guibutton
> mais pas dans les autres modes de test. Fixer cette balise à <userinput
>no</userinput
> indique que la région va apparaître dans tous les modes (navigation et tests). Cette balise est optionnelle et lorsqu'il n'y a pas de balise <sgmltag class="starttag"
>ignore</sgmltag
>, cela signifie qu'elle indique <userinput
>no</userinput
>. Par exemple l'<quote
>Algérie</quote
> a cette balise qui indique <userinput
>yes</userinput
> dans la carte d'<quote
>Europe</quote
> ce qui signifie que l' <quote
>Algérie</quote
> ne fera partie d'aucun test dans la carte de l'<quote
>Europe</quote
>.</para>
</listitem>
<listitem>
<para
><sgmltag class="starttag"
>flag</sgmltag
> et <sgmltag class="endtag"
>flag</sgmltag
>: le fichier (sans le chemin) qui contient le drapeau de la région, &pex; <quote
>albania.png</quote
>. Cette balise est optionnelle. Elle n'est pas nécessaire pour les régions dont la balise <sgmltag class="starttag"
>ignore</sgmltag
> indique <userinput
>yes</userinput
>.</para>
</listitem>
<listitem>
<para
><sgmltag class="starttag"
>color</sgmltag
> et <sgmltag class="endtag"
>color</sgmltag
>: la couleur que la région a sur la carte.</para>
</listitem>
</itemizedlist>
</para>
<para
>La couleur est définie en utilisant trois balises: <itemizedlist>
<listitem>
<para
><sgmltag class="starttag"
>red</sgmltag
> et <sgmltag class="endtag"
>red</sgmltag
>: la composante rouge de la couleur. Les valeurs valables sont comprises entre 0 et 255.</para>
</listitem>
<listitem>
<para
><sgmltag class="starttag"
>green</sgmltag
> et <sgmltag class="endtag"
>green</sgmltag
>: la composante verte de la couleur. Les valeurs valables sont comprises entre 0 et 255.</para>
</listitem>
<listitem>
<para
><sgmltag class="starttag"
>blue</sgmltag
> et <sgmltag class="endtag"
>blue</sgmltag
>: la composante bleue de la couleur. Les valeurs valables sont comprises entre 0 et 255.</para>
</listitem>
</itemizedlist>
</para>
<tip>
<para
>Il est intéressant de créer deux ou trois subdivisions non nécessaires comme <quote
>Eau</quote
>, <quote
>Frontière</quote
> et <quote
>Côte</quote
> et de les accompagner de la balise <sgmltag class="starttag"
>ignore</sgmltag
> fixée sur <userinput
>yes</userinput
>. </para>
</tip>
<important>
<para
>Tous les noms (capitales et régions) doivent être en anglais.</para>
</important>
</sect1>
<sect1 id="map-file">
<title
>Le fichier de la carte</title>
<para
>Le fichier de la carte est assez simple mais laborieux à créer. Il doit être en format <acronym
>PNG</acronym
>. Vous pouvez trouver des cartes à transformer à <ulink url="https://www.cia.gov/cia/publications/factbook/docs/refmaps.html"
>la référence des cartes de la Cia</ulink
>. Si aucune carte ne satisfait vos besoins, vous pouvez télécharger la <ulink url="https://www.cia.gov/cia/publications/factbook/reference_maps/pdf/political_world.pdf"
>carte politique du monde</ulink
>, en prendre une capture d'écran et travailler à partir de cela. Chaque région sur la carte doit avoir une et une seule couleur. Pour obtenir cela, vous pouvez utiliser un programme de retouche d'images comme <application
>Le Gimp</application
> et <application
>Kolourpaint</application
>. </para>
</sect1>
<sect1 id="flags">
<title
>Les drapeaux</title>
<para
>Si vous avez utilisé la balise <sgmltag class="starttag"
>flag</sgmltag
> vous devez fournir les fichiers pour les drapeaux. Ils doivent être en format <acronym
>PNG</acronym
> et ce serait mieux qu'ils soient 300x200 pixels et que vous fournissiez un fichier <acronym
>SVG</acronym
> avec. Pour obtenir des fichiers de drapeaux <acronym
>SVG</acronym
> pour presque tous les pays du monde et pour certaines régions, vous pouvez consulter <ulink url="http://www.sodipodi.com/index.php3?section=clipart/flags"
>la collection de drapeaux Sodipodi</ulink
>. </para>
</sect1>
<sect1 id="how-to-test">
<title
>Comment tester vos fichiers</title>
<para
>Avant d'envoyer votre carte à Albert <email
>tsdgeos@terra.es</email
>, vous devriez la tester pour voir si elle n'a pas d'erreurs. Pour cela, vous devez suivre les étapes suivantes: <itemizedlist
> <listitem
> <para
>copier le descriptif de la carte et le fichier image de la carte dans <filename class="directory"
>Est-il possible de créer des cartes non politiques? Oui, bien sûr! <screenshot>
<screeninfo
>Exemple de création d'une carte non politique</screeninfo>
<mediaobject>
<imageobject>
<imagedata fileref="river.png" format="PNG"/>
</imageobject>
<textobject>
<phrase
>Exemple de création d'une carte non politique</phrase>
</textobject>
</mediaobject>
</screenshot>
</para>
<para
>Bien sûr, le concept de subdivision peut s'étendre à une rivière ou une montagne. Durant la création d'une carte, vous devez garder à l'esprit que la plupart du temps la rivière ou la montagne seront trop petites donc vous devrez fournir une surface additionnelle pour le clic de la souris. Dans cet exemple la rivière aura la région de couleur marron et la couleur <20,76,34> comme identifiant. </para>
</sect1>
</chapter>
<chapter id="commands">
<title
>Référence des commandes</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
>La fenêtre principale de &kgeography;</title>
<sect2>
<title
>Le menu <guimenu
>Fichier</guimenu
></title>
<para>
<variablelist>
<varlistentry>
<term
><menuchoice
><shortcut
> <keycombo action="simul"
>&Ctrl;<keycap
>O</keycap
></keycombo
> </shortcut
> <guimenu
>Fichier</guimenu
> <guimenuitem
>Ouvrir la carte...</guimenuitem
> </menuchoice
></term>
<listitem
><para
><action
>Ouvre la boîte de dialogue de choix d'une carte</action
></para
></listitem>
</varlistentry>
<varlistentry>
<term
><menuchoice
><shortcut
> <keycombo action="simul"
>&Ctrl;<keycap
>Q</keycap
></keycombo
> </shortcut
> <guimenu
>Fichier</guimenu
> <guimenuitem
>Quitte</guimenuitem
> </menuchoice
></term>
<listitem
><para
><action
>Quitte</action
> &kgeography;</para
></listitem>
</varlistentry>
</variablelist>
</para>
</sect2>
<sect2>
<title
>Le menu <guimenu
>Affichage</guimenu
></title>
<para>
<variablelist>
<varlistentry>
<term
><menuchoice
><guimenu
>Affichage</guimenu
> <guimenuitem
>Zoom</guimenuitem
> </menuchoice
></term>
<listitem
><para
><action
>Entre dans le mode zoom</action
></para
></listitem>
</varlistentry>
<varlistentry>
<term
><menuchoice
><guimenu
>Affichage</guimenu
> <guimenuitem
>Taille originale</guimenuitem
> </menuchoice
></term>
<listitem
><para
><action
>Redimensionne</action
> la carte à sa taille originelle</para
></listitem>
</varlistentry>
<varlistentry>
<term
><menuchoice
><guimenu
>Affichage</guimenu
> <guimenuitem
>Bouger</guimenuitem
> </menuchoice
></term>
<listitem
><para
><action
>Fait</action
> bouger la carte</para
></listitem>
</varlistentry>
</variablelist>
</para>
</sect2>
<sect2>
<title
>Le menu <guimenu
>Configuration</guimenu
></title>
<para>
<variablelist>
<varlistentry>
<term
><menuchoice
><guimenu
>Configuration</guimenu
> <guimenuitem
>Afficher/Cacher la barre d'outils</guimenuitem
> </menuchoice
></term>
<listitem
><para
><action
>Affiche/Cache la barre d'outils de &kgeography;.</action
></para
></listitem>
</varlistentry>
<varlistentry>
<term
><menuchoice
><guimenu
>Configuration</guimenu
> <guimenuitem
>Configurer les raccourcis clavier...</guimenuitem
> </menuchoice
></term>
<listitem
><para
><action
>Configure les raccourcis clavier pour &kgeography;.</action
></para
></listitem>
</varlistentry>
<varlistentry>
<term
><menuchoice
><guimenu
>Configuration</guimenu
> <guimenuitem
>Configure les barres d'outils...</guimenuitem
> </menuchoice
></term>
<listitem
><para
><action
>Configure la barre d'outils de &kgeography;.</action
></para
></listitem>
</varlistentry>
</variablelist>
</para>
</sect2>
<sect2>
<title
>Le menu <guimenu
>Aide</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
>Remerciements et licence</title>
<para
>&kgeography; </para>
<para
>Programme copyright 2004-2005 Albert Astals Cid <email
