<!-- 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; és una eina de geografia de KDE. Aquesta aplicació li permetrà aprendre la situació i nom dels països (fronteres, capitals i les seves banderes). </para>
<para
>Els mapes disponibles en la versió actual són: Àfrica, Àsia, Aústria, Brazil, Canadà, Xina, Europa, França, Alemanya, Itàlia, Itàlia per províncies,Nord i Centre Amèrica, Noruega, Polònia, Sudamèrica, Espanya, Estats Units i el planisferi. </para>
</chapter>
<chapter id="quick-start">
<title
>Inici Ràpid amb &kgeography;</title>
<para
>Quan inicieu &kgeography; la primera vegada, us preguntarà amb quin mapa voleu començar el joc. <screenshot>
<screeninfo
>Aquí teniu una captura de &kgeography; quan l'inicieu per primera vegada</screeninfo>
>Determineu la capital del país: us mostren el nom d'una capital i quatre noms de províncies i heu de escollir la correcta. Després un quadre de diàleg us mostrarà el resultat. </para>
<para
>Determineu el país o la povincia a partir d'una bandera i vós heu d'indicar a on pertany l'esmentada bandera. <screenshot>
> (de Yann Verley) amb la que us podrà ajudar en el mapa de França. Per a usar-ho només cal executar i llegir el missatge d'ajuda. Us crearà un fitxer amb extensió <literal role="extension"
>.kgm</literal
> de ipus de text plà i un altre fitxer amb els colors assignats per a cada divisió, així podreu omplir el mapa correctament.</para>
</sect1>
<sect1 id="description-file">
<title
>Descripció del fitxer</title>
<para
>The description file is needed and its file extension is <literal role="extension"
>.kgm</literal
>. It should begin with <sgmltag class="starttag"
>map</sgmltag
> and end with <sgmltag class="endtag"
>map</sgmltag
>. </para>
<para
>Incloure les etiquetes en el seu lloc: <itemizedlist>
<listitem>
<para
><sgmltag class="starttag"
>Fitxer del mapa</sgmltag
> i <sgmltag class="endtag"
> Fitxer del mapa</sgmltag
>: el nom del fitxer (sense la ruta de fitxer) conté el mapa de la imatge, &pex; <quote
>europe.png</quote
>.</para>
</listitem>
<listitem>
<para
><sgmltag class="starttag"
>nom</sgmltag
> i <sgmltag class="endtag"
>nom</sgmltag
>: el nom del mapa, &pex; <quote
>Europe</quote
>.</para>
</listitem>
<listitem>
<para
>Una <sgmltag class="starttag"
>zona</sgmltag
> i <sgmltag class="endtag"
> zona</sgmltag
> de cada zona del mapa.</para>
</listitem>
</itemizedlist>
</para>
<para
>Cada zona té aquestes etiquetes: <itemizedlist>
<listitem>
<para
><sgmltag class="starttag"
>nom</sgmltag
> i <sgmltag class="endtag"
>nom</sgmltag
>: el nom de la zona, &pex; <quote
>Albània</quote
>.</para>
</listitem>
<listitem>
<para
><sgmltag class="starttag"
>capital</sgmltag
> i <sgmltag class="endtag"
>capital</sgmltag
>: el nom de la capital de la divisió, &pex; <quote
>Tirana</quote
>.</para>
</listitem>
<listitem>
<para
><sgmltag class="starttag"
>ignore</sgmltag
> and <sgmltag class="endtag"
>ignore</sgmltag
>: can be set to <userinput
>yes</userinput
>, <userinput
>allowClickMode</userinput
> and <userinput
>no</userinput
>. If this tag is set to <userinput
>yes</userinput
> then the division will be ignored when asking for divisions in that map. It is then as if this division does not exist in &kgeography; quiz modes. If this tag is set to <userinput
>allowClickMode</userinput
> then &kgeography; will ask for the division in the <guibutton
>Click Division in Map...</guibutton
> mode but not in other quiz modes. Setting this tag to <userinput
>no</userinput
> means the division will appear in all modes (browse and quizzes). This tag is optional and when there is no <sgmltag class="starttag"
>ignore</sgmltag
> tag that means as it is set to <userinput
>no</userinput
>. For example <quote
>Algeria</quote
> has this tag set to <userinput
>yes</userinput
> in the <quote
>Europe</quote
> map which means that <quote
>Algeria</quote
> will not be part of any quiz in the <quote
>Europe</quote
> map.</para>
</listitem>
<listitem>
<para
><sgmltag class="starttag"
>bandera</sgmltag
> i <sgmltag class="endtag"
>bandera</sgmltag
>: el fitxer (sense ruta de fitxer) conté la bandera de la zona, &pex; <quote
>albania.png</quote
>. Aquesta etiqueta és optional. No és necessita per ales zones mentre <sgmltag class="starttag"
>ignoreu</sgmltag
> l'etiqueta fent <userinput
>d'acord</userinput
>.</para>
</listitem>
<listitem>
<para
><sgmltag class="starttag"
>color</sgmltag
> i <sgmltag class="endtag"
>color</sgmltag
>: el color de la zona del mapa.</para>
</listitem>
</itemizedlist>
</para>
<para
>El color està definit emprant tres etiquetes: <itemizedlist>
<listitem>
<para
><sgmltag class="starttag"
>vermell</sgmltag
> i <sgmltag class="endtag"
>vermell</sgmltag
>: component de color vermell. Té com a valors del 0 al 255.</para>
</listitem>
<listitem>
<para
><sgmltag class="starttag"
>verd</sgmltag
> i <sgmltag class="endtag"
>verd</sgmltag
>: component de color verd. Té com a valors del 0 al 255.</para>
</listitem>
<listitem>
<para
><sgmltag class="starttag"
>blau</sgmltag
> i <sgmltag class="endtag"
>blau</sgmltag
>: component de color blau. Té com a valors del 0 al 255.</para>
</listitem>
</itemizedlist>
</para>
<tip>
<para
>No és convenient crear 2 o 3 zones falses com el <quote
>Mar</quote
>, <quote
>Frontera</quote
> i <quote
>Costa</quote
> i canviar amb <sgmltag class="starttag"
>ignoreu</sgmltag
> amb l'etiqueta <userinput
>d'acord</userinput
>. </para>
</tip>
<important>
<para
>Tots els noms de les capitals i les zones estaran en anglès o català.</para>
</important>
</sect1>
<sect1 id="map-file">
<title
>Fitxer del mapa</title>
<para
>El fitxer del mapa és força senzill però enfeinós de fer. han d'estar fets amb extensió i format <acronym
>PNG</acronym
>. Podeu trobar mapes i convertir-los a <ulink url="http://www.odci.gov/cia/publications/factbook/docs/refmaps.html"
>Cia Reference Maps</ulink
>. Si no teniu mapes i els necessiteu podeu baixar-los des de <ulink url="http://www.odci.gov/cia/publications/factbook/reference_maps/pdf/political_world.pdf"
>world pdf</ulink
>, agafant la captura de pantalla i treballant a sobre d'ella. Cada zona del mapa haurà de tenir un i solament un color. Per a desar podeu emprar el programes de processaments d'imatges com <application
>The Gimp</application
> i <application
>Kolourpaint</application
>. </para>
</sect1>
<sect1 id="flags">
<title
>Banderes</title>
<para
>Si teniu d'usar l'etiqueta de la <sgmltag class="starttag"
>bandera </sgmltag
> podeu emprar fitxers de banderes. Han de tenir format i extensió <acronym
>PNG</acronym
> i tamany de 300x200 píxels podeu usar fitxers de <acronym
>SVG</acronym
>. Per obtenir <acronym
>SVG</acronym
> banderes dels països del món i d'altres regions, podeu consultar la colecció de banderes de Sodipodi<ulink url="http://www.sodipodi.com/index.php3?section=clipart/flags"
></ulink
>. </para>
</sect1>
<sect1 id="how-to-test">
<title
>Comprovar si funciona?</title>
<para
>Abans d'enviar el teu mapa l'Albert <email
>tsdgeos@terra.es</email
>, comprova que aquest no tingui errades. Pera desar-lo teniu que seguir: <itemizedlist
> <listitem
> <para
>Posar la descripció del mapa i el fitxer de la imatge del mapa al directori <filename class="directory"
>És possible de fer mapes no polítics? Sí pot ser! <screenshot>
<screeninfo
>Exemple de como crear un mapa no polític</screeninfo>
<mediaobject>
<imageobject>
<imagedata fileref="river.png" format="PNG"/>
</imageobject>
<textobject>
<phrase
>Exemple de com crear un mapa no polític</phrase>
</textobject>
</mediaobject>
</screenshot>
</para>
<para
>Per suposat, el concepte de zona pot ser extensiu a un riu o uan muntanya. Durant la creació del mapa, podeu mantenir en la teva ment quina muntanya o riu serà objecte del treball. En aquest exemple el riu tindrà el color <20,76,34> per a ser identificat. </para>
</sect1>
</chapter>
<chapter id="commands">
<title
>Referència de comandes</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 finestra principal de &kgeography;</title>
<sect2>
<title
>El Menú <guimenu
>Arxiva</guimenu
></title>
<para>
<variablelist>
<varlistentry>
<term
><menuchoice
><shortcut
> <keycombo action="simul"
>&Ctrl;<keycap
>O</keycap
></keycombo
> </shortcut
> <guimenu
>Arxiva</guimenu
> <guimenuitem
>Obrir el Mapa...</guimenuitem
> </menuchoice
></term>
<listitem
><para
><action
>Obrir el quadre de diàleg d'escollir el mapa</action
></para
></listitem>
</varlistentry>
<varlistentry>
<term
><menuchoice
><shortcut
> <keycombo action="simul"
>&Ctrl;<keycap
>Q</keycap
></keycombo
> </shortcut
> <guimenu
>Arxiva</guimenu
> <guimenuitem
>Sortir</guimenuitem
> </menuchoice
></term>
<listitem
><para
><action
>Sortir</action
> de &kgeography;</para
></listitem>
</varlistentry>
</variablelist>
</para>
</sect2>
<sect2>
<title
>El Menú <guimenu
>Visualitza</guimenu
></title>
<para>
<variablelist>
<varlistentry>
<term
><menuchoice
><guimenu
>Visualitza</guimenu
> <guimenuitem
>Zoom</guimenuitem
> </menuchoice
></term>
<listitem
><para
><action
>Aneu al mode de zoom</action
></para
></listitem>
</varlistentry>
<varlistentry>
<term
><menuchoice
><guimenu
>Visualitza</guimenu
> <guimenuitem
>Tamany Original</guimenuitem
> </menuchoice
></term>
<listitem
><para
><action
>Canvia</action
> el mapa torna al tamany original</para
></listitem>
</varlistentry>
<varlistentry>
<term
><menuchoice
><guimenu
>Visualitza</guimenu
> <guimenuitem
>Moure</guimenuitem
> </menuchoice
></term>
<listitem
><para
><action
>Moure</action
> el mapa actual</para
></listitem>
</varlistentry>
</variablelist>
</para>
</sect2>
<sect2>
<title
>El menú <guimenu
>Arranjament</guimenu
></title>
<para>
<variablelist>
<varlistentry>
<term
><menuchoice
><guimenu
>Arranjament</guimenu
> <guimenuitem
>Mostra/Amaga la Barra d'Eines</guimenuitem
> </menuchoice
></term>
<listitem
><para
><action
>Mostra/Amaga la barra d'eines de &kgeography;.</action
></para
></listitem>
</varlistentry>
<varlistentry>
<term
><menuchoice
><guimenu
>Arranjament</guimenu
> <guimenuitem
>Configura Dreceres...</guimenuitem
> </menuchoice
></term>
<listitem
><para
><action
>Configura les dreceres de &kgeography;.</action
></para
></listitem>
</varlistentry>
<varlistentry>
<term
><menuchoice
><guimenu
>Arranjament</guimenu
> <guimenuitem
>Configura la Barra d'Eines...</guimenuitem
> </menuchoice
></term>
<listitem
><para
><action
>Configura la barra d'eines &kgeography;.</action
></para
></listitem>
</varlistentry>
</variablelist>
</para>
</sect2>
<sect2>
<title
>El Menú d'<guimenu
>Ajuda</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
>Credits i Llicència</title>
<para
>&kgeography; </para>
<para
>Copyright del Programa 2004-2005 Albert Astals Cid <email