# O Manual do &kaddressbook;

## Introdução

O &kaddressbook; é o livro de endereços ou agenda principal do &kde;. Permite-lhe gerir os seus contactos de forma eficiente e confortável. Dado que se baseia na biblioteca do 'kabc', suporta a noção de recursos, que poderá ser usado para ler e gravar os contactos em vários locais — não só o sistema de ficheiros local, mas também em servidores de LDAP e bases de dados em SQL.

A interface do utilizador é semelhante à do MS Outlook e suporta vistas diferentes para diferentes representações dos dados dos contactos. Para além disso, oferece uma procura incremental por todos os campos e uma barra de posicionamento para o acesso rápido a itens individuais. Dado que a biblioteca subjacente usa o formato vCard (definido no RFC 2426) como meio de armazenamento por omissão, o &kaddressbook; reflecte principalmente os campos suportados por este formato na sua interface gráfica para o utilizador.

## Utilização do &kaddressbook;

### Começar

Depois de ter iniciado o &kaddressbook; (usando o menu do painel ou escrevendo `kaddressbook` na linha de comandos), a janela principal do &kaddressbook; irá aparecer:

Iniciar o &kaddressbook; A janela principal do &kaddressbook;.

A janela principal do &kaddressbook;.

### Configurar Recursos

O &kaddressbook; poderá usar vários recursos para ler e guardar os seus contactos. Depois de iniciar o &kaddressbook; da primeira vez, é-lhe instalado um recurso por omissão, o qual grava todos os contactos num ficheiro vCard em $HOME/.kde/share/apps/kabc/std.vcf. Mas você poderá adicionar mais recursos, usando a Janela de Configuração dos Recursos, a qual está disponível no kcontrol, nos Componentes do KDE->Configuração de Recursos do KDE:

A Janela de Configuração de Recursos A Janela de Configuração de Recursos.

A Janela de Configuração dos Recursos.

Carrega o módulo de configuração a que você deseja adicionar os seus recursos, seleccionando-o na lista no topo da secção de Recursos. O módulo para o &kaddressbook; é o contact.

Lance a janela de Configuração do Recurso, carregando no botão Adicionar.... Escolha o recurso que deseja adicionar ao seu módulo contact e carregue em OK para confirmar a sua escolha.

Pasta

- cada contacto é guardado num ficheiro distinto;

Ficheiro

- todos os contactos são guardados num ficheiro;

IMAP

- A ser escrito

Kolab

- Os contactos serão gravados na pasta de contactos da sua conta de DIMAP.

  Especificidades do servidor de Kolab: O recurso do Kolab nunca deverá ser configurado como Apenas para Leitura. No caso de ter adicionado vários tipos de recursos, terá de definir o seu recurso de Servidor de Kolab como recurso Normal.

LDAP

- todos os contactos são guardados num servidor LDAP;

Rede

- todos os contactos serão gravados num ficheiro, o qual poderá estar localizado num servidor remoto (⪚, através de HTTP, WebDAV, FTP ou Fish).

SLOX

- A ser escrito

XML-RPC

- A ser escrito

Depois de seleccionar o tipo, aparecerá outra janela, onde você poderá configurar as opções específicas do recurso.

Os recursos Ficheiro e Directoria suportam formatos diferentes para guardar os contactos:

vCard

- os contactos serão guardados no formato vCard, tal como está descrito no RFC 2426;

binário

- os contactos serão gravados num formato binário — isto aumenta a performance durante a leitura e a gravação, mas não é portável como o formato vCard.

O &kaddressbook; necessita de um recurso por omissão, onde todos os contactos deverão ser guardados se não for especificado nenhum outro recurso. Por esta razão, depois de iniciar o &kaddressbook; da primeira vez, existe já um recurso disponível. Se você quiser usar outro recurso como recurso por omissão, use a opção Usar como Padrão para o seleccionar. O novo recurso por omissão deverá ter permissões para leitura e escrita e deverá estar activo, caso contrário não o poderá seleccionar.

### Gerir Contactos

Para criar ou editar os contactos, o &kaddressbook; oferece uma janela onde você poderá introduzir todos os dados que também se encontram disponíveis num vCard.

A Janela de Contacto A Janela de Contacto.

A Janela de Contacto.

#### Processamento Automático de Nomes

O &kaddressbook; tenta proporcionar uma fácil introdução dos nomes ao analisar automaticamente os nomes. Para funcionar convenientemente, é necessário às vezes adicionar alguns prefixos personalizados, sufixos ou inclusões na janela de configuração. Todavia não há nenhum algoritmo perfeito, como tal poderá acontecer que processe mal o seu nome. Neste caso, você poderá desactivar a análise automática do nome na janela de edição do nome, a qual está disponível se carregar em Nome... na janela de contactos. Se quiser desactivar a análise para todos os contactos novos, desactive a análise automática globalmente na janela de configuração.

