# O Manual do &kontact;

## Introdução

O &kontact; é a solução integrada para as suas necessidades de gestão de informações pessoais (&PIM;). Ele combina as aplicações conhecidas do &kde; (o &kmail;, o &korganizer;, o &knotes;, o &knode; e o &kaddressbook;) numa única interface. Baseando-se numa verdadeira plataforma de componentes, o &kontact; oferece exactamente a mesma funcionalidade que as aplicações em separado, adicionando ainda algumas funcionalidades, tirando partido da forma integrada como o &kontact; corre as aplicações como componentes. Os utilizadores terão à mesma ainda a hipótese de escolher as aplicações que são executadas dentro do &kontact; e quais são executadas à parte.

Para além da funcionalidade das aplicações individuais que o &kontact; oferece, existe ainda uma área de resumo e algumas funcionalidades avançadas de 'drag & drop' entre componentes.

## Componentes do &kontact;

O &kontact; integra as seguitens aplicações. Veja os manuais das mesmas para mais detalhes sobre como as usar. Estas aplicam-se à sua execução delas como componentes dentro do &kontact;, da mesma forma que são executadas isoladamente.

- &kmail;, o cliente de e-mail do &kde;.

- &korganizer;, a agenda do &kde;.

- &kaddressbook;, o gestor de contactos do &kde;.

- &knotes;, notas amarelas.

- &knode;, o leitor de notícias do &kde;.

- &kpilot;, a aplicação do &kde; para sincronizar o Pilot.

- &kitchensync;, a aplicação de sincronização do &kde;.

- &akregator;, o leitor de fontes de RSS do &kde;.

## A Janela Principal do &kontact;

A janela principal consiste numa área lateral à esquerda que mostra os ícones dos componentes disponíveis, na área principal à direita que contém a janela principal do componente activo e o menu normal, assim como as barras de ferramentas e de estado.

### Barra Lateral

A área lateral serve vários objectivos. Ela permite mudar de componente para componente, mostra qual o componente activo e serve como destino para as operações de 'drag & drop' para as várias aplicações.

Área lateral do &kontact; Área lateral do &kontact;

Área lateral do &kontact;

Para mudar de componente, basta carregar no ícone correspondente. A janela principal do componente é mostrada e o menu, as barras de ferramentas e de estado são adaptadas para reflectir a funcionalidade do componente activo. Se você activar um componente pela primeira vez, poderá ocorrer um pequeno atraso até que a janela principal seja alterada, dado que os componentes são carregados a pedido. Isto significa que você não irá gastar memória pelos componentes que não usar.

Os ícones da área lateral também poderão ser usados para operações de 'drag & drop'. Por exemplo, você poderá arrastar uma mensagem da componente de e-mail e largá-la no ícone da lista de itens por-fazer ou no calendário ou criar uma tarefa por-fazer ou um evento associado a essa mensagem.

Finalmente, você poderá alterar o tamanho dos ícones na barra lateral. Se carregr com o botão direito na área lateral, aparecerá a opção para usar ícones Grandes, Normais ou Pequenos, assim como a opção para usar apenas texto, em vez dos ícones.

Se você não gostar da barra lateral, poderá simplesmente escondê-la, arrastando para tal a barra separadora. Existe uma navegação alternativa entre os comonentes através da barra de navegação, a qual poderá ser posicionada em qualquer lado.

### Janela Principal

A janela à direita, que ocupa a maior parte da área da janela principal do &kontact; mostra o componente activo. Isto corresponde exactamente à janela principal que o componente usa ao executar-se como uma aplicação autónoma. O ícone realçado na área lateral indica a que aplicação pertence a janela principal. O &kontact; recorda qual o componente que estava activo, para que, ao iniciar o &kontact;, a janela mostre inicialmente a aplicação que estava activa quando saiu da última vez do &kontact;.

A Janela Principal do &kontact; A Janela Principal do &kontact;

A Janela Principal do &kontact;

Para além disso, existem duas formas de alterar o componente com que o &kontact; se inicia. A primeira é um argumento para a chamada do programa &kontact; (veja em command-line). A segunda é uma opção na janela de Configuração do &kontact;, que lhe permitirá iniciar sempre o &kontact; num determinado modo.

