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

<book lang="&language;">

<bookinfo>
<title
>O Manual do &kworldclock;</title>

<authorgroup>
<author
>&Brad.Hards; &Brad.Hards.mail; </author>

<othercredit role="translator"
><firstname
>José</firstname
><surname
>Pires</surname
><affiliation
><address
><email
>zepires@gmail.com</email
></address
></affiliation
><contrib
>Tradução</contrib
></othercredit
> 
</authorgroup>

<copyright>
<year
>2004</year>
<holder
>&Brad.Hards;</holder>
</copyright>
<legalnotice
>&FDLNotice;</legalnotice>


<date
>2004-01-22</date>
<releaseinfo
>0.00.00</releaseinfo>

<abstract>
<para
>O &kworldclock; é uma aplicação que mostra as partes do mundo que estão expostas neste momento à luz do dia e as partes que estão de momento de noite. Mostra também a hora actual num conjunto de cidades do mundo inteiro. </para>
</abstract>

<keywordset>
<keyword
>KDE</keyword>
<keyword
>kdetoys</keyword>
<keyword
>kworldwatch</keyword>
<keyword
>Relógio Mundial</keyword>
<keyword
>relógio do dia / noite</keyword>
</keywordset>

</bookinfo>

<chapter id="introduction">
<title
>Introdução</title>


<para
>O &kworldclock; é uma aplicação que mostra as partes do mundo que estão expostas neste momento à luz do dia e as partes que estão de momento de noite. Mostra também a hora actual num conjunto de cidades do mundo inteiro. </para>

<para
>Por favor comunique todos os problemas ou funcionalidades para as listas de correio do &kde;. </para>
</chapter>

<chapter id="using-kapp">
<title
>Usar o &kworldclock;</title>

<sect1
><title
>A área principal</title>
<para
>Quando você inicia o &kworldclock;, você irá ver aparecer uma pequena janela, como é mostrado em baixo. </para>

<para>
<screenshot>
<screeninfo
>Aqui está uma imagem do &kworldclock;</screeninfo>
	<mediaobject>
	  <imageobject>
	    <imagedata fileref="screenshot.png" format="PNG"/>
	  </imageobject>
	  <textobject>
	    <phrase
>Imagem</phrase>
	  </textobject>
	</mediaobject>
</screenshot>
</para>

<para
>A secção clara (que na imagem acima cobre a zona da Antárctida, da Austrália, da África Oriental e do Sul e a maior parte da Ásia, mais o Oceano Índico e a parte ocidental do Oceano Pacífico) mostra a área que está neste momento exposta à luz do dia, enquanto a secção mais escura (que, na imagem acima, cobre a Europa Ocidental, a América do Norte e do Sul, e a zona do Árctico) mostra a área que neste momento está de noite. O contorno entre a secção clara e a escura é a área que está a passar pela madrugada ou pelo anoitecer. </para>

<para
>Cada quadrado preto pequeno indica uma cidade ou um centro populacional. Se você deixar o rato por cima (ou perto) de um dos quadrados pretos, você irá ver a data e hora actual para essa localização. Na imagem acima, é mostrado o território continental de Portugal. </para>

<para
>Você poderá achar mais conveniente expandir a janela, para que haja mais espaço entre os vários quadrados. Lembre-se que você poderá expandir a janela, carregando no botão de maximização (o segundo botão à direita no canto superior direito) ou usando o rato para arrastar o canto da janela principal. Uma janela expandida, com Lisboa (Portugal) seleccionado é mostrada em baixo. </para>

<para>
<screenshot>
<screeninfo
>Imagem do &kworldclock; com a janela expandida</screeninfo>
	<mediaobject>
	  <imageobject>
	    <imagedata fileref="screenshot-mlb.png" format="PNG"/>
	  </imageobject>
	  <textobject>
	    <phrase
>Imagem a mostrar a janela expandida, com Lisboa seleccionada.</phrase>
	  </textobject>
	</mediaobject>
</screenshot>
</para>

</sect1>

<sect1 id="kworldclock-clocks"
><title
>Configurar o &kworldclock; com os relógios dos fusos-horários</title>

