# O Manual do &kworldclock;

## Introdução

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.

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

## Usar o &kworldclock;

### A área principal

Quando você inicia o &kworldclock;, você irá ver aparecer uma pequena janela, como é mostrado em baixo.

Aqui está uma imagem do &kworldclock; Imagem

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.

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.

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.

Imagem do &kworldclock; com a janela expandida Imagem a mostrar a janela expandida, com Lisboa seleccionada.

### Configurar o &kworldclock; com os relógios dos fusos-horários

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.

Imagem do &kworldclock; com relógios Imagem a mostrar a janela expandida, com três relógios.

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

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

Imagem do relógio do &RMB; do &kworldclock; Imagem a mostrar o menu do &RMB; com o Relógio seleccionado.

Isto irá permitir o acesso à selecção do Adicionar..., 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.

Imagem da janela Editar a Configuração do Relógio do &kworldclock; Imagem a mostrar a janela Editar a Configuração do Relógio.

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.

Imagem da janela de &kworldclock; para Editar a Configuração do Relógio modificado para Quairading Imagem a mostrar a janela para Editar a Configuração do Relógio para Quairading.

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.

Imagem do &kworldclock; com o relógio em Quairading Imagem a mostrar o relógio de Quairading.

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 Remover.

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

### Adicionar Bandeiras à Janela do &kworldclock;

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.

Imagem do &kworldclock; com bandeiras Imagem a mostrar a janela expandida com três bandeiras.

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 Bandeiras.... Você poderá seleccionar uma das três bandeiras predefinidas (isto é, Adicionar Vermelha, Adicionar Verde ou Adicionar Azul), ou poderá seleccionar uma cor personalizada.

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 Apagar Bandeira) ou para remover todas as bandeiras usando a opção Apagar Todas as Bandeiras.

### Modificar a janela do &kworldclock;

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 activar e desactivar a visualização das secções de dia / noite, você usa o botão direito do rato e selecciona o item Mostrar Luz Solar 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 Mostrar Luz Solar. Um exemplo do item do menu (com o dia / noite inactivo) é mostrado em baixo.

Imagem da luz do dia com o &RMB; do &kworldclock; Imagem a mostrar o menu do &RMB;, com a opção Mostrar Luz do Dia.

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 Mostrar Cidades 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 Mostrar Cidades. Um exemplo do item do menu (com as bandeiras activas) é mostrado em baixo.

Imagem do menu do &RMB; do &kworldclock; a mostrar as cidades Imagem a mostrar o menu do &RMB; com a opção Mostrar Cidades seleccionada.

Para activar e desactivar a visualização das bandeiras, você usa o menu do botão direito e selecciona a opção Mostrar Bandeiras 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 Mostrar Bandeiras. Um exemplo do item do menu (com as bandeiras activas) é mostrado em baixo.

Imagem do menu do &RMB; do &kworldclock; a mostrar as bandeiras Imagem a mostrar o menu do &RMB; com a opção Mostrar Bandeiras.

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 Gravar a Configuração.

### Seleccionar mapas alternativos

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 Tema do Mapa 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 http://www.radcyberzine.com/xglobe. Os mapas têm de ser devidamente instalados - tipicamente em `share/apps/kworldclock/maps`, sob a directoria principal do &kde;. Consulte o administrador do seu sistema para o ajudar a fazer isto, se for necessário.

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.

## Guia de Programação do &kworldclock;

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

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 `zone.tab`.

## Créditos e Licença

&kworldclock;

Programa copyright 2000 Matthias Hoelzer-Kluepfel.

Documentação Copyright © 2004 &Brad.Hards; &Brad.Hards.mail;.

Tradução de José Nuno Pires jncp@netcabo.pt

&underFDL; &underGPL;

## Instalação

### Como obter o &kworldclock;

&install.intro.documentation;

### Compilação e Instalação

&install.compile.documentation;
&documentation.index;