tde-i18n/tde-i18n-fr/docs/tdeedu/kgeography/index.docbook

<?xml version="1.0" ?>
<!DOCTYPE book PUBLIC "-//KDE//DTD DocBook XML V4.2-Based Variant V1.1//EN" "dtd/kdex.dtd" [
  <!ENTITY kgeography "<application>KGeography</application>">
  <!ENTITY kappname "&kgeography;">
  <!ENTITY package "playground/edu">
  <!ENTITY % addindex "IGNORE">
  <!ENTITY % French "INCLUDE"> 
]>

<book lang="&language;">

<bookinfo>
<title>Le manuel de &kgeography;</title>

<authorgroup>
<author><personname> <firstname>Anne-Marie</firstname> <surname>Mahfouf</surname> </personname> <email>&Anne-Marie.Mahfouf.mail;</email> </author>
&traducteurAnneMarieMahfouf; 
</authorgroup>


<copyright>
<year>2005</year>
<holder>&Anne-Marie.Mahfouf;</holder>
</copyright>

<legalnotice>&FDLNotice;</legalnotice>

<date>2005-08-02</date>
<releaseinfo>0.4</releaseinfo>

<!-- Abstract about this handbook -->

<abstract>
<para>&kgeography; est un outil d'apprentissage de la géographie dans &kde;. Il comprend six modes d'utilisation : <itemizedlist>
<listitem>
<para>Parcourir les cartes et cliquer sur une région de la carte pour voir son nom, sa capitale et son drapeau</para>
</listitem>
<listitem>
<para>Le jeu vous donne le nom d'une région sur la carte et vous devez cliquer dessus</para>
</listitem>
<listitem>
<para>Le jeu vous donne une capitale et vous devez deviner à quelle région elle appartient</para>
</listitem><listitem>
<para>Le jeu vous donne une région et vous devez deviner sa capitale</para>
</listitem><listitem>
<para>Le jeu vous donne un drapeau et vous devez deviner à quelle région il appartient</para>
</listitem><listitem>
<para>Le jeu vous donne le nom d'une région et vous devez deviner son drapeau</para>
</listitem>
</itemizedlist>
</para>

</abstract>


<keywordset>
<keyword>KDE</keyword>
<keyword>tdeedu</keyword>
<keyword>KGeography</keyword>
<keyword>géographie</keyword>
<keyword>cartes</keyword>
<keyword>pays</keyword>
</keywordset>

</bookinfo>

<chapter id="introduction">
<title>Introduction</title>

<!-- 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>
	<mediaobject>
	  <imageobject>
	    <imagedata fileref="first-start1.png" format="PNG"/>
	  </imageobject>
	  <textobject>
	    <phrase>Voici une capture d'écran de &kgeography; au premier démarrage</phrase>
	  </textobject>
	</mediaobject>
</screenshot>
</para>
<para>Ici nous choisissons le Canada <screenshot>
<screeninfo>Le Canada est choisi</screeninfo>
	<mediaobject>
	  <imageobject>
	    <imagedata fileref="first-start2.png" format="PNG"/>
	  </imageobject>
	  <textobject>
	    <phrase>Le Canada est choisi</phrase>
	  </textobject>
	</mediaobject>
</screenshot>
</para>
<para>Et la fenêtre principale de &kgeography; apparaît avec une carte du Canada : <screenshot>
<screeninfo>La fenêtre principale de &kgeography;</screeninfo>
	<mediaobject>
	  <imageobject>
	    <imagedata fileref="first-start3.png" format="PNG"/>
	  </imageobject>
	  <textobject>
	    <phrase>La fenêtre principale de &kgeography;</phrase>
	  </textobject>
	</mediaobject>
</screenshot>
</para>
<para>Vous pouvez ensuite choisir quel type d'apprentissage ou de test vous voulez faire en regardant dans le menu sur la gauche. <screenshot>
<screeninfo>Le menu de &kgeography;</screeninfo>
	<mediaobject>
	  <imageobject>
	    <imagedata fileref="first-start4.png" format="PNG"/>
	  </imageobject>
	  <textobject>
	    <phrase>Le menu de &kgeography;</phrase>
	  </textobject>
	</mediaobject>
</screenshot>
</para>
<para>Parcourir la carte : un clic avec le &BGS; sur une région de la carte va afficher les informations sur cette région : <screenshot>
<screeninfo>Parcourir la carte</screeninfo>
	<mediaobject>
	  <imageobject>
	    <imagedata fileref="first-start5.png" format="PNG"/>
	  </imageobject>
	  <textobject>
	    <phrase>Parcourir la carte</phrase>
	  </textobject>
	</mediaobject>
</screenshot>
</para>
<para>Trouver une région sur la carte : on vous demande d'abord combien de questions vous voulez <screenshot>
<screeninfo>Nombre de questions</screeninfo>
	<mediaobject>
	  <imageobject>
	    <imagedata fileref="first-start6.png" format="PNG"/>
	  </imageobject>
	  <textobject>
	    <phrase>Nombre de questions</phrase>
	  </textobject>
	</mediaobject>
</screenshot>
</para>
<para>Puis on vous demande de cliquer sur une province donnée : <screenshot>
<screeninfo>Cliquez sur une province</screeninfo>
	<mediaobject>
	  <imageobject>
	    <imagedata fileref="first-start7.png" format="PNG"/>
	  </imageobject>
	  <textobject>
	    <phrase>Cliquez sur une province</phrase>
	  </textobject>
	</mediaobject>
</screenshot>
</para>
<para>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>
<screeninfo>Vos résultats</screeninfo>
	<mediaobject>
	  <imageobject>
	    <imagedata fileref="first-start8.png" format="PNG"/>
	  </imageobject>
	  <textobject>
	    <phrase>Vos résultats</phrase>
	  </textobject>
	</mediaobject>
