# O Manual do &kontact;

Cornelius Schumacher

    schumacher@kde.org

Antonio Salazar

    flossadvocate@bellsouth.net

2003 Cornelius Schumacher
&FDLNotice;
2004-06-29
0.9

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; como o &kmail;, o &korganizer; e o &kaddressbook; numa única interface para oferecer um acesso simples ao correio, à calendarização, ao livro de endereços e a outras funcionalidades de &PIM;.

KDE kdepim KMail Organizador KAddressBook KNotes PIM 'groupware' Outlook Evolution

## 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;.

## 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. Se o desejar, poderá alterar esta disposição para páginas na janela de configuração do &kontact;

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

### 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;

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

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;

#### 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;

## 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;: 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;: 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.

#### Argumentos Relacionados com o Ecrã Inicial

Também é possível desactivar o ecrã inicialk do Kontact com a opção:

% `kontact --nosplash`

## 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

Contribuições:

- Cornelius Schumacher schumacher@kde.org

- Antonio Salazarsavedfastcool@gmail.com

- 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;