# Manual do &kontact;

## Introdução

&kontact; é a solução integrada para suas necessidades de gerenciamento de informações pessoais. Ele combina os aplicativos de e-mail, agenda e livro de endereços conhecidos do &kde; (&kmail;, &korganizer; e &kaddressbook;), em uma única interface. Baseando-se numa verdadeira plataforma de componentes, o &kontact; oferece exatamente as mesmas funcionalidades dos aplicativos individuais, adicionando ainda algumas funcionalidades, que aproveitam a forma integrada como o &kontact; executa os aplicativos como componentes. Os usuários ainda terão a possibilidade de escolher os aplicativos que são executados dentro do &kontact; e quais são executados individualmente.

Além das funcionalidades dos aplicativos individuais que o &kontact; oferece, existe ainda uma área de resumo e algumas funcionalidades avançadas de arrastar & soltar entre os componentes.

## Componentes do &kontact;

O &kontact; integra os seguintes aplicativos. Veja os manuais dos mesmos para mais detalhes sobre como usá-los. Estes detalhes se aplicam tanto a sua execução como componentes dentro do &kontact;, como quando são executados isoladamente.

&kmail;

- O cliente de e-mail do &kde;.

&korganizer;

- O aplicativo de calendário e agenda do &kde;.

&kaddressbook;

- O gerenciador de contatos 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, uma área principal à direita que contém a janela principal do componente ativo e o menu normal, assim como as barras de ferramentas e de estado.

### Painel Lateral

O painel lateral serve vários objetivos. Ele permite mudar de componente para componente, mostra qual o componente ativo e serve como destino para as operações de arrastar & soltar para os diferentes aplicativos.

Painel Lateral do &kontact; Painel Lateral do &kontact;

Painel Lateral do &kontact;

Para mudar de componente, basta clicar no ícone correspondente. A janela principal do componente é mostrada e o menu, as barras de ferramentas e de estado são adaptadas para refletir as funcionalidades do componente ativo. Se você ativar um componente pela primeira vez, poderá ocorrer um pequeno atraso até que a janela principal seja alterada, uma vez que os componentes são carregados sob demanda. Isto significa que você não irá desperdiçar memória com os componentes que não estiverem em uso.

Os ícones da área lateral também poderão ser usados para operações de 'arrastar & soltar'. Por exemplo, você poderá arrastar uma mensagem do componente de e-mail e soltá-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 no painel lateral. Se clicar com o botão direito no painel 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 do painel lateral, poderá simplesmente ocultá-la, arrastando para isso 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 para mais informações sobre a barra de Navegação.

### Visão Principal

A visão à direita, que ocupa a maior parte da área da janela principal do &kontact; mostra o componente ativo. Isto corresponde exatamente à janela principal que o componente usa ao executar-se como um aplicativo individual. O ícone realçado no painel lateral indica a qual aplicativo pertence a visão principal. O &kontact; lembra qual o componente estava ativo ao sair, para que na próxima vez em que for iniciado, a visão mostre inicialmente o aplicativo que estava ativo na última vez que fechou o programa.

A Visão Principal do &kontact; A Visão Principal do &kontact;

A Visão Principal do &kontact;

Além disso, existem duas maneiras de alterar o componente do &kontact; ao iniciar. A primeira é indicar 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 acessar esta opção, vá para Configurações Configurar &kontact; e clique em Kontact na lista.

Configuração do Componente Inicial do &kontact; Configuração do componente inicial do &kontact;

Configuraçã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 ativo. Isto significa que, além de algumas funções comuns como o menu de ajuda, que são mostradas para todos os componentes, existem algumas ações que são alteradas quando se muda de componente ativo. As ações disponíveis para cada componente são as mesmas que ficam disponíveis ao executar o aplicativo de forma individual.

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.

Além disso, o &kontact; pode mostrar a barra de Navegação que lhe fornece acesso aos componentes do &kontact;, tal como acontece no painel lateral. Contudo, ao contrário do painel lateral, os botões da barra de Navegação não podem ser usados para as operações de 'arrastar & soltar' para os outros componentes.