</screenshot>
</para>
<para>Trouver une région à partir de sa capitale : vous devez trouver le nom d'une province parmi quatre noms à partir du nom de sa capitale :  <screenshot>
<screeninfo>Trouver une région à partir de sa capitale</screeninfo>
	<mediaobject>
	  <imageobject>
	    <imagedata fileref="first-start9.png" format="PNG"/>
	  </imageobject>
	  <textobject>
	    <phrase>Trouver une région à partir de sa capitale</phrase>
	  </textobject>
	</mediaobject>
</screenshot>
</para>
<para>Et les résultats s'affichent lorsque le test est terminé : <screenshot>
<screeninfo>Vos résultats</screeninfo>
	<mediaobject>
	  <imageobject>
	    <imagedata fileref="first-start10.png" format="PNG"/>
	  </imageobject>
	  <textobject>
	    <phrase>Vos résultats</phrase>
	  </textobject>
	</mediaobject>
</screenshot>
</para>
<para>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>
<screeninfo>Le questionnaire sur les drapeaux</screeninfo>
	<mediaobject>
	  <imageobject>
	    <imagedata fileref="first-start11.png" format="PNG"/>
	  </imageobject>
	  <textobject>
	    <phrase>Le questionnaire sur les drapeaux</phrase>
	  </textobject>
	</mediaobject>
</screenshot>
</para>
<para>Trouver le drapeau d'une région : un nom de région est donné et vous devez trouver le bon drapeau parmi quatre. <screenshot>
<screeninfo>faire correspondre le drapeau avec la région</screeninfo>
	<mediaobject>
	  <imageobject>
	    <imagedata fileref="first-start12.png" format="PNG"/>
	  </imageobject>
	  <textobject>
	    <phrase>faire correspondre le drapeau avec la région</phrase>
	  </textobject>
	</mediaobject>
</screenshot>
</para>
</chapter>

<chapter id="using-kapp">
<title>Utiliser &kgeography;</title>

<para>&kgeography; affiche des informations sur certaines régions et teste vos connaissances sur ces informations. <screenshot>
<screeninfo>Voici une capture d'écran de &kgeography;</screeninfo>
	<mediaobject>
	  <imageobject>
	    <imagedata fileref="kgeography.png" format="PNG"/>
	  </imageobject>
	  <textobject>
	    <phrase>Capture d'écran</phrase>
	  </textobject>
	</mediaobject>
</screenshot>
</para>


<sect1 id="kapp-features">
<title>Plus de caractéristiques de &kgeography;</title>

<para>Une autre caractéristique de &kgeography; est la possibilité de zoomer sur une carte. <screenshot> <screeninfo>Zoom</screeninfo> <mediaobject> <imageobject> <imagedata fileref="zoom.png" format="PNG"/> </imageobject> <textobject> <phrase>Zoom</phrase> </textobject> </mediaobject> </screenshot> Pendant que vous êtes en mode zoom, vous pouvez cliquer le &BGS; pour revenir à la taille d'origine de la carte (l'action <guimenuitem>Taille originale</guimenuitem> a le même effet). Utilisez les barres de déroulement pour parcourir la carte en mode zoom ou utilisez l'action <guimenuitem>Bouger</guimenuitem> qui vous permettra de faire glisser la carte en utilisant le &BGS;. </para>

</sect1>
</chapter>

<!--<chapter id="teachers-parents">
<title>Teachers/Parents guide to &kgeography; </title>
 This chapter should emphasize the educational aims of your app and
guide the parent/teacher on how to help the child using it.
</chapter>-->

<chapter id="how-to-maps">
<title>Comment fabriquer des cartes</title>
<para>Une carte dans &kgeography; consiste en deux fichiers, l'un est l'image de la carte et l'autre en est sa description. </para>
<sect1 id="helper-tool">
<title>Outil d'aide</title>
<para>Vous pouvez trouver <ulink url="http://kgeography.berlios.de/gen_map.pl">ici</ulink> 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 nom de 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">$<envar>TDEDIR</envar>/share/apps/kgeography/</filename></para> </listitem> <listitem> <para>Copiez les fichiers <acronym>PNG</acronym> des drapeaux (si besoin est) dans <filename class="directory">$<envar>TDEDIR</envar>/share/apps/kgeography/flags/</filename></para> </listitem> </itemizedlist> Une fois que ceci est fait, vous devriez pouvoir ouvrir votre carte dans &kgeography;. </para>
 <para>Si vous ne connaissez pas votre <filename class="directory">$<envar>TDEDIR</envar></filename>, saisissez <userinput><command>tde-config</command> <option>--prefix</option></userinput> dans un terminal. </para>
</sect1>
<sect1 id="non-political-maps">
<title>Cartes non politiques</title>
<para>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 &lt;20,76,34&gt; 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>tsdgeos@terra.es</email> </para>


<para>Documentation Copyright &copy; 2005 &Anne-Marie.Mahfouf; <email>&Anne-Marie.Mahfouf.mail;</email> </para>

<para>Traduction française par &AnneMarieMahfouf;</para> 
&underFDL; &underGPL; </chapter>

<appendix id="installation">
<title>Installation</title>

<sect1 id="getting-kapp">
<title>Comment obtenir &kgeography;</title>
&install.intro.documentation; </sect1>


<sect1 id="compilation">
<title>Compilation et installation</title>
&install.compile.documentation; </sect1>


</appendix>

&documentation.index;
</book>

<!--
Local Variables:
mode: xml
sgml-minimize-attributes:nil
sgml-general-insert-case:lower
sgml-indent-step:0
sgml-indent-data:nil
End:

vim:tabstop=2:shiftwidth=2:expandtab 
-->