#### Nome Formatado

O nome formatado de um contacto é usado pelos outros programas para o representar. O &kaddressbook; oferece três tipos predefinidos de nomes formatados:

Nome Simples

- <nome próprio> <apelido>;

Nome Completo

- <prefixo> <nome próprio> <nome adicional> <apelido> <sufixo>;

Nome Invertido

- <apelido>, <nome próprio>.

Se os tipos acima apresentados não corresponderem às suas necessidades, você poderá seleccionar o tipo de nome Personalizado, onde você poderá adicionar o seu próprio nome formatado — essa configuração poderá ser feita na janela de edição dos nomes. Para indicar um tipo de nome formatado para os contactos novos, use a janela de configuração.

#### Mensageiro Instantâneo

O campo de texto Endereço IM contém o Endereço do Mensageiro Instantâneo preferido para este contacto. Para adicionar, ver e editar os endereços de IM adicionais, carregue no botão Editar os Endereços IM.... A janela para Edição dos Endereços de IM irá aparecer.

A Janela de Edição dos Endereços de IM A janela para Editar os Endereços de IM.

A janela para Editar os Endereços de IM.

Um contacto poderá ter vários endereços de mensagens instantâneas associados a ele. As outras aplicações, como o Kopete e o Konversation, guardam as suas informações aqui. Recomenda-se que você adicione, edite e remova os endereços de mensagens instantâneas no Kopete ou no Konversation em vez de ser aqui, dado que eles podê-lo-ão ajudar melhor a adicionar o endereço, adicionar o utilizador a um grupo e assim por diante. Se não estiver interessado na forma como eles são extraídos noutra aplicação, e apenas quer guardar o endereço de mensagens instantâneas com o contacto, então será perfeito adicioná-lo e editá-lo aqui.

Para mais informações sobre como adicionar novos endereços de Mensageiros Instantâneos, veja no manual do Kopete ou no manual do Konversation.

#### Página de Configuração da Cifra

Nesta página, poderá definir as preferências que dizem respeito à cifra para um dado contacto. Na altura em que isto foi escrito, só o KMail irá tirar partido destas preferências, ao compor as mensagens. Este mecanismo substitui as preferências de cifra por destinatário das versões anteriores do KMail.

Protocolos Permitidos

- Aqui, poderá restringir os formatos de mensagens criptográficas que podem ser usados para este contacto. Veja a secção sobre os Formatos Criptográficos de Mensagens no manual do KMail para uma discussão dos diferentes formatos disponíveis.

Chave de cifra de OpenPGP preferida, Certificado de cifra de S/MIME preferido

- Aqui, poderá agtribuir uma chave de OpenPGP e/ou certificado de S/MIME para usar ao cifrar para este contacto. Caso contrário, a procura de chaves ou certificados correspondentes será feita no chaveiro local ou no chaveiro de certificados local.

Preferências de Mensagem

- Aqui, poderá seleccionar um conjunto de directivas para uma interacção do utilizador, tanto na assinatura como na cifra.

  <nenhum>

- Sem preferências, use o modo que o KMail tiver por omissão.

Nunca Assinar, Nunca Cifrar

- Nunca assina (ou cifra) as mensagens para este contacto. Não pede qualquer confirmação (excepto no caso de conflitos com as preferências de outros contactos).

Assinar Sempre, Cifrar Sempre

- Assina (ou cifra) sempre as mensagens para o contacto. Não pede qualquer confirmação (excepto no caso de conflitos com as preferências dos outros contactos).

Assinar Sempre Se Possível, Cifrar Sempre Se Possível

- Assina sempre (ou cifra) as mensagens para este contacto, quando for possível fazê-lo. Não pergunta nada se não for possível. As situações em que a assinatura poderá não ser possível será quando se incluem outros destinatários que têm preferências de assinatura iguais a "Nunca". As situações em que a cifra poderá não ser possível incluem a falta de chaves/certificados para estte destinatário ou qualquer um dos outros.

Perguntar

- Pergunta sempre se deve assinar (ou cifrar).

### Utilizar Vistas

Nesta versão, o &kaddressbook; oferece algumas vistas diferentes, que representam os contactos apresentados de diferentes formas:

Vista de Tabela