<para
>Se você precisa de saber a hora num conjunto de zonas à volta do mundo, poderá ser útil ter o &kworldclock; a mostrar as horas aplicáveis. É mostrado em baixo um exemplo de como isso poderá ficar. </para>

<para>
<screenshot>
<screeninfo
>Imagem do &kworldclock; com relógios</screeninfo>
	<mediaobject>
	  <imageobject>
	    <imagedata fileref="screenshot-withclocks.png" format="PNG"/>
	  </imageobject>
	  <textobject>
	    <phrase
>Imagem a mostrar a janela expandida, com três relógios.</phrase>
	  </textobject>
	</mediaobject>
</screenshot>
</para>

<para
>Repare nos relógios para Perth, Sidney e Berlim na parte inferior da janela principal do &kworldclock;. </para>

<para
>Estes relógios são adicionados ao usar o botão direito do rato e seleccionando o item <guilabel
>Relógio</guilabel
>, como é mostrado em baixo. </para>

<para>
<screenshot>
<screeninfo
>Imagem do relógio do &RMB; do &kworldclock;</screeninfo>
	<mediaobject>
	  <imageobject>
	    <imagedata fileref="screenshot-rmb-clock.png" format="PNG"/>
	  </imageobject>
	  <textobject>
	    <phrase
>Imagem a mostrar o menu do &RMB; com o <guilabel
>Relógio</guilabel
> seleccionado.</phrase>
	  </textobject>
	</mediaobject>
</screenshot>
</para>

<para
>Isto irá permitir o acesso à selecção do <guilabel
>Adicionar...</guilabel
>, que irá mostrar uma janela como a que aparece em baixo. O conteúdo da janela é determinado a partir da cidade mais próxima do cursor do rato quando fizer a selecção. </para>

<para>
<screenshot>
<screeninfo
>Imagem da janela <guilabel
>Editar a Configuração do Relógio</guilabel
> do &kworldclock;</screeninfo>
	<mediaobject>
	  <imageobject>
	    <imagedata fileref="screenshot-clock-dialog.png" format="PNG"/>
	  </imageobject>
	  <textobject>
	    <phrase
>Imagem a mostrar a janela <guilabel
>Editar a Configuração do Relógio</guilabel
>.</phrase
> 
	  </textobject>
	</mediaobject>
</screenshot>
</para>


<para
>Você poderá agora fazer uma selecção apropriada para a legenda do relógio e para o fuso-horário. Repare que você poderá alterar a legenda para algo apropriado e o fuso-horário de acordo com a necessidade. Um exemplo, para a pequena cidade Australiana de Quairading, é mostrado em baixo. </para>

<para>
<screenshot>
<screeninfo
>Imagem da janela de &kworldclock; para <guilabel
>Editar a Configuração do Relógio</guilabel
> modificado para Quairading</screeninfo>
	<mediaobject>
	  <imageobject>
	    <imagedata fileref="screenshot-quairading-dialog.png" format="PNG"/>
	  </imageobject>
	  <textobject>
	    <phrase
>Imagem a mostrar a janela para <guilabel
>Editar a Configuração do Relógio</guilabel
> para Quairading.</phrase
> 
	  </textobject>
	</mediaobject>
</screenshot>
</para>

<para
>Quando você seleccionar OK, o item do relógio é adicionado ao fundo da janela principal. Uma imagem com o item extra para Quairading, é mostrado em baixo. </para>

<para>
<screenshot>
<screeninfo
>Imagem do &kworldclock; com o relógio em Quairading</screeninfo>
	<mediaobject>
	  <imageobject>
	    <imagedata fileref="screenshot-quairading-clock.png" format="PNG"/>
	  </imageobject>
	  <textobject>
	    <phrase
>Imagem a mostrar o relógio de Quairading.</phrase
> 
	  </textobject>
	</mediaobject>
</screenshot>
</para>

<para
>Você poderá reparar agora que Perth e Quairading estão agora a mostrar a mesma informação (dado que estão no mesmo fuso-horário). Neste caso, o item de Perth já não é mais necessário, por isso poderá ser removido. Isto pode ser feito se usar outra vez o botão direito do rato na área dos relógios e se seleccionar o item <guilabel
>Remover</guilabel
>. </para>