Para ativar a barra de ferramentas, selecione a opção Configurações 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 ação especial que é comum a todos os componente é a ação Novo. Ela permite a criação de novos objetos, incluindo mensagens de e-mail, contatos, compromissos e tarefas, independentemente do componente que está ativo. O componente responsável por processar o objeto selecionado é iniciado, se necessário, e irá tratar do objeto criado.

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

Menu Novo do &kontact;

### Funcionalidades de Arrastar e Soltar

O &kontact; oferece funcionalidades avançadas de 'arrastar e soltar' entre os programas que ele contém. A seguir, está uma breve descrição de cada uma das operações específicas de 'arrastar e soltar' que poderão ser efetuadas, bem como o resultado de cada uma.

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

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.

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

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. Mais informações sobre esta distinção estão disponíveis na documentação do &korganizer;

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

O arrastamento de uma mensagem da painel de Cabeçalhos do &kmail; para o ícone do &kaddressbook; ( ) irá criar um contato para o endereço de e-mail do remetente, a menos que já exista um contato com esse nome. Uma caixa de diálogo lhe notificará desta ação.

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

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 contatos selecionados 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. Mais informações sobre esta distinção estão disponíveis na documentação do &korganizer;

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

Arrastando qualquer número de entradas da janela principal do &kaddressbook; para o ícone do Calendário do &korganizer; ( ) irá criar um novo Evento com "Reunião" como título e os contatos selecionados 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. Mais informações sobre esta distinção estão disponíveis na documentação do &korganizer;

## A Visão do Resumo

A janela padrão que aparece quando inicia o &kontact; pela primeira vez é a janela do resumo. Ela mostra uma vista global sobre todas as informações relevantes oferecida pelos vários componentes selecionados do &kontact;. Incluem-se os compromissos ou aniversários iminentes, tarefas a serem concluídas, novas mensagens, &etc; A informação mostrada é configurável selecionando-se os componentes correspondentes no diálogo de configuração do &kontact;.

Visão de Resumo do &kontact; Visão de Resumo do &kontact;

Visão de Resumo do &kontact;

### Reposicionando os Componentes da Visão de Resumo

A Visão de Resumo permite-lhe alterar o local onde os componentes se encontram na visão em si. Assim, se preferir ter as suas Datas Especiais na parte inferior esquerda e as suas tarefas na parte superior, você poderá reorganizar a visão de resumo para refletir isso.

O posicionamento dos componentes da Visão de Resumo é tão simples como arrastá-los para a nova posição em que deseja colocá-los. Mantenha pressionada a tecla &Ctrl;, clique e mantenha pressionada a área de título cinza do componente, arrastando-o para onde quiser colocá-lo. Lembre-se de que este posicionamento é feito em relação aos outros componentes. Assim, você poderá mover o componente do e-mail para baixo do componente de tarefas na visão, mas não poderá colocá-lo numa posição específica. Se tiver apenas um componente na sua visão de resumo, a única opção para mover é entre as duas colunas da visão; dois componentes poderão ficar ambos na mesma coluna ou um em cada coluna, e assim por diante. Sempre que estiver arrastando um componente, você verá uma pequena área de previsão que segue o seu mouse, mostrando-lhe a nova posição do componente.

Organizando a Visão de Resumo do &kontact; Organizando a Visão de Resumo do &kontact;

Organizando a Visão de Resumo do &kontact;

## Configurando o &kontact;

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

Ao selecionar a ação Configurar o &kontact; no menu Configurações, a janela de configuração do &kontact; é apresentada. Ela mostra uma lista com os componentes ativos do &kontact;. O usuário poderá clicar no símbolo > ao lado do nome do componente para expandir as opções do componente. Selecionar uma das opções de configuração abaixo de cada cabeçalho irá mostrar essa seçã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 próxima ao título do componente, você seleciona o componente que ficará visível no painel lateral e na visão do resumo. O componente é carregado e mostrado na janela principal cada vez que for clicado o seu ícone no painel lateral. Ao desmarcar a opção, o componente é removido do painel lateral e da visão de resumo. As alterações se tornam efetivas clicando nos botões Aplicar ou OK.

