# 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 seguintes 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 aplicação de calendário e agenda do &kde;.

&kaddressbook;

- O gestor de contactos do &kde;.

&knotes;

- A aplicação de notas autocolantes do &kde;.

&knode;

- O leitor de notícias do &kde;.

&akregator;

- O leitor de fontes de RSS do &kde;.

&ktimetracker;

- A ferramenta de registo de tempo 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 carregar 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 não gostar da barra lateral, poderá simplesmente escondê-la, arrastando para tal a barra separadora. Existe uma navegação alternativa entre os componentes através da barra de Navegação, a qual poderá ser posicionada em qualquer lado. Veja em bars mais informações sobre a barra de Navegação.

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

Para lhe aceder, vá a Configuração Configurar o Kontact e carregue em Kontact na lista.

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.

Para além disso, o &kontact; poderá mostrar uma barra de Navegação que lhe dá acesso aos componentes do &kontact;, tal como acontece na área lateral. Contudo, ao contrário da área lateral, os botões da barra de Navegação não podem ser usados para as operações de 'drag & drop' para os outros componentes.

Para activar a barra de ferramentas, seleccione a opção Configuração Barras de Ferramentas Visíveis Navegador.

Barra de Navegação do &kontact;. Barra de Navegação do &kontact;.

Barra de Navegação do &kontact;.

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;

### Atalhos do Teclado

O &kontact; oferece vários atalhos de teclado para um acesso simples a certas funcionalidades. Em baixo, encontra-se uma lista dos atalhos predefinidos; contudo, lembre-se que poderá configurar os atalhos de teclado se for a Configuração Configurar os Atalhos....

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

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

Os atalhos mencionados abaixo para mudar de componentes variam ligeiramente, dependendo dos componentes que tiver activado (veja em main-config). De um modo geral, os componentes poderão ser activados se usar o &Ctrl; em conjunto com um número; esse número poderá ser obtido se contar o número de itens desde o topo até ao item na área lateral.

Os atalhos seguintes são os predefinidos para o &kontact;:

### Atalhos do Teclado

Acção | Combinação de Teclas
A Janela do Resumo | &Ctrl;1
Componente de Correio | &Ctrl;2
Componente de Contactos | &Ctrl;3
Componente do Calendário | &Ctrl;4
Componente de Itens Por-Fazer | &Ctrl;5
Componente de Fontes de RSS | &Ctrl;6
Componente da Usenet | &Ctrl;7
Componente do Diário | &Ctrl;8
Componente de Blocos de Notas | &Ctrl;9
Novo `Item` | &Ctrl;N O Novo `Item` muda, dependendo do componente que está seleccionado de momento. É igual a Nova Mensagem para os componentes de Resumo e E-Mail, Novo Contacto para o componente de Contactos, Novo Evento para o componente do Calendário, Novo Item Por-Fazer para a lista de itens por fazer, Novo Diário para o componente do Diário e Nova Nota para o componente de Notas, Nova Fonte para o componente de Fontes e Novo Artigo para o componente de Notícias. Cada uma destas acções tem o seu próprio atalho de teclado como aparece abaixo.
Nova Mensagem | &Ctrl;&Shift;M
Novo Contacto | &Ctrl;&Shift;C
Novo Por-fazer | &Ctrl;&Shift;T
Nova Fonte | &Ctrl;&Shift;F
Novo Artigo | &Ctrl;&Shift;A
Novo Diário | &Ctrl;&Shift;J
Nova Página do KJots | &Ctrl;&Shift;P
Novo Livro do KJots | &Ctrl;&Shift;B
Nova Nota Autocolante | &Ctrl;&Shift;N
Nova Tarefa | &Ctrl;&Shift;W
Manual do &kontact; | F1
A ajuda O que é Isto? | &Ctrl;F1
Sair | &Ctrl;Q

## 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 notas, compromissos ou aniversários iminentes, itens por-fazer prestes a terminar, mensagens novas, &etc;. A informação que é mostrada é configurável 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 inferior 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, em conjunto com a tecla &Ctrl;, 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;

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

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 Resumos da janela de configuração o &kontact;, 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:

Selecção do Resumo Selecção do Resumo

Selecção do Resumo

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

O 'plugin' de Calendário para a vista do Resumo do &kontact; adiciona uma área à janela chamada Próximos Eventos. 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;: 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 Autocolantes. 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 Itens Por-Fazer

A Lista de Itens Por-Fazer da Vista de Resumo do &kontact; adiciona uma área à janela chamada Itens Por-Fazer Pendentes. 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 Próximas Datas Especiais. Esta área contém informações baseadas nos critérios seleccionados na área de configuraçã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;

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

Para iniciar o &kontact; no modo minimizado

Este modo ocorre quando a janela da aplicação está escondida e a aplicação está disponível apenas na barra de tarefas.

, poderá escrever:

`%` `kontact --iconify`

## Por Dentro da Tecnologia

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

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 &DBus;. 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 &DBus;.

## Créditos e Licença

&kontact;

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

Contribuições:

- &Cornelius.Schumacher; &Cornelius.Schumacher.mail;

- &Daniel.Molkentin; &Daniel.Molkentin.mail;

- &Don.Sanders; &Don.Sanders.mail;

- &Tobias.Koenig; &Tobias.Koenig.mail;

- Allen Winter winter@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; &Cornelius.Schumacher.mail;

- Antonio Salazar savedfastcool@gmail.com

- &Daniel.Molkentin; &Daniel.Molkentin.mail;

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

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

Tradução de José Nuno Pires zepires@gmail.com

&underFDL; &underGPL;
&documentation.index;