<para
>Você poderá também editar os itens se usar a opção <guilabel
>Editar...</guilabel
> no menu do botão direito do rato, o qual poderá ser útil para fazer as alterações menores. </para>

</sect1>

<sect1 id="kworldclock-flags"
><title
>Adicionar Bandeiras à Janela do &kworldclock;</title>

<para
>Como é mostrado na imagem em baixo, você poderá adicionar bandeiras aos locais do mapa (neste caso, Fremantle perto de Perth, Austrália Ocidental; perto de Moscovo, na Rússia e os Açores, no meio do Atlântico). Estas opções não afectam nenhuma outra funcionalidade - simplesmente permitem-lhe localizar rapidamente os pontos de interesse. </para>

<para>
<screenshot>
<screeninfo
>Imagem do &kworldclock; com bandeiras</screeninfo>
	<mediaobject>
	  <imageobject>
	    <imagedata fileref="screenshot-withflags.png" format="PNG"/>
	  </imageobject>
	  <textobject>
	    <phrase
>Imagem a mostrar a janela expandida com três bandeiras.</phrase>
	  </textobject>
	</mediaobject>
</screenshot>
</para>

<para
>Você poderá adicionar bandeiras se colocar o rato no ponto que deseja que apareça e usando o botão direito do rato para seleccionar o item <guilabel
>Bandeiras...</guilabel
>. Você poderá seleccionar uma das três bandeiras predefinidas (isto é, <guilabel
>Adicionar Vermelha</guilabel
>, <guilabel
>Adicionar Verde</guilabel
> ou <guilabel
>Adicionar Azul</guilabel
>), ou poderá seleccionar uma cor personalizada. </para>

<para
>Você usa a mesma acção do menu para remover uma bandeira (a que estiver mais próxima do rato quando você fizer a selecção do <guilabel
>Apagar Bandeira</guilabel
>) ou para remover todas as bandeiras usando a opção <guilabel
>Apagar Todas as Bandeiras</guilabel
>. </para>

</sect1>

<sect1 id="kworldclock-display"
><title
>Modificar a janela do &kworldclock;</title>

<para
>Para além dos relógios e bandeiras adicionais, existem outras pequenas variações menores que poderá fazer à área principal de visualização do &kworldclock;, como por exemplo não mostrar as bandeiras, não mostrar os pequenos quadrados pretos e não mostrar as áreas de dia/noite. Cada uma destas opções é seleccionada com o menu do botão direito do rato. </para>

<para
>Para activar e desactivar a visualização das secções de dia / noite, você usa o botão direito do rato e selecciona o item <guilabel
>Mostrar Luz Solar</guilabel
> do menu. De cada vez que a seleccionar, a opção será comutada. Quando a visualização do dia e da noite fica activa (o modo normal no primeiro arranque), existirá uma pequena marcação ao lado do <guilabel
>Mostrar Luz Solar</guilabel
>. Um exemplo do item do menu (com o dia / noite inactivo) é mostrado em baixo. </para>

<para>
<screenshot>
<screeninfo
>Imagem da luz do dia com o &RMB; do &kworldclock;</screeninfo>
	<mediaobject>
	  <imageobject>
	    <imagedata fileref="screenshot-rmb-daylight.png" format="PNG"/>
	  </imageobject>
	  <textobject>
	    <phrase
>Imagem a mostrar o menu do &RMB;, com a opção <guilabel
>Mostrar Luz do Dia</guilabel
>.</phrase>
	  </textobject>
	</mediaobject>
</screenshot>
</para>


<para
>Para activar e desactivar a visualização dos pequenos quadrados pretos das cidades, você usa o menu do botão direito e selecciona a opção <guilabel
>Mostrar Cidades</guilabel
> do menu. De cada vez que a selecciona, a selecção ficará comutada. Quando a visualização das cidades está activa (o modo normal no primeiro arranque), irá existirá uma pequena marcação ao lado do <guilabel
>Mostrar Cidades</guilabel
>. Um exemplo do item do menu (com as bandeiras activas) é mostrado em baixo. </para>

