<!-- 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
>O &kgeography; é uma ferramenta de aprendizagem de geografia para o &kde;. Permite-lhe aprender sobre as divisões políticas de alguns países (divisões, capitais dessas divisões e as bandeiras associadas a elas, se existirem). </para>
<para
>Os mapas disponíveis na versão actual são: África, Ásia, Áustria, Brasil, Canadá, China, Europa, França, Alemanha, Itália, Itália por províncias, América do Norte e Central, Noruega, Polónia, América do Sul, Espanha, EUA e o mundo. </para>
</chapter>
<chapter id="quick-start">
<title
>Introdução Rápida ao &kgeography;</title>
<para
>Quando iniciar o &kgeography; pela primeira vez, ele perguntar-lhe-á para escolher um mapa com o qual iniciar. <screenshot>
<screeninfo
>Aqui está uma imagem do &kgeography; no primeiro arranque</screeninfo>
>Adivinhar a capital a partir de uma divisão: recebe o nome de uma capital e de quatro províncias, e terá de escolher a correcta. Como anteriormente, no fim aparece uma janela de resultado. </para>
<para
>Adivinhar uma divisão a partir da sua bandeira: é mostrada uma bandeira e terá de adivinhar a província a que pertence. <screenshot>
> uma ferramenta (feita por Yann Verley) que o ajudou com o mapa de França. Para descobrir como funciona, basta executá-la e ler a mensagem de ajuda. Basicamente, cria o ficheiro <literal role="extension"
>.kgm</literal
> a partir de um ficheiro de texto simples e cria um ficheiro com as cores que atribuiu a cada divisão, para que possa preencher o mapa de acordo com ele.</para>
</sect1>
<sect1 id="description-file">
<title
>Ficheiro de descrição</title>
<para
>O ficheiro da descrição é necessário e a sua extensão de ficheiro é <literal role="extension"
>: o nome do ficheiro (sem o local completo) que contém a imagem do mapa, ⪚ <quote
>europa.png</quote
>.</para>
</listitem>
<listitem>
<para
><sgmltag class="starttag"
>name</sgmltag
> e <sgmltag class="endtag"
>name</sgmltag
>: o nome do mapa, ⪚ <quote
>Europa</quote
>.</para>
</listitem>
<listitem>
<para
>Um <sgmltag class="starttag"
>division</sgmltag
> e <sgmltag class="endtag"
>division</sgmltag
> para cada divisão do mapa.</para>
</listitem>
</itemizedlist>
</para>
<para
>Cada divisão tem estas marcas: <itemizedlist>
<listitem>
<para
><sgmltag class="starttag"
>name</sgmltag
> e <sgmltag class="endtag"
>name</sgmltag
>: o nome da divisão, ⪚ <quote
>Albania</quote
>.</para>
</listitem>
<listitem>
<para
><sgmltag class="starttag"
>capital</sgmltag
> e <sgmltag class="endtag"
>capital</sgmltag
>: o nome da capital da divisão, ⪚ <quote
>Tirana</quote
>.</para>
</listitem>
<listitem>
<para
>O <sgmltag class="starttag"
>ignore</sgmltag
> e <sgmltag class="endtag"
>ignore</sgmltag
>: poderão ser configurados como <userinput
>yes</userinput
>, <userinput
>allowClickMode</userinput
> e <userinput
>no</userinput
>. Se esta marca for igual a <userinput
>yes</userinput
>, a divisão será ignorada ao pedir divisões nesse mapa. É como se esta divisão não existisse nos modos de questionário do &kgeography;. Se esta marca for igual a <userinput
>allowClickMode</userinput
>, então o &kgeography; irá perguntar a divisão no modo <guibutton
>Carregar a Divisão no Mapa...</guibutton
> mas não nos outros modos de questionário. Se configurar esta marca como <userinput
>no</userinput
>, significa que a divisão irá aparecer em todos os modos (navegação e questionários). Esta marca é opcional e, quando não existir qualquer marca <sgmltag class="starttag"
>ignore</sgmltag
>, significa que é iguala <userinput
>no</userinput
>. Por exemplo, a <quote
>Argélia</quote
> tem esta marca como <userinput
>yes</userinput
> no mapa da <quote
>Europa</quote
>, o que significa que a <quote
>Argélia</quote
> não fará parte de qualquer questionário sobre o mapa da <quote
>Europa</quote
>.</para>
</listitem>
<listitem>
<para
><sgmltag class="starttag"
>flag</sgmltag
> e <sgmltag class="endtag"
>flag</sgmltag
>: o ficheiro (sem qualquer informação da sua localização) que contém a bandeira da divisão, ⪚ <quote
>albania.png</quote
>. Esta marca é opcional. Não é necessário para as divisões cuja marca <sgmltag class="starttag"
>ignore</sgmltag
> seja igual a <userinput
>yes</userinput
>.</para>
</listitem>
<listitem>
<para
><sgmltag class="starttag"
>color</sgmltag
> e <sgmltag class="endtag"
>color</sgmltag
>: a cor que a divisão tem no mapa.</para>
</listitem>
</itemizedlist>
</para>
<para
>A cor é definida com três marcas: <itemizedlist>
<listitem>
<para
><sgmltag class="starttag"
>red</sgmltag
> e <sgmltag class="endtag"
>red</sgmltag
>: a componente vermelha da cor. Os valores válidos encontram-se entre 0 e 255.</para>
</listitem>
<listitem>
<para
><sgmltag class="starttag"
>green</sgmltag
> e <sgmltag class="endtag"
>green</sgmltag
>: a componente verde da cor. Os valores válidos encontram-se entre 0 e 255.</para>
</listitem>
<listitem>
<para
><sgmltag class="starttag"
>blue</sgmltag
> e <sgmltag class="endtag"
>blue</sgmltag
>: a componente azul da cor. Os valores válidos encontram-se entre 0 e 255.</para>
</listitem>
</itemizedlist>
</para>
<tip>
<para
>É conveniente criar 2 ou 3 divisões falsas, como a <quote
>Água</quote
>, <quote
>Fronteira</quote
> e <quote
>Costa</quote
> e configurá-las com a marca <sgmltag class="starttag"
>ignore</sgmltag
> igual a <userinput
>yes</userinput
>. </para>
</tip>
<important>
<para
>Todos os nomes (capitais e divisões) deverão estar em Inglês.</para>
</important>
</sect1>
<sect1 id="map-file">
<title
>Ficheiro do mapa</title>
<para
>O ficheiro do mapa é bastante simples mas é difícil de criar. Terá de estar no formato <acronym
>PNG</acronym
>. Poderá encontrar alguns mapas para transformar nos <ulink url="http://www.odci.gov/cia/publications/factbook/docs/refmaps.html"
>Mapas de Referência da CIA</ulink
>. Se nenhum dos mapas corresponder às suas necessidades, poderá obter o ficheiro <ulink url="http://www.odci.gov/cia/publications/factbook/reference_maps/pdf/political_world.pdf"
>world pdf</ulink
>, tirar uma imagem dele e trabalhar a partir daí. Cada divisão do mapa deverá ter uma e só uma cor. Para o fazer, poderá usar programas de processamento de imagem como o <application
>The Gimp</application
> e o <application
>Kolourpaint</application
>. </para>
</sect1>
<sect1 id="flags">
<title
>Opções</title>
<para
>Se tiver usado a marca <sgmltag class="starttag"
>flag</sgmltag
>, deverá indicar aos ficheiros das bandeiras. Terão de estar no formato <acronym
>PNG</acronym
> e o melhor será que tenham 300x200 pixels e exista um ficheiro <acronym
>SVG</acronym
> para ele. Para obter bandeiras em <acronym
>SVG</acronym
> de quase todos os países do mundo e de algumas divisões, poderá consultar a <ulink url="http://www.sodipodi.com/index.php3?section=clipart/flags"
>colecção de bandeiras do Sodipodi</ulink
>. </para>
</sect1>
<sect1 id="how-to-test">
<title
>Como testar</title>
<para
>Antes de enviar o seu mapa para o Albert <email
>tsdgeos@terra.es</email
>, deverá testá-lo para ver se não tem erros. Para o fazer, terá de efectuar o seguinte: <itemizedlist
> <listitem
> <para
>Colocar a descrição e o ficheiro de imagem do mapa em <filename class="directory"
>Exemplo de como criar um mapa não-político</screeninfo>
<mediaobject>
<imageobject>
<imagedata fileref="river.png" format="PNG"/>
</imageobject>
<textobject>
<phrase
>Exemplo de como criar um mapa não-político</phrase>
</textobject>
</mediaobject>
</screenshot>
</para>
<para
>Obviamente, o conceito da divisão poderá ser extendido a um rio ou montanha. Durante a criação do mapa, deverá ter em mente que, na maior parte dos casos, o rio ou a montanha serão demasiado pequenos, pelo que deverá oferecer uma área adicional onde carregar. Neste exemplo, o rio teria a zona acastanhada e a cor <20,76,34> como identificação. </para>
</sect1>
</chapter>
<chapter id="commands">
<title
>Referência de Comandos</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
>A janela principal do &kgeography;</title>
<sect2>
<title
>O Menu <guimenu
>Ficheiro</guimenu
></title>
<para>
<variablelist>
<varlistentry>
<term
><menuchoice
><shortcut
> <keycombo action="simul"
>&Ctrl;<keycap
>O</keycap
></keycombo
> </shortcut
> <guimenu
>Ficheiro</guimenu
> <guimenuitem
>Abrir um Mapa...</guimenuitem
> </menuchoice
></term>
<listitem
><para
><action
>Abre a janela para seleccionar o mapa a abrir</action
></para
></listitem>
</varlistentry>
<varlistentry>
<term
><menuchoice
><shortcut
> <keycombo action="simul"
>&Ctrl;<keycap
>Q</keycap
></keycombo
> </shortcut
> <guimenu
>Ficheiro</guimenu
> <guimenuitem
>Sair</guimenuitem
> </menuchoice
></term>
<listitem
><para
><action
>Sai</action
> do &kgeography;</para
></listitem>
</varlistentry>
</variablelist>
</para>
</sect2>
<sect2>
<title
>O Menu <guimenu
>Ver</guimenu
></title>
<para>
<variablelist>
<varlistentry>
<term
><menuchoice
><guimenu
>Ver</guimenu
> <guimenuitem
>Ampliação</guimenuitem
> </menuchoice
></term>
<listitem
><para
><action
>Vai para o modo de ampliação</action
></para
></listitem>
</varlistentry>
<varlistentry>
<term
><menuchoice
><guimenu
>Ver</guimenu
> <guimenuitem
>Tamanho Original</guimenuitem
> </menuchoice
></term>
<listitem
><para
><action
>Volta a colocar</action
> o mapa no seu tamanho original</para
></listitem>
</varlistentry>
<varlistentry>
<term
><menuchoice
><guimenu
>Ver</guimenu
> <guimenuitem
>Mover</guimenuitem
> </menuchoice
></term>
<listitem
><para
><action
>Pode posicionar-se</action
> no mapa actual</para
></listitem>
</varlistentry>
</variablelist>
</para>
</sect2>
<sect2>
<title
>O Menu <guimenu
>Configuração</guimenu
></title>
<para>
<variablelist>
<varlistentry>
<term
><menuchoice
><guimenu
>Configuração</guimenu
> <guimenuitem
>Mostrar/Esconder a Barra de Ferramentas</guimenuitem
> </menuchoice
></term>
<listitem
><para
><action
>Mostra/esconde a barra de ferramentas do &kgeography;.</action
></para
></listitem>
</varlistentry>
<varlistentry>
<term
><menuchoice
><guimenu
>Configuração</guimenu
> <guimenuitem
>Configurar os Atalhos...</guimenuitem
> </menuchoice
></term>
<listitem
><para
><action
>Configura os atalhos de teclado do &kgeography;.</action
></para
></listitem>
</varlistentry>
<varlistentry>
<term
><menuchoice
><guimenu
>Configuração</guimenu
> <guimenuitem
>Configurar as Barras de Ferramentas...</guimenuitem
> </menuchoice
></term>
<listitem
><para
><action
>Configura a barra de ferramentas do &kgeography;.</action
></para
></listitem>
</varlistentry>
</variablelist>
</para>
</sect2>
<sect2>
<title
>O Menu <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 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
>Créditos e Licença</title>
<para
>&kgeography; </para>
<para
>Programa com 'copyright' 2004-2005 de Albert Astals Cid <email