diff --git a/index.docbook b/index.docbook new file mode 100644 --- /dev/null +++ b/index.docbook @@ -0,0 +1,457 @@ + + + + ]> + + + + + + + + + David + C. + Bryant +
davidbryant@gvtc.com
 + + + + + + + + 2019 + David C. Bryant + + +&CCBYSA4Notice; + +2019-07-20 +5.7.3 (Applications 17.12.3) + + + &kaddressbook; is part of the &kde; suite of personal information management + (&PIM;) programs. &kaddressbook; is primarily an email address manager, but it can + also help you keep track of your friends' and associates' telephone numbers, web + sites, social media connections, snail-mail addresses, and more, besides. It's your + one-stop shop for keeping track of all the people you know. + + + + + + KDE + KAddressBook + kdepim + Email + + + + + +Introduction + + + &kaddressbook; is part of the &kde; suite of personal information management   + (&PIM;) programs. &kaddressbook; is primarily an email address + manager, but it can also help you keep track of your friends' and associates' + telephone numbers, web sites, social media connections, snail-mail addresses, and + more, besides. It's your one-stop shop for keeping track of all the people + you know! + + + + A screenshot of &kaddressbook;'s primary &GUI; interface + + + + + + A screenshot of &kaddressbook;'s primary &GUI; interface + + + A screenshot of &kaddressbook;'s primary display. The Menu Bar is at + the top, the Tool Bar is next, and there are three Data Panes at the bottom. + + + + +   + + + &kaddressbook; has been integrated into the structure of  &kmail;, the &kde; email + client. So once you add a contact's name to &kaddressbook;, you can address + an email message to that person by just typing in a portion of his name. Or if + you receive an email message from somebody new, you can add him to your address + book with just two clicks of your mouse. + + + + &kaddressbook; also permits you to maintain multiple separate contact lists in a + wide variety of popular address list formats, either on your local hard disk, or + via a resource residing in the cloud. It also supports importing and exporting + contact data in .csv (Comma Separated Values), + .ldif (LDAP Data Interchange Format), and + .vcf (Virtual business Card Format) record formats. + + + + + + +Getting Started + + + Here is a picture of the primary  &kaddressbook; user interface before any address + data have been entered. As you can see, only the main menu items are active. All + the standard toolbar buttons are grayed out. The first thing you need to do is + create an address book. + + + + A screenshot of &kaddressbook;'s empty &GUI; interface + + + + + + A screenshot of &kaddressbook;'s empty &GUI; interface + + + A screenshot of  &kaddressbook;'s empty &GUI; interface, + before any address books have been created. + + + + +   + + + Adding a New Address Book + + + Open &kaddressbook;'s Add Address Book dialog with the  File + NewAdd Address Book... + option. A dialog box will appear. + + + + + A screenshot of &kaddressbook;'s Add Address Book dialog + + + + + + A screenshot of &kaddressbook;'s Add Address Book dialog + + + A screenshot of  &kaddressbook;'s Add Address Book dialog. + Five cloud services are supported, plus three local storage options. Do + not try to use   Knut. + + + + +   + + + + Choose one of the options that appear in the dialog. Several of these options + link to data collections residing in the cloud: DAV groupware (Distributed + Authoring and Versioning, RFC4918), Google Contacts (your gmail.com account), + Kolab groupware server (collaboration via &IMAP;), &Microsoft; Exchange Server EWS + (Exchange Web Services, on servers running MS software), and Open-Xchange Groupware + Server (an open-source alternative to MS EWS). If you already have access to one + or more of these cloud-based resources, you can integrate those data into  &kaddressbook; + by simply selecting the option and then entering your login credentials. + + + + The remaining options in the dialog (Personal Contacts, vCard Directory, and + vCard File) all create data sets that are saved on a local storage device. Each + one of these options uses the same data format ( + .vcf, or Virtual Card Format), + the only difference being in which particular directory the data are saved. The + Personal Contacts and vCard Directory options create a separate + file for each named contact you save; the vCard File option puts all the data + into one file. It's probably easiest to start with the Personal Contacts address + book. You will not need more address books unless you have extensive contact + lists you want to keep separate. + + + + Once you have made your selection, click on OK. If you have selected a cloud-based + service, a brief dialog will ensue, to establish communications between   &akonadi; + (the &PIM; cross-desktop storage service) and the selected cloud server. Here's what + the dialog looks like for a Google (gmail.com) account. The other cloud-based services + are slightly different, but similar. + + + + + A screenshot of &kaddressbook;'s link-to-gmail dialog + + + + + + A screenshot of &kaddressbook;'s link-to-gmail dialog + + + A screenshot of &kaddressbook;'s link-to-gmail dialog. + Begin by clicking Add. A new dialog will appear. Once your credentials + have been accepted, this screen will reappear, and you wll click   ✔ OK . + If you would like &kaddressbook; to refresh the locally cached copy of your contact list + automatically, do it here, before you click   ✔ OK . + + + + + + + + A second screenshot of &kaddressbook;'s link-to-gmail dialog + + + + + + A second screenshot of &kaddressbook;'s link-to-gmail dialog + + + Another screenshot of &kaddressbook;'s link-to-gmail dialog. Enter your + gmail.com address and click  Next . You will be asked to + enter your gmail password. + + + + + + + + A third screenshot of &kaddressbook;'s link-to-gmail dialog + + + + + + A third screenshot of &kaddressbook;'s link-to-gmail dialog + + + Yet another screenshot of &kaddressbook;'s link-to-gmail dialog. + Your account name and password have been accepted by Google's server. Read + the privacy notice and press   Allow , then +  ✔ OK  in the  Add  dialog + with which you started. + + + + + +   + + + Enter your login credentials as illustrated above and say OK. Voila! Your cloud-based + contact list is now integrated into  &kaddressbook;. + + + + + The &kaddressbook; window after a gmail.com account has been added. + + + + + + The &kaddressbook; window after a gmail.com account has been added. + + + Another screenshot of the &kaddressbook; window, after a gmail.com + account has been added. You can now manipulate your gmail contacts via + &kaddressbook;, if you like. + + + + + +   + + + As the preceding screenshot indicates, once you have registered  &kaddressbook; as a + trusted resource, you can view and edit your gmail contacts using  &kaddressbook;. Of + course, you may also continue to maintain your contacts by using a web browser, if you wish. + + +   + + + + + If you selected one of the local address book options in   + step 2 above, a different + dialog will ensue. + + + + A screenshot of &kaddressbook;'s Personal Contacts dialog. + + + + + + A screenshot of &kaddressbook;'s Personal Contacts dialog. + + + A screenshot of &kaddressbook;'s Personal Contacts dialog. + You may specify which directory will contain your data, and whether you have write access to + this resource, or not. For most people, the default selections (as shown above) work well. + + + + + +   + + + Make any modifications you deem necessary in the Personal Contacts dialog, + then click  ✔ OK . A new address book will appear in the main + &kaddressbook; interface window, as shown below. + + + + + A screenshot of &kaddressbook;'s main window with an empty Personal Contacts address book. + + + + + + A screenshot of &kaddressbook;'s main window with an empty Personal Contacts address book. + + + A screenshot of &kaddressbook;'s main window after the Personal Contacts address book has been created. + + + + + +   + + + + + + + + Adding a New Contact + + + Open &kaddressbook;'s New Contact dialog by clicking the  + New Contact  + button on the menu bar. A dialog box will appear. + + + + A screenshot of &kaddressbook;'s New Contact dialog. + + + + + + A screenshot of &kaddressbook;'s New Contact dialog. + + + A screenshot of &kaddressbook;'s New Contact dialog after clicking the +  + New Contact  button on the menu bar. + + + + + +   + + + + + As you can see from the preceding screenshot, the New Contact dialog allows one + to enter several different data items. Additional data may be entered via the Location, + Business, Personal, Notes, Custom Fields, + and Crypto Settings sub-dialogs, as explained more fully in + chapter x, below. For now, let's concentrate on adding + the Contact data items appearing in the preceding illustration. + + + + If you have created more than one address book, use the drop-down list labeled  Add to: + to select the data set to which the new contact will be added. Then enter the new contact's name in + the input field marked Name, and key in his or her email address in the input field + labeled  Email. If you want to specify special formatting options for this contact's + name data, click the  ...  button to the right of the Name + input field and follow the prompts. If you wish to add more email addresses for this person, click the   +  +  button to the right of the Email input field and another + Email input field will be generated. To delete an Email address, click the associated   +  −  button. + + + + + You may also associate a nickname, one or more telephone numbers, multiple instant messaging services, + and several web sites with each contact in an address book, as explained in   + chapter x. You may also use the Show messages ... + and Allow remote content ... options to fine-tune the way &kmail; handles email you receive + from each contact. See  chapter y for a more + complete explanation. + + + + + + + +Integration With Other &kde; Programs + + + + + + + +Editing Contact Data + + + + +Credits and Licenses + + +&kaddressbook; + + + + Program copyright ??? John Q. Hacker jqh@kde.org + + + + Contributors: + + Konqui the &kde; Dragon konqui@kde.org + Tux the &Linux; Penguin tux@linux.org + + + + + Documentation Copyright © 2019 David C. Bryant davidbryant@gvtc.com + + + + + + + &underCCBYSA4; + + + +