<para>
<screenshot>
<screeninfo
>Imagem do menu do &RMB; do &kworldclock; a mostrar as cidades</screeninfo>
	<mediaobject>
	  <imageobject>
	    <imagedata fileref="screenshot-rmb-cities.png" format="PNG"/>
	  </imageobject>
	  <textobject>
	    <phrase
>Imagem a mostrar o menu do &RMB; com a opção <guilabel
>Mostrar Cidades</guilabel
> seleccionada.</phrase>
	  </textobject>
	</mediaobject>
</screenshot>
</para>

<para
>Para activar e desactivar a visualização das bandeiras, você usa o menu do botão direito e selecciona a opção <guilabel
>Mostrar Bandeiras</guilabel
> do menu. De cada vez que a selecciona, a selecção ficará comutada. Quando a visualização das bandeiras está activa (o modo normal no primeiro arranque), irá existirá uma pequena marcação ao lado do <guilabel
>Mostrar Bandeiras</guilabel
>. Um exemplo do item do menu (com as bandeiras activas) é mostrado em baixo. </para>

<para>
<screenshot>
<screeninfo
>Imagem do menu do &RMB; do &kworldclock; a mostrar as bandeiras</screeninfo>
	<mediaobject>
	  <imageobject>
	    <imagedata fileref="screenshot-rmb-flags.png" format="PNG"/>
	  </imageobject>
	  <textobject>
	    <phrase
>Imagem a mostrar o menu do &RMB; com a opção <guilabel
>Mostrar Bandeiras</guilabel
>.</phrase>
	  </textobject>
	</mediaobject>
</screenshot>
</para>

<para
>Depois de reconfigurar o &kworldclock;, você poderá querer gravar as suas configurações. Isto é feito com o botão direito do rato, seleccionando a opção <guilabel
>Gravar a Configuração</guilabel
>. </para>

</sect1>

<sect1 id="kworldclock-maps"
><title
>Seleccionar mapas alternativos</title>
<para
>Para além do mapa de profundidade da superfície normal, você poderá adicionar novos mapas, os quais poderão ser seleccionados, usando o item <guilabel
>Tema do Mapa</guilabel
> do menu do botão direito do rato. O &kworldclock; vem com um único mapa, que dá uma ideia da profundidade da superfície (em relevo). Os mapas adicionais poderão ser obtidos em <ulink url="http://www.radcyberzine.com/xglobe"
>http://www.radcyberzine.com/xglobe</ulink
>. Os mapas têm de ser devidamente instalados - tipicamente em <filename
>share/apps/kworldclock/maps</filename
>, sob a directoria principal do &kde;. Consulte o administrador do seu sistema para o ajudar a fazer isto, se for necessário. </para>

<para
>Se você quiser usar o seu próprio mapa, você deverá certificar-se que Greenwich fica exactamente no meio do mapa e fornecer um ficheiro 'desktop' apropriado. </para>

</sect1>

</chapter>

<chapter id="developers">
<title
>Guia de Programação do &kworldclock;</title>

<para
>O requisito mais comum para a programação com o &kworldclock; é adicionar cidades ao mapa. As cidades são determinadas por um ficheiro chamado <filename
>zone.tab</filename
>, que se localiza na pasta <filename
>share/apps/kworldclock</filename
>, sob a directoria principal do &kde;. </para>

<para
>Para adicionar uma nova cidade, você terá de saber a latitude e longitude, assim como também a informação de fuso-horário aplicável. Existem informações adicionais sobre o formato exacto que é pedido para o ficheiro <filename
>zone.tab</filename
>. </para>

</chapter>

<chapter id="credits">
<title
>Créditos e Licença</title>

<para
>&kworldclock; </para>
<para
>Programa copyright 2000 Matthias Hoelzer-Kluepfel. </para>

<para
>Documentação Copyright &copy; 2004 &Brad.Hards; &Brad.Hards.mail;. </para>

<para
>Tradução de José Nuno Pires <email
>zepires@gmail.com</email
></para
> 
&underFDL; &underGPL; </chapter>

<appendix id="installation">
<title
>Instalação</title>

<sect1 id="getting-kapp">
<title
>Como obter o &kworldclock;</title>
&install.intro.documentation; </sect1>

<sect1 id="compilation">
<title
>Compilação e Instalação</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:

-->
