# O Manual do &kaddressbook;

Tobias Koenig

    tokoe@kde.org

Steffen Hansen

    hansen@kde.org

Don Sanders

    dsanders@kde.org

Pedro Morais

    morais@kde.org

Tradução
2003-03-03
0.03.00
&FDLNotice;

O &kaddressbook; é o livro de endereços do &kde;.

KDE 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->Livro de Endereços:

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

A Janela de Configuração dos Recursos.

Quando você carregar no botão Adicionar..., irá aparecer uma janela onde você poderá escolher o tipo do recurso. De momento, existem quatro tipos disponíveis:

ficheiro

  todos os contactos são guardados num ficheiro;

dir

  cada contacto é guardado num ficheiro distinto;

ldap

  todos os contactos são guardados num servidor LDAP;

net

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

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.

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

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 value - 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 email 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 'click' simples do KDE

  Se estiver assinalada esta opção, o &kaddressbook; irá prestar atenção à opção do 'click' simples 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 'Senior' 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;.

Utilize o Adicionar uma Máquina... para adicionar e configurar um novo servidor. Você pode incluir e excluir os servidores se seleccionar ou deseleccionar a opção da lista dos servidores. Carregue em OK para fechar a 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 <email>`

  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;