- Todos os contactos são listados numa tabela. Os mesmos poderão ser ordenados se carregar no cabeçalho da coluna da tabela. As colunas da tabela dependem dos campos, os quais foram seleccionados na janela de configuração da vista.

Vista por Ícones

- Os contactos são mostrados como ícones na janela. Se o contacto contiver uma fotografia ou um logótipo, esse será usado nesta vista, caso contrário é usado um ícone predefinido.

Vista de Cartões

- Todos os contactos são apresentados no formato de cartões. Os cartões contêm o nome formatado como título. O conteúdo do cartão depende de quais os campos que foram seleccionados na janela de configuração da vista.

A Janela de Configuração da Vista A Janela de Configuração da Vista.

A Janela de Configuração da Vista.

A página dos Campos Seleccionados oferece-lhe a possibilidade de seleccionar quais as partes de um contacto que deverão ser mostradas na vista. Na página do Filtro por Omissão você poderá configurar qual o filtro que deverá ser usado para a vista.

### Utilizar Filtros

Você poderá configurar os filtros no &kaddressbook;, os quais dependem das categorias a que um contacto pertence. Por exemplo, você poderá criar um filtro que corresponda a todos os contactos que pertençam às categorias de 'Família' ou 'Amigos'. Mas você poderá definir um filtro que corresponda a todos os contactos que não pertençam a essas categorias. Para gerir os filtros, use a janela de configuração dos filtros:

A Janela de Configuração dos Filtros A Janela de Configuração dos Filtros.

A Janela de Configuração dos Filtros.

Os filtros podem ser usados nas vistas para reduzir o número de contactos representados. Na janela de configuração da vista você poderá indicar qual o filtro que deverá ser usado por omissão por parte de uma vista.

### Utilizar Extensões

As extensões estão implementadas como 'plugins' no &kaddressbook;, como tal os programadores exteriores ao projecto poderão criar mais extensões. De momento, já existem três:

Editor de Contactos

- Semelhante à janela de edição de contactos, mas pensado para permitir a edição rápida de contactos.

Localização do Contacto

- Esta extensão utiliza o endereço postal de um contacto e carrega um serviço de mapas da Internet (como o www.map24.de) com esses dados. O resultado é mostrado numa página de HTML.

Gestor de Listas de Distribuição

- Esta extensão oferece uma gestão simples das listas de distribuição: basta criar uma nova lista e seleccionar um contacto na janela. Depois de carregar em Adicionar o contacto, o contacto seleccionado passa a fazer parte da lista de distribuição. Existe uma forma mais simples, que consiste em arrastar um contacto da janela e largá-lo no gestor de listas de distribuição. Veja o Menu de Configuração para saber como adicionar uma extensão.

A janela principal com a extensão de listas de distribuição. A janela principal com a extensão de listas de distribuição.

A janela principal com a extensão de listas de distribuição.

### Importar e Exportar

Com a nova plataforma de importação e exportação, o &kaddressbook; oferece uma janela onde você poderá seleccionar quais os contactos que deverão ser exportados.

A janela de exportação de contactos. A janela de exportação de contactos.

A janela de exportação de contactos.

Os seguintes filtros de importação e exportação estão disponíveis de momento:

vCard

- o formato vCard é um formato normalizado (RFC 2426) que é suportado pela maioria das aplicações de livros de endereços; o &kaddressbook; consegue importar e exportar a versão 2.1 e a 3.0;

Telemóvel

- este 'plugin' consegue importar os contactos dos telemóveis Nokia através da biblioteca 'gnokii';

Livro de Endereços do Eudora

- com este 'plugin' você consegue importar os seus contactos do cliente de e-mail Eudora;

CSV

- o CSV ('comma separated values' - valores separados por vírgulas) é um formato que é usado por muitas aplicações de livros de endereços — você consegue importar e exportar os seus contactos neste formato;

KDE2

- para importar os seus dados antigos do livro de endereços do KDE 2.X você poderá usar este item;

LDIF

- o LDIF é uma representação em texto simples dos dados do LDAP. O Netscape e o Mozilla usam este formato para guardar os seus dados de livro de endereços — o &kaddressbook; suporta a importação e a exportação deste formato;

PAB

- o PAB é o formato do Personal Address Book (Livro de Endereços Pessoal) do MS Exchange. O MS Outlook e o MS Outlook Express usam-no para guardar os seus dados de contactos — o &kaddressbook; suporta a importação deste formato;

Opera

- use este 'plugin' para importar a base de dados de contacto do navegador Web Opera;

Favoritos

- este é um pseudo-'plugin' de exportação, que torna os URLs Web dos seus contactos disponíveis no menu de Favoritos do Konqueror.