Opção do Componente Inicial do &kontact; Opção do Componente Inicial do do &kontact;

Opção do Componente Inicial do &kontact;

### Barras de Menu, Ferramentas e Estado

As barras de menu, de ferramentas e de estado são adaptadas de acordo com o componente activo. Isto significa que, para além de algumas funções comuns como o menu de ajuda, que são mostradas para todos os componentes, existem algumas acções que são alteradas quando se muda de componente activo. Estas acções disponíveis para cada componente são as mesmas que ficam também disponíveis quando a aplicação é executada de forma anónima.

Vistas dos menus do &kontact; no Resumo, no E-mail e no Calendário Vistas dos menus do &kontact; no Resumo, no E-mail e no Calendário Vistas dos menus do &kontact; no Resumo, no E-mail e no Calendário Vistas dos menus do &kontact; no Resumo, no E-mail e no Calendário Vistas dos menus do &kontact; no Resumo, no E-mail e no Calendário Vistas dos menus do &kontact; no Resumo, no E-mail e no Calendário

Vistas dos menus do &kontact; no Resumo, no E-mail e no Calendário

Uma acção especial que é comum a todos os componente é a acção Novo. Permite a criação de objectos novos, como mensagens de e-mail, contactos, compromissos e itens por-fazer, independentemente do componente que está activo. O componente responsável por processar o objecto seleccionado é iniciado, se necessário, e irá tratar do objecto criado.

Menu Novo do &kontact; Menu Novo do &kontact;

Menu Novo do &kontact;

### Funcionalidade de 'Drag and Drop'

O &kontact; oferece funcionalidades avançadas de 'drag and drop' entre os programas que contém. Segue-se uma breve descrição de cada uma das operações específicas de 'drag and drop' que poderão ser efectuadas, bem como o resultado de cada uma.

#### Lista de Por-Fazer do &kmail; -> &korganizer;

Se arrastar uma mensagem da área de Cabeçalhos do &kmail; para o ícone da lista de Itens Por-Fazer do &korganizer; ( ) irá criar um novo item Por-Fazer com o Mail: `Assunto` como título e From: `Remetente` To: `Destinatário` Subject: `Assunto` como conteúdo (em que o texto que apareça `desta forma` sejam informações da mensagem em si), assim como a mensagem de e-mail em si como anexo.

#### Calendário do &kmail; -> &korganizer;

Se arrastar uma mensagem da área de Cabeçalhos do &kmail; para o ícone do Calendário do &korganizer; ( ) irá criar um novo Evento com o Mail: `Assunto` como título e From: `Remetente` To: `Destinatário` Subject: `Assunto` como conteúdo (em que o texto que apareça `desta forma` sejam informações da mensagem em si), assim como a mensagem de e-mail em si como anexo.

Lembre-se que o arrastamento para o botão Por-Fazer irá criar um item Por-Fazer, enquanto que o arrastamento para o Calendário cria um Evento. Estão mais informações disponíveis sobre esta distinção na documentação do &korganizer;

#### &kmail; -> &kaddressbook;

O arrastamento de uma mensagem da área de Cabeçalhos do &kmail; para o ícone do &kaddressbook; ( ) irá criar um contacto para o endereço de e-mail do remetente, a menos que já exista um contacto com esse nome. Será notificado para esta acção através de uma janela.

#### Lista de Por-Fazer do &kaddressbook; -> &korganizer;

Se arrastar um número qualquer de itens da janela principal do &kaddressbook; para o ícone da lista de itens Por-Fazer do &korganizer; ( ) irá criar um novo item Por-Fazer com "Meeting" como título e os contactos seleccionados como participantes.

Lembre-se que o arrastamento para o botão Por-Fazer irá criar um item Por-Fazer, enquanto que o arrastamento para o Calendário cria um Evento. Estão mais informações disponíveis sobre esta distinção na documentação do &korganizer;

#### Calendário do &kaddressbook; -> &korganizer;

Se arrastar um número qualquer de itens da janela principal do &kaddressbook; para o ícone do Calendário do &korganizer; ( ) irá criar um novo Evento com "Meeting" como título e os contactos seleccionados como participantes.

