# O Manual do &kontact;

## Introdução

O &kontact; é a solução integrada para as suas necessidades de gestão de informações pessoais. 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;.

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

## 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 &kf5;/&Qt; suportam; veja as páginas de manual do 'qt5options' e 'kf5options'.

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.

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

&underFDL; &underGPL;

## Guia do Administrador

### Questões de Compatibilidade

Esta secção oferece alguma ajuda sobre como fazer o &kontact; comunicar de forma efectiva com as diversas soluções de 'groupware'.

#### Outlook e Exchange

Na janela de configuração do &kontact;, em Correio Diversos, na página de Convites, irá encontrar as seguintes opções que irão ajudar o utilizador a comunicar com o Microsoft Outlook(tm) a executar-se num ambiente do Kolab ou de Microsoft Exchange(tm).

Codificar os cabeçalhos De:/Para: nas respostas aos convites

- Active esta opção para que o Microsoft Outlook(tm) compreenda as suas respostas a convites.

  O Microsoft Outlook tem um conjunto de problemas na sua implementação da norma iCalendar; esta opção resolve um deles. Se tiver problemas com os utilizadores do Outlook a não conseguirem obter as suas respostas, tente activar esta opção.

  Detalhes: Ao enviar um convite de iCal, isto faz com que a mensagem tenha o cabeçalho 'De:' igual ao 'Para:'. Também configura o cabeçalho 'X-KMail-Identity' com o UIOD do 'Para:' e certifica-se que o BCC: vai em branco. O Outlook só irá compreender a resposta se o cabeçalho 'De:' for igual ao 'Para:' da mensagem de convite.

Enviar os convites no conteúdo da mensagem

- Os convites são normalmente enviados como anexos para um e-mail. Esta mudança muda o convite para ser enviado no texto do e-mail em alternativa; isto é necessário para enviar convites e respostas para o Microsoft Outlook. Contudo, quando fizer isto, nunca mais irá receber o texto descritivo que os programas de e-mail conseguem ler; como tal, para as pessoas que têm programas de e-mail que não compreendam esses convites, as mensagens resultantes irão ficar muito estranhas. As pessoas que têm programas de e-mail que compreendem esses convites serão capazes à mesma de trabalhar com isto.

  Detalhes: Ao enviar por e-mail um convite de iCal, esta opção cria o conteúdo da mensagem a partir dos dados do anexo e configura o cabeçalho 'Content-Type' como 'text/calendar; method=algo; charset="utf-8"'.

  O envio automático também está activado, para que não seja necessária nenhuma intervenção humana na composição.

  A encriptação e a assinatura automática estão desactivadas.

Nomenclatura de convites compatível com o Exchange

- O Microsoft Outlook, quando é usado em conjunto com um servidor de Microsoft Exchange(tm), tem um problema em compreender o e-mail de 'groupware' compatível com as normas. Active esta opção para enviar os convites de 'groupware' de uma forma que o Microsoft Exchange(tm) compreenda. O convite será enviado como um anexo com o nome `ical.ics`.

  Detalhes: Ao enviar um convite de iCal, isto fará com que a mensagem tenha o assunto "(Declined|Tentative|Accepted|Delegated): assunto". O convite será enviado como um anexo com o nome `ical.ics`.

Nomeação de anexos compatível com o Outlook

- Active esta opção para fazer com que o Outlook(tm) compreenda os nomes dos anexos que contêm caracteres não-Ingleses.

### Questão de Comportamento

Esta secção fornece instruções sobre pôr o &kontact; a comportar-se como outros clientes de 'groupware'.

#### Compor Mensagens

Os utilizadores do Outlook estão acostumados a escrever uma lista de endereços nos campos 'Para:', 'CC:' ou 'BCC:' separados por um ponto-e-vírgula (';'), para além de uma vírgula (','). Por omissão, o &kontact; só permite a vírgula como um carácter separador de endereços. Para também permitir o ponto-e-vírgula, mude a opção `AllowSemicolonAsAddressSeparator` de 'false' para 'true' no ficheiro `share/config.kcfg/messagecomposer.kcfg` instalado.

### Compromissos do RFC

O &kontact; está desenhado para interagir tão bem quanto possível com uma grande variedade de soluções de 'groupware'. Para esse fim, algumas vezes tomamos alguns compromissos de desenho no que respeita aos diversos RFC's da Internet que fornecem a base para as bibliotecas de baixo nível em que se baseia o &kontact;.

Nunca violamos de livre vontade nenhum RFC.

A seguinte lista de compromissos do RFC é feita pelo &kontact; ou pelas bibliotecas de baixo-nível usadas pelo &kontact;:

- Ao escrever os valores de duração nos ficheiros do iCalendar, o &kontact; nunca grava a propriedade DURATION em termos de semanas (i.e., 1*DIGIT "W"); em vez disso, o número inteiro de semanas é sempre multiplicado por 7 e é gravado em termos de dias (i.e. 1*DIGIT "D").

&documentation.index;