### Pesquisas LDAP

O &kaddressbook; pode ser usado para importar as informações dos endereços a partir dos servidores de LDAP para o livro de endereços no livro de endereços local, usando a janela de pesquisa na LDAP.

Para configurar (um conjunto) de servidores de LDAP, use a janela de configuração.

Na barra de ferramentas principal do &kaddressbook;, está disponível um botão com a imagem de uma lupa num livro. Use este botão para abrir a janela de pesquisa na LDAP. A janela em si é bastante simples. Basta escrever uma parte do nome, endereço de e-mail ou do número de telefone e carregue no botão de Procurar.

Quando aparecerem os resultados na lista, é possível seleccionar um ou mais endereços e usar o Adicionar os Seleccionados para importar os mesmos endereços para o livro de endereços local ou carregue no Enviar para os Seleccionados, de modo a invocar o programa de correio e escrever um e-mail para os destinatários seleccionados.

A opção Pesquisa recursiva está activo por omissão. Isto fará com que a pesquisa na LDAP considere todos os objectos por baixo da DN de base de cada servidor. Se só quiser considerar os objectos que estejam um nível abaixo da base, desligue esta opção. Se tiver dúvidas, deixe-a seleccionada.

### Preferências

Você poderá alterar vários aspectos do comportamento do &kaddressbook; na janela de preferências; a janela poderá ser acedida através de Configuração Configurar o KAddressBook ou no ícone da barra de ferramentas.

Configurar o &kaddressbook; A janela de preferências.

A janela de preferências.

#### A Página do Livro de Endereços

##### A Página Geral

Utilizar o carregar uma vez do KDE

- Se estiver assinalada esta opção, o &kaddressbook; irá prestar atenção à opção do carregar uma vez do KDE.

Análise Automática do Nome para os endereços novos

- Se estiver assinalada, a funcionalidade de análise automática do nome é usada para os endereços novos.

Analisadores dos 'Scripts'

- Aqui poderá indicar os comandos que deverão ser executados quando você carregar num número de telefone ou número de fax na página dos detalhes.

Extensões

- Nesta lista você poderá activar e desactivar as extensões simples e configurar as suas opções.

##### A Página Contacto

O &kaddressbook; poderá analisar automaticamente um nome nas suas componentes. Para ter a certeza que isto funciona em muitos casos, você poderá adicionar aqui as componentes adicionais do nome, como os prefixos, os sufixos e as inclusões.

Prefixos

- Aqui pode gerir os prefixos como 'Prof.' ou 'Dr.'.

Inclusões

- Aqui você poderá gerir as inclusões dos nomes como o 'do', 'da', 'de', os quais fazem parte normalmente dos nomes portugueses.

Sufixos

- Aqui você poderá gerir os sufixos dos nomes como 'Sénior' ou 'Jr.'.

Nome Formatado por Omissão

- Aqui você poderá escolher o tipo predefinido de formatação para os nomes que deverá ser usado para os contactos novos.

#### A Página Pesquisa LDAP

Nesta página você poderá configurar os servidores de LDAP que deverão ser usados para as pesquisas de LDAP do &kaddressbook;.

Use o Adicionar uma Máquina... para adicionar e configurar um novo servidor.

Configurar a Pesquisa por LDAP para o Kolab Exemplo da Configuração da Pesquisa por LDAP (Kolab).

A janela para Adicionar uma Máquina - Exemplo da configuração da Pesquisa por LDAP (Kolab).

Pode incluir e excluir os servidores conforme seleccione ou não a sua opção na lista dos servidores. Carregue em OK para fechar a janela.

Você poderá configurar a ordem de procura se subir ou descer os servidores na lista. Isto poderá ser feito se usar as setas correspondentes do lado direito da janela.

## Referência de Comandos

### O Menu Ficheiro

&Ctrl;N Ficheiro Novo Contacto

- Abre o editor de contactos para adicionar um novo contacto.

Ficheiro Editar o Contacto

- Abre o editor de contactos para editar o contacto seleccionado de momento.

&Ctrl;S Ficheiro Gravar

- Grava os contactos alterados.

Ficheiro Importar

- Enumera todos os módulos de importação disponíveis.

Ficheiro Exportar

- Enumera todos os módulos de exportação disponíveis.

&Ctrl;P Ficheiro Imprimir

- Imprime os contactos seleccionados no momento.

Ficheiro Enviar E-mail para o Contacto

- Abre o programa de e-mail preferido com os contactos seleccionados no momento como destinatários.

Ficheiro Enviar o Contacto

- Abre o programa de e-mail preferido com os contactos seleccionados no momento como vCards em anexo.