Lembre-se que o arrastamento para o botão Por-Fazer irá criar um item Por-Fazer, enquanto que o arrastamento para o Calendário cria um Evento. Estão mais informações disponíveis sobre esta distinção na documentação do &korganizer;

## A Janela do Resumo

A janela por omissão que aparece quando inicia o &kontact; pela primeira vez é a janela do resumo. Ela mostra uma vista global sobre toda a informação relevante oferecida pelos vários componentes seleccionados do &kontact;. Estes poderão ser destaques do extractor de notícias, compromissos ou aniversários iminentes, itens por-fazer prestes a terminar, dados meteorológicos, etc. A informação que é mostrada é configuráevl ao seleccionar os componentes correspondentes na janela de configuração do &kontact;.

Vista de Resumo do &kontact; Vista de Resumo do &kontact;

Vista de Resumo do &kontact;

### Posicionar de Novo os Componentes da Vista de Resumo

A Vista de Resumo permite-lhe alterar o local onde os componentes se encontram na vista em si. Como tal, se preferir ter as suas Datas Especiais na parte iferior esquerda e os seus itens por-fazer na parte superior, poderá reorganizar a vista de resumo para reflectir isso.

O posicionamento dos componentes da Vista de Resumo é tão simples como arrastar os mesmos para a nova posição em que os deseja colocar. Carregue, e mantenha assim carregada, a área de título cinzenta do componente, arrastando o componente para onde o quiser colocar. Lembre-se que este posicionamento é feito em comparação com os outros componentes. Como tal, poderá mover o componente do Correio para baixo do componente de Itens Por-Fazer na vista, mas não o poderá colocar numa posição específica. Se só tiver um componente na sua vista de resumo, a única opção para mover é entre as duas colunas da vista; dois componentes poderão ficar ambos na mesma coluna ou um em cada coluna, e assim por diante. Sempre que estiver a arrastar um componente, irá ver uma pequena área de antevisão que segue o seu rato à volta, mostrando-lhe o componente.

Organizar a Vista de Resumo do &kontact; Organizar a Vista de Resumo do &kontact;

Organizar a Vista de Resumo do &kontact;

## Configurar o &kontact;

### A Janela de Configuração do &kontact;

Ao seleccionar a acção Configurar o &kontact; no menu Configuração, a janela de configuração do &kontact; é apresentada. Ela mostra uma lista com os componentes activos do &kontact;. O utilizador poderá carregar no símbolo - ao lado dos nomes dos componentes para expandir ou recolher as suas opções para que possa ver as opções do componente que está à procura. Se seleccionar uma das opções de configuração por baixo de cada cabeçalho, irá mostrar essa secção de configuração à direita.

Janela de Configuração do &kontact; Janela de Configuração do &kontact;

Janela de Configuração do &kontact;

Para além disso, ao carregar no botão Configurar..., poderá mostrar uma janela que lhe permitirá seleccionar os componentes que deseja activar numa lista. Ao assinalar a opção ao lado do título do componente, você diz ao componente para ser colocado na barra lateral e na janela do resumo. O componente é carregado e a sua janela principal aparece na janela principal de cada vez que for carregado o seu ícone na área alteral pela primeira vez. Ao desligar a opção, o componente é removido da área lateral e da área de resumo. As alterações ficam efectivas quando carregar nos botões Aplicar ou OK.

Janela de Selecção de Componentes do &kontact; Janela de Selecção de Componentes do &kontact;

Janela de Selecção de Componentes do &kontact;

Poderá também configurar os componentes individuais se activar o componente, seleccionando o ícone correspondente na área lateral da sua janela principal e seleccione o item de menu Configurar o `nome da aplicação` no menu Configuração.

Menu de Configuração do &kontact; Quando Está Seleccionado o KMail Menu de Configuração do &kontact; Quando Está Seleccionado o KMail

Menu de Configuração do &kontact; Quando Está Seleccionado o KMail

### Configurar a Vista do Resumo do &kontact;

Quando seleccionar a opção Configurar a Vista de Resumo... do menu Configuração do &kontact; (só disponível na Vista de Resumo), aparece uma janela que lhe permite seleccionar os 'plugins' de resumo que o &kontact; deverá mostrar na sua vista de resumo. Aqui está uma breve lista dos 'plugins' já disponíveis e o que estes fazem:

#### 'Plugins' de Resumo do &kontact;: Calendário

O 'plugin' de Calendário para a vista do Resumo do &kontact; adiciona uma área à janela chamada Compromissos. Isto irá mostrar os compromissos que se aplicam de momento.

'Plugin' de Resumo do Calendário do &kontact; 'Plugin' de Resumo do Calendário do &kontact;

'Plugin' de Resumo do Calendário do &kontact;

#### 'Plugins' de Resumo do &kontact;: Contactos

O 'plugin' de Contactos do &kontact; adiciona uma área à janela chamada Datas de Nascimento e Aniversários, onde as datas de nascimento e os aniversários dos seus contactos são apresentados (para os contactos que têm essa informação definida na sua informação de contacto; veja a documentação do &kaddressbook; para mais informações sobre a configuração da informação relevante dos contactos). Ela contém os seguintes dados:

- Número de dias a partir de agora em que o item irá ocorrer

- Data de nascimento/aniversário

- Nome (Carregue neste para lhe enviar um e-mail ou carregue com o &RMB; para poder ver a informação do contacto)

- Idade/Ano do Aniversário

'Plugin' de Resumo dos Contactos do &kontact; 'Plugin' de Resumo dos Contactos do &kontact;

'Plugin' de Resumo dos Contactos do &kontact;

#### 'Plugins' de Resumo do &kontact;: KPilot

O 'plugin' do KPilot para a Vista de Resumo do &kontact; adiciona uma área à janela chamada Informação do KPilot. Esta área contém várias informações do KPilot, incluindo:

- A última sincronização (com o registo da sincronização)

- O utilizador que sincronizou da última vez

- O dispositivo sincronizado da última vez

- O estado actual

- As condutas disponíveis

'Plugin' de Resumo do KPilot do &kontact; 'Plugin' de Resumo do KPilot do &kontact;

'Plugin' de Resumo do KPilot do &kontact;

#### 'Plugins' de Resumo do &kontact;: E-mail

O 'plugin' de E-mail da Vista de Resumo do &kontact; adiciona uma área à janela chamada Mensagens Novas. Esta área é actualizada sempre que você recebe mensagens novas, para o informar de quantas mensagens destas existem e as pastas em que se encontram.

'Plugin' de Resumo do E-Mail do &kontact; 'Plugin' de Resumo do E-Mail do &kontact;

'Plugin' de Resumo do E-Mail do &kontact;

#### 'Plugins' de Resumo do &kontact;: KNewsTicker

O 'plugin' do NewsTicker para a Vista de Resumo do &kontact; adiciona uma área chamada Fontes de Notícias. Esta área contém as últimas notícias nas fontes configuradas de momento. Você poderá adicionar e remover fontes na Configuração da Vista de Resumo do &kontact;. Lembre-se, por favor que, desde o &kde; 3.4, a forma mais eficiente de aceder à informação das fontes de RSS é com a nova aplicação &akregator;, que oferece notificações em vez de verificar constantemente a Vista de Resumo, para saber se apareceram artigos novos.

'Plugin' do Extractor de Notícias do &kontact; 'Plugin' do Extractor de Notícias do &kontact;

'Plugin' do Extractor de Notícias do &kontact;

#### 'Plugins' de Resumo do &kontact;: Notas

O 'plugin' de Notas da Vista de Resumo do &kontact; adiciona uma área à janela chamada Notas. Esta área mostra todos os títulos das notas actuais (os título são, por omissão, a data/hora em que a nota foi criada). Se carregar no título de uma nota irá abrir a área de Notas.

'Plugin' de Resumo das Notas do &kontact; 'Plugin' de Resumo das Notas do &kontact;

'Plugin' de Resumo das Notas do &kontact;

#### 'Plugins' de Resumo do &kontact;: Lista de Por-Fazer

A Lista de Itens Por-Fazer da Vista de Resumo do &kontact; adiciona uma área à janela chamada Por-Fazer. Esta área contém todas as tarefas por fazer actuais, incluindo as que já foram terminadas por completo. Mostra o título dos itens, a percentagem de finalização e o estado actual do item. Repare que poderá retirar todos os itens por-fazer através da Lista de Itens Por-Fazer do &kontact;. Se carregar no título de um desses itens não fará nada de facto.