Você também pode configurar os componentes individuais clicando no ícone correspondente no painel lateral e selecionando o item de menu Configurar o `nome do aplicativo` no menu Configurações.

Menu de Configurações do &kontact; Quando Está Selecionado o &kmail; Menu de Configurações do &kontact; Quando Está Selecionado o &kmail;

Menu de Configurações do &kontact; Quando Está Selecionado o &kmail;

### Configurando a Visão do Resumo do &kontact;

Quando você selecionar a opção Resumos na janela de configurações do &kontact;, é exibida uma página que lhe permite selecionar os plugins de resumo que o &kontact; deverá mostrar na sua visão de resumo. Aqui está uma breve lista dos plugins já disponíveis e o que eles fazem:

Seleção do resumo Seleção do resumo

Seleção do resumo

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

O plugin de Calendário para a visão do Resumo do &kontact; adiciona uma área à visão chamada Próximos eventos. Isto irá mostrar os eventos que se aplicam atualmente.

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 Visão de Resumo do &kontact; adiciona uma área à visão chamada Mensagens Novas. Esta área é atualizada sempre que você recebe mensagens novas, para o informar quantas mensagens 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;: Lista de Itens Por-Fazer

A Lista de tarefas da visão de resumo do &kontact; adiciona uma área à janela chamada Tarefas pendentes. Esta área contém todas as tarefas atuais, incluindo as que já foram concluídas. Mostra o título dos itens, a porcentagem de finalização e o estado atual do item. Note que você poderá retirar todas as tarefas através da Lista de tarefas do &kontact;. Clicar no título de um desses itens não fará nada realmente.

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 de Datas especiais da Visão de Resumo do &kontact; adiciona uma área a esta chamada Próximas datas especiais. Esta área contém informações baseadas nos critérios selecionados na área de configuração do plugin, na configuração da visão de resumo do &kontact;. O plugin de Datas especiais é especialmente útil, uma vez que pode mostrar os aniversários, férias e ocasiões especiais, tanto no calendário como na lista de contatos, em apenas um local.

Plugin de datas especiais do &kontact; Plugin de datas especiais do &kontact;

Plugin de datas especiais do &kontact;

## O &kontact; na Linha de Comando

O &kontact; tem vários argumentos da linha de comando que poderão ser usados para determinadas ações.

Primeiramente, o &kontact; suporta os argumentos da linha de comando que todos os aplicativos do &kde-frameworks;/&Qt; suportam. Consulte as páginas de manual do qt6options e kf6options.

O &kontact; também suporta vários argumentos da linha de comando específicos para ele.

### Argumentos da linha de comando

#### Argumentos Relacionados com o Módulo

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

`%` `kontact --list`

Então, para iniciar o &kontact; com um módulo ativo, digite:

`%` `kontact --module `nomeMódulo``

Onde o `nomeMódulo` é um dos módulos obtidos com o comando anterior.

#### Argumentos Relacionados com a Inicialização

Para iniciar o &kontact; no modo minimizado

Este modo ocorre quando a janela do aplicativo está oculta e o aplicativo está disponível apenas na barra de tarefas.

, você poderá digitar:

`%` `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 dos aplicativos. Isto só precisa de uma fina camada adicional por cima do código já existente do aplicativo isolado.

Para a comunicação entre os componentes é usado o &DBus;. Ele tem a característica útil que é o fato de ser completamente transparente se o aplicativo é executado de forma isolada ou embutida 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 com copyright 2001-2025, A Equipe 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

- Rafael Fernández López ereslibre@kde.org

- &David.Faure; &David.Faure.mail;

- &Ingo.Kloecker; &Ingo.Kloecker.mail;

- Sven Lüppken sven@kde.org

- Torgny Nyblom nyblom@kde.org

- Zack Rusin zack@kde.org

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

- Todos os valorosos programadores dos aplicativos que o &kontact; integra. Eles fizeram quase todo o trabalho.

Documentação com 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 Marcus Gama marcus.gama@gmail.com

&underFDL; &underGPL;

## Guia do Administrador

### Problemas de compatibilidade

Esta seção fornece ajuda sobre como fazer o &kontact; se comunicar de forma eficaz com várias soluções de groupware.

#### Outlook e Exchange

Na janela de configuração do &kontact;, em Correio Diversos na página Convites você encontrará as seguintes opções que ajudarão o usuário a se comunicar com o Microsoft Outlook(tm) em execução em um ambiente Kolab ou em um ambiente Microsoft Exchange(tm).

Manipular cabeçalhos De:/Para: em respostas aos convites

- Ative esta opção para que o Microsoft Outlook(tm) entenda suas respostas às respostas de convite.

  O Microsoft Outlook possui um número de problemas em sua implementação do padrão do iCalendar. Esta opção soluciona um deles. Se você tem problemas com os usuários do Outlook, por eles não serem capazes de obter suas respostas, tente selecionar esta opção.

  Detalhes: Ao enviar um convite iCal por e-mail, isso faz com que a mensagem tenha o cabeçalho "De:" igual ao cabeçalho "Para:". Também define o cabeçalho X-KMail-Identity para o UIOD do campo "Para:" e garante que o campo "Cco:" esteja em branco. O Outlook só entenderá a resposta se o cabeçalho "De:" for igual ao cabeçalho "Para:" da mensagem de convite.

Enviar convites no corpo das mensagens

- Os convites normalmente são enviados como anexos de um e-mail. Esta opção altera o convite para ser enviado no corpo do e-mail; isso é necessário para enviar convites e respostas para o Microsoft Outlook. Mas, ao fazer isso, você não terá mais um texto descritivo que os programas de e-mail possam ler; portanto, para pessoas que têm programas de e-mail que não entendem os convites, as mensagens resultantes parecerão muito estranhas. Pessoas que têm programas de e-mail que entendem os convites ainda poderão trabalhar com esta opção.

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

  O envio automático também está ativado, portanto não é necessária intervenção humana para compor.

  A criptografia e a assinatura automática estão desativadas.

Nomes de convites compatíveis com o Exchange

- O Microsoft Outlook, quando usado em conjunto com um servidor Microsoft Exchange™, apresenta problemas para interpretar e-mails de groupware compatíveis com os padrões. Habilite esta opção para enviar convites de groupware de uma forma que o Microsoft Exchange™ reconheça. O convite será enviado como um anexo com o nome `ical.ics`.

  Detalhes: Ao enviar um convite iCal por e-mail, isso fará com que a mensagem tenha o assunto "(Recusado|Provisório|Aceito|Delegado): assunto". O convite será enviado como um anexo com o nome `ical.ics`.

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

- Ative esta opção para que o Outlook(tm) entenda os nomes dos anexos que contêm caracteres não ingleses.

### Problemas comportamentais

Esta seção fornece instruções sobre como fazer o &kontact; se comportar mais como outros clientes de groupware.

#### Composição de mensagens

Os usuários do Outlook estão acostumados a digitar uma lista de endereços nos campos Para:, Cc: ou Cco:, separados por um ponto e vírgula (';') além de uma vírgula (','). Por padrão, o &kontact; permite apenas a vírgula como separador de endereço. Para permitir também o ponto e vírgula, altere a opção `AllowSemicolonAsAddressSeparator` de false para true no arquivo `share/config.kcfg/messagecomposer.kcfg` instalado.

### Compromissos RFC

O &kontact; foi projetado para interoperar da melhor forma possível com uma ampla variedade de soluções de groupware. Para isso, às vezes fazemos concessões de design em relação aos vários RFCs da Internet que fornecem a base para bibliotecas de baixo nível das quais o &kontact; depende fortemente.

Nós nunca violamos conscientemente nenhuma RFC.

A seguinte lista de concessões de RFC é feita pelo &kontact; ou pelas bibliotecas de baixo nível usadas pelo &kontact;:

- Ao gravar valores de duração em arquivos iCalendar, o &kontact; nunca grava a propriedade DURATION em termos de semanas (ou seja, 1*DIGIT "S"); em vez disso, o número inteiro de semanas é sempre multiplicado por 7 e gravado em termos de dias (ou seja, 1*DIGIT "D").

&documentation.index;