&Ctrl;Q Ficheiro Sair

- Sai do &kaddressbook;.

### O Menu Editar

&Ctrl;Z Editar Desfazer

- Anula a última alteração.

&Ctrl;&Shift;Z Editar Refazer

- Repete a última acção anulada.

&Ctrl;X Editar Cortar

- Corta os contactos seleccionados no momento e coloca-os na área de transferência.

&Ctrl;C Editar Copiar

- Copia os contactos seleccionados no momento para a área de transferência.

&Ctrl;V Editar Colar

- Cola o conteúdo da área de transferência no livro de endereços (se estiver num formato válido).

Delete Editar Remover o Contacto

- Apaga os contactos seleccionados no momento.

&Ctrl;A Editar Seleccionar Tudo

- Selecciona todos os contactos.

Editar Definir as Categorias

- Abre uma janela onde você poderá definir as categorias para todos os contactos seleccionados no momento. Quando as categorias seleccionadas forem diferentes das dos contactos, a janela perguntar-lhe-á se deseja juntar essas diferenças ou se as categorias deverão sim ser substituídas.

Editar Definir Quem Sou Eu

- Marca o contacto seleccionado no momento como o contacto 'Quem Sou Eu', o qual representa os dados do utilizador. Você deverá ter um desses contactos, porque as outras aplicações como o &kmail; e o &kword; poderão tirar partido desses dados. Por isso, você não terá de os introduzir em separado para cada aplicação.

### O Menu Ver

Ver Seleccionar a Vista

- Enumera todas as vistas disponíveis.

Ver Adicionar uma Vista

- Abre uma janela para criar uma nova vista .

Ver Modificar a Vista...

- Abre uma janela onde você poderá modificar a configuração da vista actual .

Ver Remover a Vista

- Remove a vista actual.

Ver Actualizar a Vista

- Actualiza o conteúdo actual da vista.

### O Menu Ferramentas

Este menu contem as ferramentas para actuar na base de dados dos contactos.

Ferramentas Procurar Endereços no Directório

- Abre a janela de pesquisa para os endereços localizados nos servidores de LDAP. Você poderá configurar o servidor na janela de configuração.

### O Menu Configuração

Este menu contém as opções para configurar o &kaddressbook;, alterando a sua aparência, os seus atalhos e o seu comportamento por omissão.

Configuração Barras de Ferramentas

- Comuta (activa ou desactiva) as barras de ferramentas.

Configuração Mostrar a Barra de Extensão

- Selecciona a extensão que deverá ser mostrada na barra de extensão no fundo da janela principal.

configuração Mostrar a Barra de Salto

- Comuta (activa ou desactiva) a Barra de Salto.

Configuração Mostrar os Detalhes

- Comuta (activa ou desactiva) a Página dos Detalhes.

Configuração Editar o Filtro

- Abre uma janela onde você poderá editar os filtros.

Configuração Configurar os Atalhos...

- Abre uma janela para alterar a configuração das teclas. Ao usar esta opção você poderá alterar os atalhos-padrão de teclas para os comandos do &kaddressbook; ou criar novos.

Configuração Configurar as Barras de Ferramentas...

- Abre uma janela para configurar a barra de ferramentas. Você poderá adicionar e remover os botões da barra de ferramentas para os comandos do &kaddressbook; com esta opção.

Configuração Configurar o KAddressBook...

- Abre a janela de preferências.

### O Menu Ajuda

&help.menu.documentation;

## Opções da Linha de Comandos

O &kaddressbook; suporta alguns argumentos na linha de comandos, os quais poderão ser usados para influenciar o comportamento inicial:

`kaddressbook` `-a, --addr <e-mail>`

- Mostra o editor de contactos com o endereço de e-mail indicado.

`kaddressbook` `--uid <uid>`

- Mostra o editor de contactos com o UID indicado.

`kaddressbook` `--editor-only`

- Lança apenas no modo de edição.

`kaddressbook` `--new-contact`

- Lança o editor para um contacto novo.

O &kaddressbook; também suporta as outras opções da linha de comandos comuns aos programas do &kde; e do &Qt;. Você poderá obter uma lista com estas opções usando o ``--help``, o ``--help-kde`` e o ``--help-qt``.

## Créditos e Licença

&kaddressbook; - Livro de Endereços do &kde;

Copyright (c) 1997-2003, A Equipa KDE-PIM

O &kaddressbook; foi criado originalmente em 1997 pelo Don Sanders dsanders@kde.org. Neste momento é mantido pelo Tobias Koenig tokoe@kde.org.

&underFDL;