'Plugin' de Resumo dos Itens Por-Fazer do &kontact; 'Plugin' de Resumo dos Itens Por-Fazer do &kontact;

'Plugin' de Resumo dos Itens Por-Fazer do &kontact;

#### 'Plugins' de Resumo do &kontact;: Datas Especiais

O 'plugin' das Datas Especiais da Vista de Resumo do &kontact; adiciona uma área a esta chamada Datas Especiais. Esta área contém informações baseadas nos critérios seleccionados na área de confifiguração do 'plugin', na configuração da Vista de Resumo do &kontact;. O 'plugin' das Datas Especiais é especialmente útil, dado que pode mostrar os aniversários, férias e ocasiões especiais, tanto no calendário como na lista de contactos, apenas num local.

'Plugin' de Datas Especiais do &kontact; 'Plugin' de Datas Especiais do &kontact;

'Plugin' de Datas Especiais do &kontact;

#### 'Plugins' de Resumo do &kontact;: Meteorologia

O 'plugin' de Meteorologia da Vista de Resumo do &kontact; adiciona uma área à janela chamada Informação Meteorológica. Esta área contém as informações para as localizações meteorológicas configuradas de momento. Para mais informações sobre a configuração do KWeather, o notificador meteorológico que é usado como 'plugin' no &kontact;, veja a documentação do KWeather .

'Plugin' de Resumo Meteorológico do &kontact; 'Plugin' de Resumo Meteorológico do &kontact;

'Plugin' de Resumo Meteorológico do &kontact;

## O &kontact; na Linha de Comandos

O &kontact; tem vários argumentos da linha de comandos que poderão ser usados para certas acções.

Primeiro que tudo, o &kontact; suporta os argumentos da linha de comandos que todas as aplicações do KDE/Qt suportam. Poderá obter uma lista completa destas opções se escrever:

`%` `kontact --help-all`

O &kontact; também suporta vários argumentos da linha de comandos específico para eles.

### Argumentos da Linha de Comandos

#### Argumentos Relacionados com o Módulo

Para obter uma lista com os módulos disponíveis para o &kontact;, poderá escrever:

`%` `kontact --list`

Aí, para iniciar o &kontact; com um módulo activo, escreva:

`%` `kontact --module `nomeModulo``

Em que o `nomeModulo` é um dos módulos obtidos com o comando anterior.

## Por Dentro da Tecnologia

O &kontact; faz uma utilização extensiva de várias tecnologias-chave do &kde;, principalmente das KParts e do &DCOP;.

A integração da &GUI; dos componentes é feita através de 'plugins' que fornecem versões das KParts das aplicações. Isto só precisa de uma fina camada aplicacional por cima do código já existente da aplicação isolada.

Para a comunicação entre os componentes é usado o &DCOP;. Este tem a característica útil que é o facto de ser completamente transparente se a aplicação é executada de forma isolada ou embebida como uma KPart no &kontact;. Ao executar dentro do &kontact;, é usado um modo eficiente intrínseco ao processo do &DCOP;.

## Créditos e Licença

&kontact;

Programa copyright 2004, A Equipa de Desenvolvimento do &kde;

Contribuições:

- Cornelius Schumacher schumacher@kde.org

- Daniel Molkentin molkentin@kde.org

- Don Sanders sanders@kde.org

- Tobias König tokoe@kde.org

- Matthis Hölzer-Klüpfel mhk@kde.org, o autor original da infra-estrutura &kontact;.

- Todos os valorosos programadores das aplicações que o &kontact; integra. Eles fizeram quase todo o trabalho.

Documentação copyright 2004-2005

Contribuições:

- Cornelius Schumacher schumacher@kde.org

- Antonio Salazar savedfastcool@gmail.com

- Daniel Molkentin molkentin@kde.org

- Todos os membros da lista de documentação do KDE que assistiram nas questões de estilo e formatação.

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

A página do &kontact; está em http://kontact.kde.org

&underFDL; &underGPL;
&documentation.index;