Changeset View
Changeset View
Standalone View
Standalone View
doc/index.docbook
- This file was added.
1 | <?xml version="1.0" ?> | ||||
---|---|---|---|---|---|
2 | <!DOCTYPE book PUBLIC "-//KDE//DTD DocBook XML V4.5-Based Variant V1.1//EN" "dtd/kdedbx45.dtd" | ||||
3 | [ | ||||
4 | <!ENTITY % addindex "IGNORE"> | ||||
5 | <!ENTITY % English "INCLUDE"> | ||||
6 | <!ENTITY docbook-reference SYSTEM "docbook-reference.docbook"> | ||||
7 | ]> | ||||
8 | | ||||
9 | <book id="kaddressbook" lang="&language;"> | ||||
10 | | ||||
11 | <bookinfo> | ||||
12 | | ||||
13 | <title>The &kaddressbook; Handbook</title> | ||||
14 | | ||||
15 | <authorgroup> | ||||
16 | | ||||
17 | <author> | ||||
18 | <firstname>David</firstname> | ||||
19 | <othername>C.</othername> | ||||
20 | <surname>Bryant</surname> | ||||
21 | <affiliation><address><email>davidbryant@gvtc.com</email></address></affiliation> | ||||
22 | </author> | ||||
23 | | ||||
24 | <!-- TRANS:ROLES_OF_TRANSLATORS --> | ||||
25 | | ||||
26 | </authorgroup> | ||||
27 | | ||||
28 | <copyright> | ||||
29 | <year>2019</year> | ||||
30 | <holder>David C. Bryant</holder> | ||||
31 | </copyright> | ||||
32 | | ||||
33 | <legalnotice>&CCBYSA4Notice;</legalnotice> | ||||
34 | | ||||
35 | <date>2019-07-20</date> | ||||
36 | <releaseinfo>5.10.3 (Applications 18.12.3)</releaseinfo> | ||||
37 | | ||||
38 | <abstract> | ||||
39 | <para>&kaddressbook; is part of the &kde; suite of personal information management | ||||
40 | (<glossterm linkend="gloss-pim">&PIM;</glossterm>) programs. &kaddressbook; is | ||||
41 | primarily an email address manager, but it can also help you keep track of your friends' | ||||
42 | and associates' telephone numbers, web sites, social media connections, snail-mail | ||||
43 | addresses, and more, besides. It's your one-stop shop for keeping track of all the people you know. | ||||
44 | </para> | ||||
45 | </abstract> | ||||
46 | | ||||
47 | <!--TODO Note to self: add more keywords later. --> | ||||
48 | <keywordset> | ||||
49 | <keyword>KDE</keyword> | ||||
50 | <keyword>KAddressBook</keyword> | ||||
51 | <keyword>kdepim</keyword> | ||||
52 | <keyword>Email</keyword> | ||||
53 | </keywordset> | ||||
54 | | ||||
55 | </bookinfo> | ||||
56 | | ||||
57 | <chapter id="introduction"> | ||||
58 | <title>Introduction</title> | ||||
59 | | ||||
60 | <para> | ||||
61 | &kaddressbook; is part of the &kde; suite of personal information management (&PIM;) | ||||
62 | programs. &kaddressbook; is primarily an email address manager, but it can also help | ||||
63 | you keep track of your friends' and associates' telephone numbers, web sites, social | ||||
64 | media connections, snail-mail addresses, and more, besides. It's your one-stop shop | ||||
65 | for keeping track of all the people you know! | ||||
66 | </para> | ||||
67 | | ||||
68 | <screenshot id="screenshot-primary"> | ||||
69 | <screeninfo>A screenshot of &kaddressbook;'s primary &GUI; interface</screeninfo> | ||||
70 | <mediaobject> | ||||
71 | <imageobject> | ||||
72 | <imagedata fileref="addressbook00.png" format="PNG"/> | ||||
73 | </imageobject> | ||||
74 | <textobject> | ||||
75 | <phrase>A screenshot of &kaddressbook;'s primary &GUI; interface</phrase> | ||||
76 | </textobject> | ||||
77 | <caption> | ||||
78 | <para>&kaddressbook;'s primary display. The Menubar is at the top, the Toolbar | ||||
79 | is next, and there are three Panels for data in the Text Area | ||||
80 | at the bottom.</para> | ||||
81 | </caption> | ||||
82 | </mediaobject> | ||||
83 | </screenshot> | ||||
84 | | ||||
85 | <para> </para> <!-- add more white space after screenshot @dcb --> | ||||
86 | | ||||
87 | <para> | ||||
88 | &kaddressbook; has been integrated into the structure of <glossterm linkend="gloss-kmail">&kmail;</glossterm>, | ||||
89 | the &kde; email client. So once you add a contact's name to &kaddressbook;, you can address | ||||
90 | an email message to that person by just typing in a portion of his name. Or if | ||||
91 | you receive an email message from somebody new, you can add him to your address | ||||
92 | book with just a few clicks of your mouse. | ||||
93 | </para> | ||||
94 | | ||||
95 | <para> | ||||
96 | &kaddressbook; also permits you to maintain multiple separate contact lists in a | ||||
97 | wide variety of popular address list formats, either on your local hard disk, or | ||||
98 | via a resource residing in the cloud. It also supports importing and exporting | ||||
99 | contact data in <glossterm linkend="gloss-csv"><filename class="extension">.csv</filename></glossterm> | ||||
100 | (Comma Separated Values), <glossterm linkend="gloss-ldif"><filename class="extension">.ldif</filename></glossterm> | ||||
101 | (<glossterm linkend="gloss-ldap"><acronym>LDAP</acronym></glossterm> Data Interchange Format), and | ||||
102 | <glossterm linkend="gloss-vcf"><filename class="extension">.vcf</filename></glossterm> | ||||
103 | (Virtual business Card Format) record formats. | ||||
104 | </para> | ||||
105 | | ||||
106 | <!--TODO Insert additional information about problem reporting here --> | ||||
107 | </chapter> | ||||
108 | | ||||
109 | <chapter id="getting-started"> | ||||
110 | <title>Getting Started</title> | ||||
111 | | ||||
112 | <para> | ||||
113 | Here is a picture of the primary &kaddressbook; user interface before any address | ||||
114 | data have been entered. The first thing you may want to do is create an address | ||||
115 | book. Note that the<quote>Personal Contacts</quote> address book is present by default. | ||||
116 | </para> | ||||
117 | | ||||
118 | <screenshot id="screenshot-blank"> | ||||
119 | <screeninfo>A screenshot of &kaddressbook;'s <quote>empty</quote> &GUI; interface</screeninfo> | ||||
120 | <mediaobject> | ||||
121 | <imageobject> | ||||
122 | <imagedata fileref="addressbook10.png" format="PNG"/> | ||||
123 | </imageobject> | ||||
124 | <textobject> | ||||
125 | <phrase>A screenshot of &kaddressbook;'s <quote>empty</quote> &GUI; interface</phrase> | ||||
126 | </textobject> | ||||
127 | <caption> | ||||
128 | <para>&kaddressbook;'s <quote>empty</quote> &GUI; interface, before any extra address books | ||||
129 | have been created. The <quote>Personal Contacts</quote> address book is present when | ||||
130 | &kaddressbook; is first installed.</para> | ||||
131 | </caption> | ||||
132 | </mediaobject> | ||||
133 | </screenshot> | ||||
134 | | ||||
135 | <para> </para> <!-- add more white space after screenshot @dcb --> | ||||
136 | | ||||
137 | <sect1 id="how-to-add-a-new-address-book"> | ||||
138 | <title>How to Add a New Address Book</title> | ||||
139 | | ||||
140 | <procedure id="procedure-add-a-new-addressbook"> | ||||
141 | | ||||
142 | <step id="new-addressbook-dialog-step"><para> | ||||
143 | Open &kaddressbook;'s Add Address Book dialog with the <menuchoice><guimenu>File</guimenu> | ||||
144 | <guisubmenu>New ></guisubmenu><guimenuitem><inlinemediaobject><imageobject><imagedata fileref="folder-new.png" | ||||
145 | format="PNG"/></imageobject></inlinemediaobject>Add Address Book...</guimenuitem></menuchoice> | ||||
146 | option. A dialog box will appear. | ||||
147 | </para> | ||||
148 | | ||||
149 | <para> | ||||
150 | <screenshot id="screenshot-add-an-address-book"> | ||||
151 | <screeninfo>A screenshot of &kaddressbook;'s Add Address Book dialog</screeninfo> | ||||
152 | <mediaobject> | ||||
153 | <imageobject> | ||||
154 | <imagedata fileref="addressbook20.png" format="PNG"/> | ||||
155 | </imageobject> | ||||
156 | <textobject> | ||||
157 | <phrase>A screenshot of &kaddressbook;'s Add Address Book dialog</phrase> | ||||
158 | </textobject> | ||||
159 | <caption> | ||||
160 | <para>&kaddressbook;'s Add Address Book dialog. | ||||
161 | Five cloud services are supported, plus three local storage options.</para> | ||||
162 | </caption> | ||||
163 | </mediaobject> | ||||
164 | </screenshot> | ||||
165 | </para> | ||||
166 | <para> </para> <!-- add more white space after screenshot @dcb --> | ||||
167 | </step> | ||||
168 | | ||||
169 | <step id="select-a-format-step"><para> | ||||
170 | Choose one of the options that appear in the dialog. Several of these options | ||||
171 | link to data collections residing in the cloud: <glossterm linkend="gloss-dav"><acronym>DAV</acronym></glossterm> | ||||
172 | groupware (Distributed Authoring and Versioning, RFC4918), Google Contacts (your gmail.com | ||||
173 | account), <glossterm linkend="gloss-kolab">Kolab</glossterm> groupware server (collaboration | ||||
174 | via <glossterm linkend="gloss-imap">&IMAP;</glossterm>), &Microsoft; Exchange Server | ||||
175 | <glossterm linkend="gloss-ews">EWS</glossterm> (Exchange Web Services, on servers running MS software), | ||||
176 | and <glossterm linkend="gloss-group">Open-Xchange Groupware Server</glossterm> (an open-source | ||||
177 | alternative to MS EWS). If you already have access to one or more of these cloud-based resources, you can integrate those | ||||
178 | data into &kaddressbook; by simply selecting the option and then entering your login credentials.</para> | ||||
179 | | ||||
180 | <para> | ||||
181 | The remaining options in the dialog (Personal Contacts, vCard Directory, and | ||||
182 | vCard File) all create data sets that are saved on a local storage device. Each | ||||
183 | one of these options uses the same data format (<filename class="extension">.vcf</filename>, | ||||
184 | or Virtual Card Format), the only difference being in which particular directory the data | ||||
185 | are saved. The <quote>Personal Contacts</quote> and <quote>vCard Directory</quote> options | ||||
186 | create a separate file for each named contact you save; the <quote>vCard File</quote> option | ||||
187 | puts all the data into one file. It's probably easiest to start with the pre-defined | ||||
188 | <quote>Personal Contacts</quote> address book. You will not need more address books | ||||
189 | unless you have extensive contact lists you would like to keep separate. | ||||
190 | </para></step> | ||||
191 | | ||||
192 | <step id="add-a-cloud-based-service-step"><para> | ||||
193 | Once you have made your selection, click on OK. If you have selected a <glossterm | ||||
194 | linkend="gloss-cloud">cloud-based service</glossterm> a brief dialog will ensue, | ||||
195 | to establish communications between <glossterm linkend="gloss-akonadi">&akonadi;</glossterm> | ||||
196 | (the &PIM; cross-desktop storage service) and the selected cloud server. Here's what | ||||
197 | the dialog looks like for a Google (gmail.com) account. The other cloud-based services | ||||
198 | are slightly different, but similar. | ||||
199 | </para> | ||||
200 | | ||||
201 | <para> | ||||
202 | <screenshot id="screenshot-add-a-cloud-based-service"> | ||||
203 | <screeninfo>A screenshot of &kaddressbook;'s link-to-gmail dialog</screeninfo> | ||||
204 | <mediaobject> | ||||
205 | <imageobject> | ||||
206 | <imagedata fileref="addressbook30.png" format="PNG"/> | ||||
207 | </imageobject> | ||||
208 | <textobject> | ||||
209 | <phrase>A screenshot of &kaddressbook;'s link-to-gmail dialog</phrase> | ||||
210 | </textobject> | ||||
211 | <caption> | ||||
212 | <para>&kaddressbook;'s link-to-gmail dialog. Begin by clicking <quote>Add</quote>. A new dialog will appear. | ||||
213 | Once your credentials have been accepted, this screen will reappear, and you will click | ||||
214 | <guibutton> ✔ OK </guibutton>. If you would like &kaddressbook; to refresh the | ||||
215 | locally cached copy of your contact list automatically, do it here, before you click | ||||
216 | <guibutton> ✔ OK </guibutton>.</para> | ||||
217 | </caption> | ||||
218 | </mediaobject> | ||||
219 | </screenshot> | ||||
220 | </para> | ||||
221 | | ||||
222 | <para> | ||||
223 | <screenshot id="screenshot-add-a-cloud-based-service-step2"> | ||||
224 | <screeninfo>A second screenshot of &kaddressbook;'s link-to-gmail dialog</screeninfo> | ||||
225 | <mediaobject> | ||||
226 | <imageobject> | ||||
227 | <imagedata fileref="addressbook31.png" format="PNG"/> | ||||
228 | </imageobject> | ||||
229 | <textobject> | ||||
230 | <phrase>A second screenshot of &kaddressbook;'s link-to-gmail dialog</phrase> | ||||
231 | </textobject> | ||||
232 | <caption> | ||||
233 | <para>Another picture of &kaddressbook;'s link-to-gmail dialog. Enter your | ||||
234 | gmail.com address and click <guibutton> Next </guibutton>. You will be asked to | ||||
235 | enter your gmail password.</para> | ||||
236 | </caption> | ||||
237 | </mediaobject> | ||||
238 | </screenshot> | ||||
239 | </para> | ||||
240 | | ||||
241 | <para> | ||||
242 | <screenshot id="screenshot-add-a-cloud-based-service-step3"> | ||||
243 | <screeninfo>A third screenshot of &kaddressbook;'s link-to-gmail dialog</screeninfo> | ||||
244 | <mediaobject> | ||||
245 | <imageobject> | ||||
246 | <imagedata fileref="addressbook32.png" format="PNG"/> | ||||
247 | </imageobject> | ||||
248 | <textobject> | ||||
249 | <phrase>A third screenshot of &kaddressbook;'s link-to-gmail dialog</phrase> | ||||
250 | </textobject> | ||||
251 | <caption> | ||||
252 | <para>Yet another picture of &kaddressbook;'s link-to-gmail dialog. | ||||
253 | Your account name and password have been accepted by Google's server. Read | ||||
254 | the privacy notice and press <guibutton> Allow </guibutton>, then | ||||
255 | <guibutton> ✔ OK </guibutton> in the <quote> Add </quote> dialog | ||||
256 | with which you started.</para> | ||||
257 | </caption> | ||||
258 | </mediaobject> | ||||
259 | </screenshot> | ||||
260 | </para> | ||||
261 | | ||||
262 | <para> </para> <!-- add more white space after screenshot @dcb --> | ||||
263 | | ||||
264 | <para> | ||||
265 | Enter your login credentials as illustrated above and say OK. Voila! Your cloud-based | ||||
266 | contact list is now integrated into &kaddressbook;. | ||||
267 | </para> | ||||
268 | <para> </para> <!-- add more white space before next screenshot @dcb --> | ||||
269 | | ||||
270 | <para> | ||||
271 | <screenshot id="screenshot-add-a-cloud-based-service-completed"> | ||||
272 | <screeninfo>The &kaddressbook; window after a gmail.com account has been added.</screeninfo> | ||||
273 | <mediaobject> | ||||
274 | <imageobject> | ||||
275 | <imagedata fileref="addressbook33.png" format="PNG"/> | ||||
276 | </imageobject> | ||||
277 | <textobject> | ||||
278 | <phrase>The &kaddressbook; window after a gmail.com account has been added.</phrase> | ||||
279 | </textobject> | ||||
280 | <caption> | ||||
281 | <para>Another picture of the &kaddressbook; window, after a gmail.com | ||||
282 | account has been added. You can now manipulate your gmail contacts via &kaddressbook;, if you like.</para> | ||||
283 | </caption> | ||||
284 | </mediaobject> | ||||
285 | </screenshot> | ||||
286 | </para> | ||||
287 | | ||||
288 | <para> </para> <!-- add more white space after screenshot @dcb --> | ||||
289 | | ||||
290 | <para> | ||||
291 | As the preceding screenshot indicates, once you have registered &kaddressbook; as a | ||||
292 | trusted resource, you can view and edit your gmail contacts using &kaddressbook;. Of | ||||
293 | course, you may also continue to maintain your contacts by using a web browser, if you wish. | ||||
294 | </para> | ||||
295 | | ||||
296 | <para> </para> <!-- add more white space after screenshot @dcb --> | ||||
297 | | ||||
298 | </step> | ||||
299 | | ||||
300 | <step id="add-a-local-addressbook-step"><para> | ||||
301 | If you selected one of the local address book options in | ||||
302 | <link linkend="select-a-format-step">step 2</link> above, a different | ||||
303 | dialog will ensue. </para> | ||||
304 | | ||||
305 | <para> | ||||
306 | <screenshot id="screenshot-add-a-personal-addressbook"> | ||||
307 | <screeninfo>A screenshot of &kaddressbook;'s <quote>Personal Contacts</quote> dialog.</screeninfo> | ||||
308 | <mediaobject> | ||||
309 | <imageobject> | ||||
310 | <imagedata fileref="addressbook34.png" format="PNG"/> | ||||
311 | </imageobject> | ||||
312 | <textobject> | ||||
313 | <phrase>A screenshot of &kaddressbook;'s <quote>Personal Contacts</quote> dialog.</phrase> | ||||
314 | </textobject> | ||||
315 | <caption> | ||||
316 | <para>&kaddressbook;'s <quote>Personal Contacts</quote> dialog. You may specify which directory | ||||
317 | will contain your data, and whether you have write access to this resource, or not. For most people, | ||||
318 | the default selections (as shown above) work well.</para> | ||||
319 | </caption> | ||||
320 | </mediaobject> | ||||
321 | </screenshot> | ||||
322 | </para> | ||||
323 | | ||||
324 | <para> </para> <!-- add more white space after screenshot @dcb --> | ||||
325 | | ||||
326 | <para> | ||||
327 | Make any modifications you deem necessary in the <quote>Personal Contacts</quote> dialog, | ||||
328 | then click <guibutton> ✔ OK </guibutton>. A new address book will appear in the main | ||||
329 | &kaddressbook; interface window, as shown below. | ||||
330 | </para> | ||||
331 | | ||||
332 | <para> | ||||
333 | <screenshot id="screenshot-personal-addressbook-has-been-added"> | ||||
334 | <screeninfo>A screenshot of &kaddressbook;'s main window with an empty <quote>Personal Contacts</quote> address book.</screeninfo> | ||||
335 | <mediaobject> | ||||
336 | <imageobject> | ||||
337 | <imagedata fileref="addressbook35.png" format="PNG"/> | ||||
338 | </imageobject> | ||||
339 | <textobject> | ||||
340 | <phrase>A screenshot of &kaddressbook;'s main window with an empty <quote>Personal Contacts</quote> address book.</phrase> | ||||
341 | </textobject> | ||||
342 | <caption> | ||||
343 | <para>&kaddressbook;'s main window after the <quote>Personal Contacts</quote> address book has been re-created.</para> | ||||
344 | </caption> | ||||
345 | </mediaobject> | ||||
346 | </screenshot> | ||||
347 | </para> | ||||
348 | | ||||
349 | <para> </para> <!-- add more white space after screenshot @dcb --> | ||||
350 | </step> | ||||
351 | | ||||
352 | </procedure> | ||||
353 | </sect1> | ||||
354 | | ||||
355 | <sect1 id="how-to-add-a-new-contact"> | ||||
356 | <title>How to Add a New Contact</title> | ||||
357 | | ||||
358 | <procedure id="procedure-add-a-new-contact"> | ||||
359 | | ||||
360 | <step id="new-contact-dialog-step-1"><para> | ||||
361 | Open &kaddressbook;'s New Contact dialog by clicking the <guibutton> + New Contact </guibutton> | ||||
362 | button on the Toolbar. A dialog box will appear.</para> | ||||
363 | | ||||
364 | <para> | ||||
365 | <screenshot id="screenshot-new-contact-dialog"> | ||||
366 | <screeninfo>A screenshot of &kaddressbook;'s <quote>New Contact</quote> dialog.</screeninfo> | ||||
367 | <mediaobject> | ||||
368 | <imageobject> | ||||
369 | <imagedata fileref="addressbook40.png" format="PNG"/> | ||||
370 | </imageobject> | ||||
371 | <textobject> | ||||
372 | <phrase>A screenshot of &kaddressbook;'s <quote>New Contact</quote> dialog.</phrase> | ||||
373 | </textobject> | ||||
374 | <caption> | ||||
375 | <para>&kaddressbook;'s <quote>New Contact</quote> dialog after clicking the | ||||
376 | <guibutton> + New Contact </guibutton> button on the Toolbar.</para> | ||||
377 | </caption> | ||||
378 | </mediaobject> | ||||
379 | </screenshot> | ||||
380 | </para> | ||||
381 | | ||||
382 | <para> </para> <!-- add more white space after screenshot @dcb --> | ||||
383 | | ||||
384 | </step> | ||||
385 | | ||||
386 | <step id="procedure-new-contact-data-items"><para> | ||||
387 | As you can see from the preceding screenshot, the <quote>New Contact</quote> dialog allows one | ||||
388 | to enter several different data items. Additional data may be entered via the <quote>Location</quote>, | ||||
389 | <quote>Business</quote>, <quote>Personal</quote>, <quote>Notes</quote>, <quote>Custom Fields</quote>, | ||||
390 | and <quote>Crypto Settings</quote> sub-dialogs, as explained more fully in <link linkend="editing-contact-data">chapter 4</link>, | ||||
391 | below. For now, let's concentrate on adding the <quote>Contact</quote> data items appearing in the preceding illustration.</para> | ||||
392 | </step> | ||||
393 | | ||||
394 | <step id="procedure-entering-basic-new-contact-data"><para> | ||||
395 | If you have created more than one address book, use the drop-down list labeled <quote>Add to:</quote> | ||||
396 | to select the data set to which the new contact will be added. Then enter the new contact's name in | ||||
397 | the input field marked <quote>Name</quote>, and key in his or her email address in the input field | ||||
398 | labeled <quote>Email</quote>. If you want to specify special formatting options for this contact's | ||||
399 | name data, click the <guibutton> ... </guibutton> button to the right of the <quote>Name</quote> | ||||
400 | input field and follow the prompts. If you wish to add more email addresses for this person, click the | ||||
401 | <guibutton> + </guibutton> button to the right of the <quote>Email</quote> input field and another | ||||
402 | Email input field will be generated. To delete an Email address, click the associated | ||||
403 | <guibutton> − </guibutton> button. | ||||
404 | | ||||
405 | </para></step> | ||||
406 | | ||||
407 | <step id="procedure-additional-new-contact-data"><para> | ||||
408 | You may also associate a nickname, one or more telephone numbers, multiple instant messaging services, | ||||
409 | and several web sites with each contact in an address book, as explained | ||||
410 | in <link linkend="editing-contact-data">chapter 4</link>. You may also use the <quote>Show messages ...</quote> | ||||
411 | and <quote>Allow remote content ...</quote> options to fine-tune the way &kmail; handles email you receive | ||||
412 | from each contact. See<link linkend="integration-with-other-kde-programs">chapter 3</link> for a more | ||||
413 | complete explanation. | ||||
414 | </para></step> | ||||
415 | | ||||
416 | <!--TODO Note to myself: need to add an explanation of overriding KMail defaults --> | ||||
417 | | ||||
418 | </procedure> | ||||
419 | </sect1> | ||||
420 | | ||||
421 | </chapter> | ||||
422 | | ||||
423 | <chapter id="integration-with-other-kde-programs"> | ||||
424 | <title>Integration With Other KDE Programs</title> | ||||
425 | | ||||
426 | <sect1 id="integration-overview"> | ||||
427 | <title>Integration Overview -- &kmail;</title> | ||||
428 | | ||||
429 | <para> | ||||
430 | Because &kaddressbook; -- an essential piece of &PIM;, &kde;'s suite of Personal Information Management programs -- | ||||
431 | is the central repository for information about all your contacts, it has been integrated into &kmail; and also | ||||
432 | into &korganizer;. Here is a quick look at the interface between &kaddressbook; and those two programs. | ||||
433 | </para> | ||||
434 | | ||||
435 | <sect2 id="starting-kaddressbook-from-kmail-tools"> | ||||
436 | <title>Starting &kaddressbook; from &kmail;'s Tools Menu</title> | ||||
437 | | ||||
438 | <para> | ||||
439 | <screenshot id="screenshot-kmail-tools-menu"> | ||||
440 | <screeninfo>A screenshot of &kmail;'s <menuchoice><guimenu>Tools</guimenu><guimenuitem>Address Book</guimenuitem></menuchoice> option.</screeninfo> | ||||
441 | <mediaobject> | ||||
442 | <imageobject> | ||||
443 | <imagedata fileref="addressbook50.png" format="PNG"/> | ||||
444 | </imageobject> | ||||
445 | <textobject> | ||||
446 | <phrase>A screenshot of &kmail;'s <menuchoice><guimenu>Tools</guimenu><guimenuitem>Address Book</guimenuitem></menuchoice> option.</phrase> | ||||
447 | </textobject> | ||||
448 | <caption> | ||||
449 | <para>Launching &kaddressbook; from &kmail;'s <menuchoice><guimenu>Tools</guimenu><guimenuitem><inlinemediaobject><imageobject><imagedata | ||||
450 | fileref="address-book-new.png" format="PNG"/></imageobject></inlinemediaobject>Address Book</guimenuitem></menuchoice> menu choice.</para> | ||||
451 | </caption> | ||||
452 | </mediaobject> | ||||
453 | </screenshot> | ||||
454 | </para> | ||||
455 | | ||||
456 | <para> </para> <!-- add more white space after screenshot @dcb --> | ||||
457 | | ||||
458 | <para>This interface is the epitome of simplicity. Need to consult or update the entry for one of your contacts while reading | ||||
459 | or composing an email message with &kmail;? Left click <menuchoice><guimenu>Tools</guimenu><guimenuitem><inlinemediaobject><imageobject> | ||||
460 | <imagedata fileref="address-book-new.png" format="PNG"/></imageobject></inlinemediaobject>Address Book</guimenuitem> | ||||
461 | </menuchoice>, and the &kaddressbook; application will be launched automatically, allowing quick access to the contact | ||||
462 | data you want to view or modify.</para> | ||||
463 | | ||||
464 | <para> </para> <!-- add more white space before next section @dcb --> | ||||
465 | | ||||
466 | </sect2> | ||||
467 | | ||||
468 | <sect2 id="autocompletion-feature-on-new-email"> | ||||
469 | <title>Querying &kaddressbook; from &kmail;'s Message Composition Window</title> | ||||
470 | | ||||
471 | <para> | ||||
472 | <screenshot id="screenshot-autocompletion-feature"> | ||||
473 | <screeninfo>A screenshot of auto completion from inside &kmail;'s message composition window.</screeninfo> | ||||
474 | <mediaobject> | ||||
475 | <imageobject> | ||||
476 | <imagedata fileref="addressbook51.png" format="PNG"/> | ||||
477 | </imageobject> | ||||
478 | <textobject> | ||||
479 | <phrase>A screenshot of auto completion from inside &kmail;'s message composition window.</phrase> | ||||
480 | </textobject> | ||||
481 | <caption> | ||||
482 | <para>Using &kaddressbook;'s auto completion feature from inside &kmail;'s message composition window.</para> | ||||
483 | </caption> | ||||
484 | </mediaobject> | ||||
485 | </screenshot> | ||||
486 | </para> | ||||
487 | | ||||
488 | <para> </para> <!-- add more white space after screenshot @dcb --> | ||||
489 | | ||||
490 | <para>When you are composing a new email message, &kmail; helps you find the recipient's complete email | ||||
491 | address by presenting a list of probable matches drawn from the contents of &kaddressbook; and from | ||||
492 | your email archives, as illustrated above. Just left click an item in the list to use that email address.</para> | ||||
493 | | ||||
494 | <para> </para> <!-- add more white space before next section @dcb --> | ||||
495 | | ||||
496 | </sect2> | ||||
497 | | ||||
498 | <sect2 id="recipient-selection-dialog"> | ||||
499 | <title>&kmail;'s Recipient Selection Dialog</title> | ||||
500 | | ||||
501 | <para> | ||||
502 | <screenshot id="screenshot-recipient-selection"> | ||||
503 | <screeninfo>A screenshot of the recipient selection dialog inside &kmail;'s message composition window.</screeninfo> | ||||
504 | <mediaobject> | ||||
505 | <imageobject> | ||||
506 | <imagedata fileref="addressbook52.png" format="PNG"/> | ||||
507 | </imageobject> | ||||
508 | <textobject> | ||||
509 | <phrase>A screenshot of the recipient selection dialog inside &kmail;'s message composition window.</phrase> | ||||
510 | </textobject> | ||||
511 | <caption> | ||||
512 | <para>Selecting multiple addressees with the recipient selection dialog inside &kmail;'s message composition window.</para> | ||||
513 | </caption> | ||||
514 | </mediaobject> | ||||
515 | </screenshot> | ||||
516 | </para> | ||||
517 | | ||||
518 | <para> </para> <!-- add more white space after screenshot @dcb --> | ||||
519 | | ||||
520 | <para>When you are addressing a new email message to multiple recipients, &kmail; provides a convenient method | ||||
521 | of choosing multiple addressees from the contacts you have saved with &kaddressbook;. Simply left click the | ||||
522 | <guibutton> Select ... </guibutton> button to open a Drop Down Box that lists all the contacts in the | ||||
523 | selected address books. Then scroll through the list (or use the handy <quote>Search:</quote> box), | ||||
524 | select the recipient you want, and left click <guibutton> Add as To </guibutton>, | ||||
525 | <guibutton> Add as CC </guibutton>, or <guibutton> Add as BCC </guibutton> to add this person | ||||
526 | to the list of email recipients for your new message. Choose <guibutton> Add as Reply-To </guibutton> | ||||
527 | to insert this address into your message as a <quote>Reply To</quote> tag.</para> | ||||
528 | | ||||
529 | <para> </para> <!-- add more white space before next section @dcb --> | ||||
530 | | ||||
531 | </sect2> | ||||
532 | | ||||
533 | <sect2 id="new-contact-creation-interface"> | ||||
534 | <title>&kmail;'s New Contact Creation Interface</title> | ||||
535 | | ||||
536 | <para> | ||||
537 | <screenshot id="screenshot-new-contact-creation"> | ||||
538 | <screeninfo>A screenshot of the new contact creation interface inside &kmail;'s message viewing window.</screeninfo> | ||||
539 | <mediaobject> | ||||
540 | <imageobject> | ||||
541 | <imagedata fileref="addressbook53.png" format="PNG"/> | ||||
542 | </imageobject> | ||||
543 | <textobject> | ||||
544 | <phrase>A screenshot of the new contact creation interface inside &kmail;'s message viewing window.</phrase> | ||||
545 | </textobject> | ||||
546 | <caption> | ||||
547 | <para>Invoking the new contact creation dialog from &kmail;'s message viewing window.</para> | ||||
548 | </caption> | ||||
549 | </mediaobject> | ||||
550 | </screenshot> | ||||
551 | </para> | ||||
552 | | ||||
553 | <para> </para> <!-- add more white space after screenshot @dcb --> | ||||
554 | <para>When you receive an email message from someone who is not yet in your address book, &kmail; makes it very | ||||
555 | easy to create a new contact. Simply point your cursor at the email address you want to save, then click the &RMB; and | ||||
556 | a context menu will appear (see above). Select <guimenuitem> + Add to Address Book </guimenuitem> | ||||
557 | to add the selected email address to one of your address books. If you recognize this person as somebody who's already | ||||
558 | in your address book, and he is using a new email address, you may click on <guimenuitem> + Add to Existing Contact </guimenuitem> | ||||
559 | instead -- this enters a dialog that will direct &kaddressbook; to the spot where you want to insert the new email address.</para> | ||||
560 | <para> </para> <!-- add more white space before next picture @dcb --> | ||||
561 | | ||||
562 | <para> | ||||
563 | <screenshot id="screenshot-new-contact-creation-step2"> | ||||
564 | <screeninfo>A screenshot of the ensuing new contact creation dialog.</screeninfo> | ||||
565 | <mediaobject> | ||||
566 | <imageobject> | ||||
567 | <imagedata fileref="addressbook54.png" format="PNG"/> | ||||
568 | </imageobject> | ||||
569 | <textobject> | ||||
570 | <phrase>A screenshot of the ensuing new contact creation dialog.</phrase> | ||||
571 | </textobject> | ||||
572 | <caption> | ||||
573 | <para>Choosing the address book in which the new contact will be created.</para> | ||||
574 | </caption> | ||||
575 | </mediaobject> | ||||
576 | </screenshot> | ||||
577 | </para> | ||||
578 | | ||||
579 | <para> </para> <!-- add more white space after screenshot @dcb --> | ||||
580 | <para>&kmail; will ask you to choose the address book to which the new contact should be added.</para> | ||||
581 | <para> </para> <!-- add more white space before next picture @dcb --> | ||||
582 | | ||||
583 | <para> | ||||
584 | <screenshot id="screenshot-new-contact-creation-step3"> | ||||
585 | <screeninfo>Another screenshot of the ensuing new contact creation dialog.</screeninfo> | ||||
586 | <mediaobject> | ||||
587 | <imageobject> | ||||
588 | <imagedata fileref="addressbook55.png" format="PNG"/> | ||||
589 | </imageobject> | ||||
590 | <textobject> | ||||
591 | <phrase>Another screenshot of the ensuing new contact creation dialog.</phrase> | ||||
592 | </textobject> | ||||
593 | <caption> | ||||
594 | <para>Deciding if you would like to edit the newly created contact now, or later.</para> | ||||
595 | </caption> | ||||
596 | </mediaobject> | ||||
597 | </screenshot> | ||||
598 | </para> | ||||
599 | | ||||
600 | <para> </para> <!-- add more white space after screenshot @dcb --> | ||||
601 | <para>&kmail; will also ask you if you wish to <link linkend="editing-contact-data"> edit the new contact</link> | ||||
602 | that has just been added. Say <guibutton> ✔ Yes </guibutton> if you want to add more data to the | ||||
603 | new entry right away.</para> | ||||
604 | <para> </para> <!-- add more white space before next section @dcb --> | ||||
605 | | ||||
606 | </sect2> | ||||
607 | | ||||
608 | </sect1> | ||||
609 | | ||||
610 | <sect1 id="korganizer-overview"> | ||||
611 | <title>&kaddressbook;'s Interface with &korganizer;</title> | ||||
612 | | ||||
613 | <para>&korganizer;, the &kde; scheduling and calendar management program, allows you | ||||
614 | to send e-mail messages to people you want to invite to a meeting, and provides | ||||
615 | two interfaces with &kaddressbook; in this connection.</para> | ||||
616 | <para> </para> <!-- add more white space before next section @dcb --> | ||||
617 | | ||||
618 | <para> | ||||
619 | <screenshot id="screenshot-inviting-one-attendee"> | ||||
620 | <screeninfo>A screenshot of &korganizer;'s attendees tab.</screeninfo> | ||||
621 | <mediaobject> | ||||
622 | <imageobject> | ||||
623 | <imagedata fileref="addressbook60.png" format="PNG"/> | ||||
624 | </imageobject> | ||||
625 | <textobject> | ||||
626 | <phrase>A screenshot of &korganizer;'s attendees tab.</phrase> | ||||
627 | </textobject> | ||||
628 | <caption> | ||||
629 | <para>Adding a single attendee to a scheduled meeting in &korganizer;.</para> | ||||
630 | </caption> | ||||
631 | </mediaobject> | ||||
632 | </screenshot> | ||||
633 | </para> | ||||
634 | | ||||
635 | <para> </para> <!-- add more white space after screenshot @dcb --> | ||||
636 | <para>The first interface is just like the <link linkend="autocompletion-feature-on-new-email">auto completion | ||||
637 | feature</link> provided by &kmail;: just start typing the name of the person you want to invite, and you will | ||||
638 | be presented with a list of probable matches, as illustrated above.</para> | ||||
639 | <para> </para> <!-- add more white space before next section @dcb --> | ||||
640 | | ||||
641 | <para> | ||||
642 | <screenshot id="screenshot-inviting-multiple-attendees"> | ||||
643 | <screeninfo>A screenshot of &korganizer;'s attendees tab.</screeninfo> | ||||
644 | <mediaobject> | ||||
645 | <imageobject> | ||||
646 | <imagedata fileref="addressbook61.png" format="PNG"/> | ||||
647 | </imageobject> | ||||
648 | <textobject> | ||||
649 | <phrase>&korganizer;'s attendees tab.</phrase> | ||||
650 | </textobject> | ||||
651 | <caption> | ||||
652 | <para>Adding multiple attendees to a scheduled meeting in &korganizer;.</para> | ||||
653 | </caption> | ||||
654 | </mediaobject> | ||||
655 | </screenshot> | ||||
656 | </para> | ||||
657 | | ||||
658 | <para> </para> <!-- add more white space after screenshot @dcb --> | ||||
659 | <para>The second interface is just like the <link linkend="recipient-selection-dialog">recipient selection | ||||
660 | dialog</link> provided by &kmail;: when you left click the <guibutton> Select Attendees ... </guibutton> | ||||
661 | button, a searchable list of the contacts in all your address books will appear, as the preceding screenshot shows.</para> | ||||
662 | | ||||
663 | </sect1> | ||||
664 | | ||||
665 | </chapter> | ||||
666 | | ||||
667 | <chapter id="editing-contact-data"> | ||||
668 | <title>Adding or Editing Contact Data</title> | ||||
669 | | ||||
670 | <sect1 id="edit-basic-info"> | ||||
671 | <title>The Basics</title> | ||||
672 | | ||||
673 | <para>When you first click on the <guibutton><inlinemediaobject><imageobject><imagedata fileref="list-add.png" | ||||
674 | format="PNG"/></imageobject></inlinemediaobject>Add Contact </guibutton> button on &kaddressbook;'s | ||||
675 | Toolbar, this screen will appear. (If you click on <guibutton><inlinemediaobject><imageobject><imagedata | ||||
676 | fileref="document-edit.png" format="PNG"/></imageobject></inlinemediaobject>Edit Contact </guibutton>, | ||||
677 | a similar screen appears, the only difference being that the drop-down box labeled <quote>Add to:</quote> will | ||||
678 | not appear as part of the <quote>Edit</quote> dialog. That is why both functions are covered in this chapter: | ||||
679 | they're practically identical.)</para> | ||||
680 | | ||||
681 | <para> | ||||
682 | <screenshot id="screenshot-new-contact-dialog-2"> | ||||
683 | <screeninfo>A screenshot of &kaddressbook;'s <quote>New Contact</quote> dialog.</screeninfo> | ||||
684 | <mediaobject> | ||||
685 | <imageobject> | ||||
686 | <imagedata fileref="addressbook40.png" format="PNG"/> | ||||
687 | </imageobject> | ||||
688 | <textobject> | ||||
689 | <phrase>A screenshot of &kaddressbook;'s <quote>New Contact</quote> dialog.</phrase> | ||||
690 | </textobject> | ||||
691 | <caption> | ||||
692 | <para>&kaddressbook;'s <quote>Add Contact</quote> dialog after clicking the | ||||
693 | <guibutton><inlinemediaobject><imageobject><imagedata fileref="list-add.png" format="PNG"/> | ||||
694 | </imageobject></inlinemediaobject>Add Contact </guibutton> button on the Toolbar.</para> | ||||
695 | </caption> | ||||
696 | </mediaobject> | ||||
697 | </screenshot> | ||||
698 | </para> | ||||
699 | | ||||
700 | <para> </para> <!-- add more white space after screenshot @dcb --> | ||||
701 | | ||||
702 | <sect2 id="edit-contact-tab"> | ||||
703 | <title>The Contact Tab</title> | ||||
704 | | ||||
705 | <para>We have already seen (in <link linkend="how-to-add-a-new-contact">How to Add a New Contact</link> ) | ||||
706 | how basic data like Name and Email are entered when a new contact record is created. Here's a description | ||||
707 | of the many ways to use the rest of the data fields accessible from the <quote>Contact</quote> tab in | ||||
708 | the <guibutton><inlinemediaobject><imageobject><imagedata fileref="list-add.png" format="PNG"/> | ||||
709 | </imageobject></inlinemediaobject>Add Contact </guibutton> dialog.</para> | ||||
710 | | ||||
711 | <variablelist> | ||||
712 | | ||||
713 | <varlistentry><term>Phone</term><listitem><para>You may associate one or more telephone numbers with | ||||
714 | this person. Use the <guibutton> + </guibutton> and <guibutton> − </guibutton> | ||||
715 | buttons to add or delete phone number fields. The | ||||
716 | <guibutton> Home<inlinemediaobject><imageobject><imagedata fileref="go-down.png" format="PNG"/></imageobject></inlinemediaobject></guibutton> | ||||
717 | Drop Down Box allows you to identify fifteen categories of phone numbers (Home, Work, Mobile, Car,<glossterm linkend="gloss-isdn"> | ||||
718 | <acronym>ISDN</acronym></glossterm>, <glossterm linkend="gloss-pcs"><acronym>PCS</acronym></glossterm>, &etc;)</para></listitem> | ||||
719 | </varlistentry> | ||||
720 | | ||||
721 | <varlistentry><term>Messaging</term><listitem><para>You may associate one or more Instant Messaging | ||||
722 | service identities with this person. Use the <guibutton> + </guibutton> and | ||||
723 | <guibutton> − </guibutton> buttons to add or delete messaging service fields. The | ||||
724 | <guibutton> Select ...<inlinemediaobject><imageobject><imagedata fileref="go-down.png" format="PNG"/></imageobject></inlinemediaobject></guibutton> | ||||
725 | Drop Down Box permits you to identify thirteen categories of IM services: <glossterm linkend="gloss-aim">AIM,</glossterm> | ||||
726 | Facebook, <glossterm linkend="gloss-gadu-gadu">Gadu-Gadu</glossterm>, Google Talk, <glossterm linkend="gloss-gpws">GroupWise</glossterm>, | ||||
727 | <glossterm linkend="gloss-icq"><acronym>ICQ</acronym></glossterm>, <glossterm linkend="gloss-irc"><acronym>IRC</acronym></glossterm>, | ||||
728 | <glossterm linkend="gloss-jabber">Jabber</glossterm>, <glossterm linkend="gloss-mnwhl">Meanwhile</glossterm>, | ||||
729 | <glossterm linkend="gloss-sms"><acronym>SMS</acronym></glossterm>, Skype, Twitter, and Yahoo. (MSN Messenger is | ||||
730 | still on the list of IM services in version 5.10.3; it has been defunct since 2014.)</para></listitem> | ||||
731 | </varlistentry> | ||||
732 | | ||||
733 | <varlistentry><term>Web</term><listitem><para>You may associate one or more web site URLs with this | ||||
734 | person. Use the <guibutton> + </guibutton> and <guibutton> − </guibutton> | ||||
735 | buttons to add or delete Web address fields. The <guibutton> Select ...<inlinemediaobject><imageobject> | ||||
736 | <imagedata fileref="go-down.png" format="PNG"/></imageobject></inlinemediaobject></guibutton> | ||||
737 | Drop Down Box allows you to identify three different kinds of Web addresses: Home, Work, and Other.</para></listitem> | ||||
738 | </varlistentry> | ||||
739 | | ||||
740 | <varlistentry><term>Tags</term><listitem><para>You may associate one or more Tags of your own devising with this | ||||
741 | person. Use the <guibutton> ... </guibutton> button to enter the Tag creation and configuration dialog | ||||
742 | illustrated below.</para></listitem> | ||||
743 | </varlistentry> | ||||
744 | | ||||
745 | </variablelist> | ||||
746 | | ||||
747 | <para> | ||||
748 | <screenshot id="screenshot-add-tags-dialog"> | ||||
749 | <screeninfo>&kaddressbook;'s <quote>Tags</quote> dialog.</screeninfo> | ||||
750 | <mediaobject> | ||||
751 | <imageobject> | ||||
752 | <imagedata fileref="addressbook71.png" format="PNG"/> | ||||
753 | </imageobject> | ||||
754 | <textobject> | ||||
755 | <phrase>&kaddressbook;'s <quote>Tags</quote> dialog.</phrase> | ||||
756 | </textobject> | ||||
757 | <caption> | ||||
758 | <para>&kaddressbook;'s <quote>Manage Tags</quote> dialog after clicking the | ||||
759 | <guibutton> ... </guibutton> button next to <quote>Tags</quote>.</para> | ||||
760 | </caption> | ||||
761 | </mediaobject> | ||||
762 | </screenshot> | ||||
763 | </para> | ||||
764 | | ||||
765 | <para> </para> <!-- add more white space after screenshot @dcb --> | ||||
766 | | ||||
767 | <variablelist> | ||||
768 | <varlistentry><term>Tags (continued)</term><listitem><para>Use the <guibutton> Create new tag </guibutton> | ||||
769 | button and the data entry field to the left to build your customized list of tags. Select the | ||||
770 | tags associated with this person from the list appearing in the configuration window. Press the | ||||
771 | <guibutton> ✔ OK </guibutton> button to add the selected tags to this contact.</para></listitem> | ||||
772 | </varlistentry> | ||||
773 | | ||||
774 | <varlistentry><term>Blog Feed</term><listitem><para>Use this field to record the URL associated with this | ||||
775 | contact's web log, or blog.</para></listitem> | ||||
776 | </varlistentry> | ||||
777 | | ||||
778 | <varlistentry><term>Show messages ...</term><listitem><para>Use this Drop Down Box to override the corresponding message | ||||
779 | display option in &kmail;'s <guibutton> Privacy & Security </guibutton> configuration menu. Choose | ||||
780 | <quote>Default</quote> to leave it up to &kmail;. Choose <quote>Plain Text</quote> or <quote>HTML</quote> if you | ||||
781 | want to override &kmail;'s default behavior when you receive a message from this person.</para></listitem> | ||||
782 | </varlistentry> | ||||
783 | | ||||
784 | <varlistentry><term>Allow remote content ...</term><listitem><para>Select this option if you want to override the | ||||
785 | corresponding message display option in &kmail;'s <guibutton> Privacy & Security </guibutton> | ||||
786 | configuration menu when you receive a message from this person.</para></listitem> | ||||
787 | </varlistentry> | ||||
788 | | ||||
789 | <varlistentry><term><guibutton> ✔ OK </guibutton></term><listitem><para>Select this option to save the | ||||
790 | changes you have made. This button performs the same function in all seven tabs appearing in the <guibutton><inlinemediaobject><imageobject> | ||||
791 | <imagedata fileref="list-add.png" format="PNG"/></imageobject></inlinemediaobject>Add Contact </guibutton> dialog.</para></listitem> | ||||
792 | </varlistentry> | ||||
793 | | ||||
794 | <varlistentry><term><guibutton> ⦸ Cancel </guibutton></term><listitem><para>Select this option to leave | ||||
795 | the <guibutton><inlinemediaobject><imageobject><imagedata fileref="list-add.png" format="PNG"/></imageobject> | ||||
796 | </inlinemediaobject>Add Contact </guibutton> dialog without saving your changes. This button performs | ||||
797 | the same function in all seven tabs appearing in the <quote>Add Contact</quote> dialog.</para></listitem> | ||||
798 | </varlistentry> | ||||
799 | | ||||
800 | </variablelist> | ||||
801 | <para> </para> <!-- add more white space after variablelist @dcb --> | ||||
802 | | ||||
803 | </sect2> | ||||
804 | | ||||
805 | <sect2 id="edit-location-tab"> | ||||
806 | <title>The Location Tab</title> | ||||
807 | | ||||
808 | <para>Use the data input fields in the <quote>Location</quote> tab shown below to associate one or more snail-mail | ||||
809 | addresses with this person.</para> | ||||
810 | | ||||
811 | <para> | ||||
812 | <screenshot id="screenshot-location-tab"> | ||||
813 | <screeninfo>&kaddressbook;'s <quote>Location</quote> tab.</screeninfo> | ||||
814 | <mediaobject> | ||||
815 | <imageobject> | ||||
816 | <imagedata fileref="addressbook72.png" format="PNG"/> | ||||
817 | </imageobject> | ||||
818 | <textobject> | ||||
819 | <phrase>&kaddressbook;'s <quote>Location</quote> tab.</phrase> | ||||
820 | </textobject> | ||||
821 | <caption> | ||||
822 | <para>&kaddressbook;'s <quote>Location</quote> tab, part of the | ||||
823 | <quote>Add Contact</quote> dialog.</para> | ||||
824 | </caption> | ||||
825 | </mediaobject> | ||||
826 | </screenshot> | ||||
827 | </para> | ||||
828 | | ||||
829 | <para> </para> <!-- add more white space after screenshot @dcb --> | ||||
830 | | ||||
831 | <variablelist> | ||||
832 | <varlistentry><term>(unlabeled) Drop Down Box</term><listitem><para>Use this list of categories to describe each | ||||
833 | mailing address for this contact. Available options include <quote>Home</quote>, <quote>Work</quote>, | ||||
834 | <quote>Postal</quote>, &etc;</para></listitem> | ||||
835 | </varlistentry> | ||||
836 | | ||||
837 | <varlistentry><term>Street / Post Office Box / Postal Code / Locality / Region</term><listitem><para>Use these free-form | ||||
838 | data fields to enter mailing address data: Street Address, PO Box, ZIP Code, City, and State, respectively, for | ||||
839 | addresses in the U.S.A.</para></listitem> | ||||
840 | </varlistentry> | ||||
841 | | ||||
842 | <varlistentry><term>Country</term><listitem><para>Use this Drop Down Box to select a country, from | ||||
843 | Afghanistan to Zimbabwe.</para></listitem> | ||||
844 | </varlistentry> | ||||
845 | | ||||
846 | <varlistentry><term>This is the preferred address</term><listitem><para>Check this box to designate the | ||||
847 | preferred, or default, mailing address.</para></listitem> | ||||
848 | </varlistentry> | ||||
849 | | ||||
850 | <varlistentry><term><guibutton> Add Address </guibutton></term><listitem><para>When you have finished | ||||
851 | entering address data, left click this button to add a new address to the set of saved addresses appearing in | ||||
852 | the large display window to the right.</para></listitem> | ||||
853 | </varlistentry> | ||||
854 | | ||||
855 | <varlistentry><term>Icon<inlinemediaobject><imageobject><imagedata fileref="document-edit.png" format="PNG"/></imageobject></inlinemediaobject> | ||||
856 | in the large display window</term> | ||||
857 | <listitem><para>Left click this icon to edit the associated address data.</para></listitem> | ||||
858 | </varlistentry> | ||||
859 | | ||||
860 | <varlistentry><term>Icon<inlinemediaobject><imageobject><imagedata fileref="edit-delete.png" format="PNG"/></imageobject></inlinemediaobject> | ||||
861 | in the large display window</term> | ||||
862 | <listitem><para>Left click this icon to delete the associated address data.</para></listitem> | ||||
863 | </varlistentry> | ||||
864 | | ||||
865 | </variablelist> | ||||
866 | <para> </para> <!-- add more white space after variablelist @dcb --> | ||||
867 | </sect2> | ||||
868 | | ||||
869 | <sect2 id="edit-business-tab"> | ||||
870 | <title>The Business, Personal, and Notes Tabs</title> | ||||
871 | | ||||
872 | <para>The next three tabs in the <quote>Add Contact</quote> dialog are even simpler than | ||||
873 | the <quote>Location</quote> tab. They allow you to save some information about this person's | ||||
874 | business and professional affiliations, a few personal details, and miscellaneous free-form | ||||
875 | notes, respectively.</para> | ||||
876 | | ||||
877 | <para> | ||||
878 | <screenshot id="screenshot-business-tab"> | ||||
879 | <screeninfo>&kaddressbook;'s <quote>Business</quote> tab.</screeninfo> | ||||
880 | <mediaobject> | ||||
881 | <imageobject> | ||||
882 | <imagedata fileref="addressbook73.png" format="PNG"/> | ||||
883 | </imageobject> | ||||
884 | <textobject> | ||||
885 | <phrase>&kaddressbook;'s <quote>Business</quote> tab.</phrase> | ||||
886 | </textobject> | ||||
887 | <caption> | ||||
888 | <para>&kaddressbook;'s <quote>Business</quote> tab, part of the | ||||
889 | <quote>Add Contact</quote> dialog.</para> | ||||
890 | </caption> | ||||
891 | </mediaobject> | ||||
892 | </screenshot> | ||||
893 | </para> | ||||
894 | | ||||
895 | <para> </para> <!-- add more white space after screenshot @dcb --> | ||||
896 | | ||||
897 | <para>The <quote>Business</quote> tab, shown above, lets you save some additional details | ||||
898 | about this person's professional and business associations. All the input fields are free-form; | ||||
899 | you may enter any kind of text data in each field. The small | ||||
900 | <guibutton><inlinemediaobject><imageobject><imagedata fileref="document-open.png" format="PNG"/></imageobject></inlinemediaobject></guibutton> | ||||
901 | button will open a file search dialog, making it easy to associate a filename with this person's | ||||
902 | <quote>Free/Busy</quote> schedule, if you wish.</para> | ||||
903 | | ||||
904 | <para>Notice that you should enter your business associate's phone as a telephone number under the | ||||
905 | <quote><link linkend="edit-contact-tab">Contact</link></quote> tab. Similarly, his office address is entered | ||||
906 | via the <quote>Location</quote> tab, as described in <link linkend="edit-location-tab">the preceding section</link>.</para> | ||||
907 | | ||||
908 | <para> </para> <!-- add more white space before next screenshot @dcb --> | ||||
909 | <para> | ||||
910 | <screenshot id="screenshot-personal-tab"> | ||||
911 | <screeninfo>&kaddressbook;'s <quote>Personal</quote> tab.</screeninfo> | ||||
912 | <mediaobject> | ||||
913 | <imageobject> | ||||
914 | <imagedata fileref="addressbook74.png" format="PNG"/> | ||||
915 | </imageobject> | ||||
916 | <textobject> | ||||
917 | <phrase>&kaddressbook;'s <quote>Personal</quote> tab.</phrase> | ||||
918 | </textobject> | ||||
919 | <caption> | ||||
920 | <para>&kaddressbook;'s <quote>Personal</quote> tab, part of the | ||||
921 | <quote>Add Contact</quote> dialog.</para> | ||||
922 | </caption> | ||||
923 | </mediaobject> | ||||
924 | </screenshot> | ||||
925 | </para> | ||||
926 | | ||||
927 | <para> </para> <!-- add more white space after screenshot @dcb --> | ||||
928 | | ||||
929 | <para>Use this tab to store a few personal details: this person's birthday, his wedding anniversary, and | ||||
930 | the name of his partner, or significant other. Click one of the buttons (⪚, <guibutton><inlinemediaobject><imageobject> | ||||
931 | <imagedata fileref="view-calendar-birthday.png" format="PNG"/></imageobject></inlinemediaobject></guibutton> ) | ||||
932 | to enter his date of birth, or his wedding anniversary. | ||||
933 | </para> | ||||
934 | | ||||
935 | <para> </para> <!-- add more white space before next screenshot @dcb --> | ||||
936 | <para> | ||||
937 | <screenshot id="screenshot-notes-tab"> | ||||
938 | <screeninfo>&kaddressbook;'s <quote>Notes</quote> tab.</screeninfo> | ||||
939 | <mediaobject> | ||||
940 | <imageobject> | ||||
941 | <imagedata fileref="addressbook75.png" format="PNG"/> | ||||
942 | </imageobject> | ||||
943 | <textobject> | ||||
944 | <phrase>&kaddressbook;'s <quote>Notes</quote> tab.</phrase> | ||||
945 | </textobject> | ||||
946 | <caption> | ||||
947 | <para>&kaddressbook;'s <quote>Notes</quote> tab, part of the | ||||
948 | <quote>Add Contact</quote> dialog.</para> | ||||
949 | </caption> | ||||
950 | </mediaobject> | ||||
951 | </screenshot> | ||||
952 | </para> | ||||
953 | | ||||
954 | <para> </para> <!-- add more white space after screenshot @dcb --> | ||||
955 | | ||||
956 | <para>The <quote>Notes</quote> tab provides a totally free-form input area in which | ||||
957 | you may enter any data you want to associate with this person.</para> | ||||
958 | | ||||
959 | </sect2> | ||||
960 | | ||||
961 | </sect1> | ||||
962 | | ||||
963 | <sect1 id="edit-advanced-info"> | ||||
964 | <title>The Tricky Stuff</title> | ||||
965 | | ||||
966 | <para>&kaddressbook; provides a couple of more complex data storage features, in addition to the simple | ||||
967 | functions described in the preceding section.</para> | ||||
968 | | ||||
969 | <sect2 id="edit-custom-tab"> | ||||
970 | <title>The Custom Fields Tab</title> | ||||
971 | | ||||
972 | <para>Not happy with the wide array of data items that &kaddressbook; has already pre-programmed for | ||||
973 | you? Well, you're in luck. Someday -- maybe soon --you may utilize the <quote>Custom Fields</quote> dialog | ||||
974 | shown below to define and populate as many additional data fields as you can possibly use.</para> | ||||
975 | | ||||
976 | <para> | ||||
977 | <screenshot id="screenshot-custom-tab"> | ||||
978 | <screeninfo>&kaddressbook;'s <quote>Custom Fields</quote> tab.</screeninfo> | ||||
979 | <mediaobject> | ||||
980 | <imageobject> | ||||
981 | <imagedata fileref="addressbook76.png" format="PNG"/> | ||||
982 | </imageobject> | ||||
983 | <textobject> | ||||
984 | <phrase>&kaddressbook;'s <quote>Custom Fields</quote> tab.</phrase> | ||||
985 | </textobject> | ||||
986 | <caption> | ||||
987 | <para>&kaddressbook;'s <quote>Custom Fields</quote> tab, part of the | ||||
988 | <quote>Add Contact</quote> dialog.</para> | ||||
989 | </caption> | ||||
990 | </mediaobject> | ||||
991 | </screenshot> | ||||
992 | </para> | ||||
993 | | ||||
994 | <para> </para> <!-- add more white space after screenshot @dcb --> | ||||
995 | | ||||
996 | <para>This is an experimental feature which doesn't yet do anything worth talking about. So I'm not | ||||
997 | going to say anything else about it.</para> | ||||
998 | | ||||
999 | <para> </para> <!-- add more white space between sections @dcb --> | ||||
1000 | | ||||
1001 | </sect2> | ||||
1002 | | ||||
1003 | <sect2 id="edit-crypto-tab"> | ||||
1004 | <title>The Crypto Settings Tab</title> | ||||
1005 | | ||||
1006 | <para>Need to send a confidential email message that ought not be read by prying eyes? &kaddressbook; | ||||
1007 | provides a simple way for you to associate cryptographic keys with each person on your mailing list.</para> | ||||
1008 | | ||||
1009 | <para> | ||||
1010 | <screenshot id="screenshot-crypto-tab"> | ||||
1011 | <screeninfo>&kaddressbook;'s <quote>Crypto Settings</quote> tab.</screeninfo> | ||||
1012 | <mediaobject> | ||||
1013 | <imageobject> | ||||
1014 | <imagedata fileref="addressbook77.png" format="PNG"/> | ||||
1015 | </imageobject> | ||||
1016 | <textobject> | ||||
1017 | <phrase>&kaddressbook;'s <quote>Crypto Settings</quote> tab.</phrase> | ||||
1018 | </textobject> | ||||
1019 | <caption> | ||||
1020 | <para>&kaddressbook;'s <quote>Crypto Settings</quote> tab, part of the | ||||
1021 | <quote>Add Contact</quote> dialog.</para> | ||||
1022 | </caption> | ||||
1023 | </mediaobject> | ||||
1024 | </screenshot> | ||||
1025 | </para> | ||||
1026 | | ||||
1027 | <para> </para> <!-- add more white space after screenshot @dcb --> | ||||
1028 | | ||||
1029 | <variablelist> | ||||
1030 | <varlistentry><term>Allowed Protocols</term><listitem><para>Choose which mode of encryption you wish to use when | ||||
1031 | sending a message to this person: <glossterm linkend="gloss-inline-pgp">Inline OpenPGP</glossterm>, <glossterm | ||||
1032 | linkend="gloss-open-pgp">OpenPGP/<acronym>MIME</acronym></glossterm>, <glossterm linkend="gloss-mime"><acronym>S/MIME</acronym> | ||||
1033 | </glossterm>, or <glossterm linkend="gloss-opaque"><acronym>S/MIME</acronym> Opaque</glossterm>.</para></listitem> | ||||
1034 | </varlistentry> | ||||
1035 | | ||||
1036 | <varlistentry><term>Preferred OpenPGP Encryption Key:</term><listitem><para>Use the <guibutton> Change... </guibutton> | ||||
1037 | button to select from a list of available Open<glossterm linkend="gloss-pgp">PGP</glossterm> keys, if you have chosen OpenPGP | ||||
1038 | encryption. Use the <guibutton><inlinemediaobject><imageobject><imagedata fileref="edit-clear.png" format="PNG"/></imageobject> | ||||
1039 | </inlinemediaobject></guibutton> button to clear a previously selected key.</para></listitem> | ||||
1040 | </varlistentry> | ||||
1041 | | ||||
1042 | <varlistentry><term>Preferred <acronym>S/MIME</acronym> Encryption Certificate:</term> | ||||
1043 | <listitem><para>Use the <guibutton> Change... </guibutton> button to select from a list of available certificates, | ||||
1044 | if you are using a verified key. Use the <guibutton><inlinemediaobject><imageobject><imagedata fileref="edit-clear.png" format="PNG"/> | ||||
1045 | </imageobject></inlinemediaobject></guibutton> button to clear a previously selected key.</para></listitem> | ||||
1046 | </varlistentry> | ||||
1047 | | ||||
1048 | <varlistentry><term>Message Preference / Sign:</term><listitem><para>Use this drop-down box to specify when messages addressed to | ||||
1049 | this person should bear your cryptographic signature: Never / Always / If Possible / Ask.</para></listitem> | ||||
1050 | </varlistentry> | ||||
1051 | | ||||
1052 | <varlistentry><term>Message Preference / Encrypt:</term><listitem><para>Use this drop-down box to specify when messages addressed to | ||||
1053 | this person should be encrypted by using the selected protocol and key: Never / Always / If Possible / Ask.</para></listitem> | ||||
1054 | </varlistentry> | ||||
1055 | | ||||
1056 | </variablelist> | ||||
1057 | | ||||
1058 | </sect2> | ||||
1059 | | ||||
1060 | </sect1> | ||||
1061 | | ||||
1062 | </chapter> | ||||
1063 | | ||||
1064 | <chapter id="commands"> | ||||
1065 | <title>Command Reference</title> | ||||
1066 | | ||||
1067 | <sect1 id="menu-bar-items"> | ||||
1068 | <title>The Menu Bar</title> | ||||
1069 | | ||||
1070 | <para>Here is a rundown of the seven menus appearing on &kaddressbook;'s Menubar.</para> | ||||
1071 | | ||||
1072 | | ||||
1073 | <sect2 id="the-file-menu"> | ||||
1074 | <title>The File Menu</title> | ||||
1075 | | ||||
1076 | <para> | ||||
1077 | <screenshot id="screenshot-file-menu"> | ||||
1078 | <screeninfo>A screenshot of &kaddressbook;'s <quote>File</quote> menu.</screeninfo> | ||||
1079 | <mediaobject> | ||||
1080 | <imageobject> | ||||
1081 | <imagedata fileref="addressbook80.png" format="PNG"/> | ||||
1082 | </imageobject> | ||||
1083 | <textobject> | ||||
1084 | <phrase>A screenshot of &kaddressbook;'s <quote>File</quote> menu.</phrase> | ||||
1085 | </textobject> | ||||
1086 | <caption> | ||||
1087 | <para>&kaddressbook;'s <quote>File</quote> menu after clicking the | ||||
1088 | <menuchoice><guimenu>File</guimenu></menuchoice> button on the Menubar.</para> | ||||
1089 | </caption> | ||||
1090 | </mediaobject> | ||||
1091 | </screenshot> | ||||
1092 | </para> | ||||
1093 | | ||||
1094 | <para> </para> <!-- add more white space after screenshot @dcb --> | ||||
1095 | | ||||
1096 | <para>The <menuchoice><guimenu>File</guimenu></menuchoice> menu lets you access six main functions, three of which have several options.</para> | ||||
1097 | | ||||
1098 | <para> </para> <!-- add more white space @dcb --> | ||||
1099 | <variablelist> | ||||
1100 | | ||||
1101 | <varlistentry> | ||||
1102 | <term><menuchoice><shortcut><keycombo action="simul">&Ctrl;<keycap>N</keycap></keycombo></shortcut><guimenu>File</guimenu> | ||||
1103 | <guisubmenu>New ></guisubmenu><guimenuitem><inlinemediaobject><imageobject><imagedata fileref="list-add.png" | ||||
1104 | format="PNG"/></imageobject></inlinemediaobject>New Contact</guimenuitem></menuchoice></term> | ||||
1105 | <listitem><para>This has exactly the same effect as clicking the <guibutton> + New Contact </guibutton> button | ||||
1106 | on the Toolbar. See <link linkend="how-to-add-a-new-contact">chapter 2 above</link> for complete details.</para></listitem> | ||||
1107 | </varlistentry> | ||||
1108 | | ||||
1109 | <varlistentry> | ||||
1110 | <term><menuchoice><shortcut><keycombo action="simul">&Ctrl;<keycap>G</keycap></keycombo></shortcut><guimenu>File</guimenu> | ||||
1111 | <guisubmenu>New ></guisubmenu><guimenuitem><inlinemediaobject><imageobject><imagedata fileref="user-group-new.png" | ||||
1112 | format="PNG"/></imageobject></inlinemediaobject>New Group</guimenuitem></menuchoice></term> | ||||
1113 | <listitem><para>Opens a dialog in which you may define a new group, or mailing list. See <link linkend="file-new-group">the appendix</link> | ||||
1114 | for a detailed explanation of this function.</para></listitem> | ||||
1115 | </varlistentry> | ||||
1116 | | ||||
1117 | <varlistentry> | ||||
1118 | <term><menuchoice><guimenu>File</guimenu><guisubmenu>New ></guisubmenu><guimenuitem><inlinemediaobject><imageobject> | ||||
1119 | <imagedata fileref="folder-new.png" format="PNG"/></imageobject></inlinemediaobject>Add Address Book</guimenuitem></menuchoice></term> | ||||
1120 | <listitem><para>This opens the <quote>Add Address Book</quote> dialog, which is fully documented in | ||||
1121 | <link linkend="how-to-add-a-new-address-book">chapter 2 above</link>.</para></listitem> | ||||
1122 | </varlistentry> | ||||
1123 | | ||||
1124 | <varlistentry> | ||||
1125 | <term><menuchoice><guimenu>File</guimenu><guisubmenu>Import ></guisubmenu><guimenuitem>Import from LDAP | ||||
1126 | server ...</guimenuitem></menuchoice></term> | ||||
1127 | <listitem><para>This function allows you to import data from an <acronym>LDAP</acronym> server. The server must be configured before | ||||
1128 | you can use this function. See <link linkend="configure-ldap-server">the appendix</link> for full details.</para></listitem> | ||||
1129 | </varlistentry> | ||||
1130 | | ||||
1131 | <varlistentry> | ||||
1132 | <term><menuchoice><guimenu>File</guimenu><guisubmenu>Import ></guisubmenu><guimenuitem>Import CSV file ...</guimenuitem></menuchoice></term> | ||||
1133 | <listitem><para>This function allows you to import contact data from a comma separated values (<acronym>csv</acronym>) file. A dialog ensues, in which | ||||
1134 | you may associate each field in the input file with a named field in &kaddressbook;'s internal storage record. See <link linkend="import-csv-data">the | ||||
1135 | appendix</link> for a more detailed explanation.</para></listitem> | ||||
1136 | </varlistentry> | ||||
1137 | | ||||
1138 | <varlistentry> | ||||
1139 | <term><menuchoice><guimenu>File</guimenu><guisubmenu>Import ></guisubmenu><guimenuitem>Import vCard ...</guimenuitem></menuchoice></term> | ||||
1140 | <listitem><para>This function facilitates the importation of <acronym>vcf</acronym>, or vCard, data. All three versions of vCard are supported. | ||||
1141 | You can learn more about the vCard formats <ulink url="https://en.wikipedia.org/wiki/VCard">at this web site</ulink>.</para></listitem> | ||||
1142 | </varlistentry> | ||||
1143 | | ||||
1144 | <varlistentry> | ||||
1145 | <term><menuchoice><guimenu>File</guimenu><guisubmenu>Export ></guisubmenu><guimenuitem>Export CSV file ...</guimenuitem></menuchoice></term> | ||||
1146 | <listitem><para>This function allows you to export selected contact data as a Comma Separated Values (<acronym>csv</acronym>) file. There are 47 | ||||
1147 | fields in the output record. Please refer to <link linkend="export-csv-data">the appendix</link> for a list of those data fields.</para></listitem> | ||||
1148 | </varlistentry> | ||||
1149 | | ||||
1150 | <varlistentry> | ||||
1151 | <term><menuchoice><guimenu>File</guimenu><guisubmenu>Export ></guisubmenu><guimenuitem>Export vCard 4.0 ...</guimenuitem></menuchoice></term> | ||||
1152 | <listitem><para>This function allows you to export selected contact data as a file in <acronym>vCard 4.0</acronym> format. See | ||||
1153 | <ulink url="https://en.wikipedia.org/wiki/VCard">this Wikipedia article</ulink> for more information.</para></listitem> | ||||
1154 | </varlistentry> | ||||
1155 | | ||||
1156 | <varlistentry> | ||||
1157 | <term><menuchoice><guimenu>File</guimenu><guisubmenu>Export ></guisubmenu><guimenuitem>Export vCard 3.0 ...</guimenuitem></menuchoice></term> | ||||
1158 | <listitem><para>This function allows you to export selected contact data as a file in <acronym>vCard 3.0</acronym> format. This | ||||
1159 | format is similar to <acronym>vCard 4.0</acronym> format.</para></listitem> | ||||
1160 | </varlistentry> | ||||
1161 | | ||||
1162 | <varlistentry> | ||||
1163 | <term><menuchoice><guimenu>File</guimenu><guisubmenu>Export ></guisubmenu><guimenuitem>Export vCard 2.1 ...</guimenuitem></menuchoice></term> | ||||
1164 | <listitem><para>This function allows you to export selected contact data as a file in <acronym>vCard 2.1</acronym> format. This | ||||
1165 | format is similar to <acronym>vCard 3.0</acronym> format.</para></listitem> | ||||
1166 | </varlistentry> | ||||
1167 | | ||||
1168 | <varlistentry> | ||||
1169 | <term><menuchoice><shortcut><keycombo action="simul">&Ctrl;<keycap>P</keycap></keycombo></shortcut><guimenu>File</guimenu> | ||||
1170 | <guisubmenu><inlinemediaobject><imageobject><imagedata fileref="document-print.png" format="PNG"/></imageobject> | ||||
1171 | </inlinemediaobject>Print</guisubmenu></menuchoice></term> | ||||
1172 | <listitem><para>Opens a printer selection dialog. Use the <menuchoice><guisubmenu><inlinemediaobject><imageobject> | ||||
1173 | <imagedata fileref="document-preview-archive.png" format="PNG"/></imageobject></inlinemediaobject>Print Preview</guisubmenu></menuchoice> | ||||
1174 | dialog below to set up the range of names and the print format before you select this function.</para></listitem> | ||||
1175 | </varlistentry> | ||||
1176 | | ||||
1177 | <varlistentry> | ||||
1178 | <term><menuchoice><guimenu>File</guimenu><guisubmenu><inlinemediaobject><imageobject><imagedata fileref="document-preview-archive.png" format="PNG"/> | ||||
1179 | </imageobject></inlinemediaobject>Print Preview</guisubmenu></menuchoice></term> | ||||
1180 | <listitem><para>Opens a print preview dialog, which also permits you to format the report, select which items to include, and | ||||
1181 | specify a sort order, etc. See <link linkend="file-print-preview">the appendix</link> for further details.</para></listitem> | ||||
1182 | </varlistentry> | ||||
1183 | | ||||
1184 | <varlistentry> | ||||
1185 | <term><menuchoice><shortcut><keycombo action="simul">&Ctrl;<keycap>Q</keycap></keycombo></shortcut><guimenu>File</guimenu> | ||||
1186 | <guisubmenu><inlinemediaobject><imageobject><imagedata fileref="application-exit.png" format="PNG"/></imageobject> | ||||
1187 | </inlinemediaobject>Quit</guisubmenu></menuchoice></term> | ||||
1188 | <listitem><para>Closes the &kaddressbook; application.</para></listitem> | ||||
1189 | </varlistentry> | ||||
1190 | | ||||
1191 | </variablelist> | ||||
1192 | | ||||
1193 | <para> </para> <!-- add more white space between sections @dcb --> | ||||
1194 | | ||||
1195 | </sect2> | ||||
1196 | | ||||
1197 | <sect2 id="the-edit-menu"> | ||||
1198 | <title>The Edit Menu</title> | ||||
1199 | | ||||
1200 | <para> | ||||
1201 | <screenshot id="screenshot-edit-menu"> | ||||
1202 | <screeninfo>A screenshot of &kaddressbook;'s <quote>Edit</quote> menu.</screeninfo> | ||||
1203 | <mediaobject> | ||||
1204 | <imageobject> | ||||
1205 | <imagedata fileref="addressbook81.png" format="PNG"/> | ||||
1206 | </imageobject> | ||||
1207 | <textobject> | ||||
1208 | <phrase>A screenshot of &kaddressbook;'s <quote>Edit</quote> menu.</phrase> | ||||
1209 | </textobject> | ||||
1210 | <caption> | ||||
1211 | <para>&kaddressbook;'s <quote>Edit</quote> menu after clicking the | ||||
1212 | <menuchoice><guimenu>Edit</guimenu></menuchoice> button on the Menubar.</para> | ||||
1213 | </caption> | ||||
1214 | </mediaobject> | ||||
1215 | </screenshot> | ||||
1216 | </para> | ||||
1217 | | ||||
1218 | <para> </para> <!-- add more white space after screenshot @dcb --> | ||||
1219 | | ||||
1220 | <para>The <menuchoice><guimenu>Edit</guimenu></menuchoice> menu lets you access eight main functions, two of which have multiple options.</para> | ||||
1221 | | ||||
1222 | <para> </para> <!-- add more white space @dcb --> | ||||
1223 | <variablelist> | ||||
1224 | | ||||
1225 | <varlistentry> | ||||
1226 | <term><menuchoice><guimenu>Edit</guimenu><guisubmenu><inlinemediaobject><imageobject><imagedata fileref="document-edit.png" | ||||
1227 | format="PNG"/></imageobject></inlinemediaobject>Edit Contact ...</guisubmenu></menuchoice></term> | ||||
1228 | <listitem><para>This has nearly the same effect as clicking the <guibutton> + New Contact </guibutton> button | ||||
1229 | on the Toolbar. The difference is that this menu item allows you to edit a contact record that already exists, instead of creating | ||||
1230 | a brand new one. See <link linkend="how-to-add-a-new-contact">chapter 2 above</link> for complete details.</para></listitem> | ||||
1231 | </varlistentry> | ||||
1232 | | ||||
1233 | <varlistentry> | ||||
1234 | <term><menuchoice><shortcut><keycombo action="simul">&Ctrl;<keycap>X</keycap></keycombo></shortcut><guimenu>Edit</guimenu><guisubmenu><inlinemediaobject> | ||||
1235 | <imageobject><imagedata fileref="edit-cut.png" format="PNG"/></imageobject></inlinemediaobject>Cut Contact ...</guisubmenu></menuchoice></term> | ||||
1236 | <listitem><para>Performs a <quote>Cut</quote> operation on the selected contact. A copy of this contact, in | ||||
1237 | <glossterm linkend="gloss-vcf"><acronym>vCard 3.0</acronym></glossterm> format, is placed on the clipboard. The | ||||
1238 | <quote>Cut</quote> will be completed when you <quote>Paste</quote> this contact somewhere.</para></listitem> | ||||
1239 | </varlistentry> | ||||
1240 | | ||||
1241 | <varlistentry> | ||||
1242 | <term><menuchoice><guimenu>Edit</guimenu><guisubmenu><inlinemediaobject><imageobject><imagedata fileref="edit-copy.png" | ||||
1243 | format="PNG"/></imageobject></inlinemediaobject>Copy Contact ...</guisubmenu></menuchoice></term> | ||||
1244 | <listitem><para>Places a copy of this contact on the clipboard, so you can paste it somewhere else.</para></listitem> | ||||
1245 | </varlistentry> | ||||
1246 | | ||||
1247 | <varlistentry> | ||||
1248 | <term><menuchoice><shortcut><keycombo action="simul">&Ctrl;<keycap>V</keycap></keycombo></shortcut><guimenu>Edit</guimenu><guisubmenu><inlinemediaobject> | ||||
1249 | <imageobject><imagedata fileref="edit-paste.png" format="PNG"/></imageobject></inlinemediaobject>Paste</guisubmenu></menuchoice></term> | ||||
1250 | <listitem><para><quote>Pastes</quote> the cut or copied contact at the current location. This may be in the same address book you | ||||
1251 | did the <quote>Cut</quote> or <quote>Copy</quote> from, or in another address book. Since the preceding operations placed | ||||
1252 | the contact information on the system's clipboard, you may also paste it somewhere else besides &kaddressbook; (⪚ into a | ||||
1253 | text editor, or as a <acronym>vCard 3.0</acronym> file in your home folder).</para></listitem> | ||||
1254 | </varlistentry> | ||||
1255 | | ||||
1256 | <varlistentry> | ||||
1257 | <term><menuchoice><guimenu>Edit</guimenu><guisubmenu><inlinemediaobject><imageobject><imagedata fileref="edit-copy.png" format="PNG"/></imageobject> | ||||
1258 | </inlinemediaobject>Copy Contact To ></guisubmenu><guimenuitem>(a variable list)</guimenuitem></menuchoice></term> | ||||
1259 | <listitem><para>Combines the <quote>Copy</quote> and <quote>Paste</quote> operations into a single click of the left | ||||
1260 | mouse button. The list of destinations displayed depends on how many address books you have created.</para></listitem> | ||||
1261 | </varlistentry> | ||||
1262 | | ||||
1263 | <varlistentry> | ||||
1264 | <term><menuchoice><guimenu>Edit</guimenu><guisubmenu><inlinemediaobject><imageobject><imagedata fileref="go-jump.png" format="PNG"/></imageobject> | ||||
1265 | </inlinemediaobject>Move Contact To ></guisubmenu><guimenuitem>(a variable list)</guimenuitem></menuchoice></term> | ||||
1266 | <listitem><para>Works just like the <quote>Copy Contact To</quote> operation described above, except that it combines | ||||
1267 | <quote>Cut</quote> and <quote>Paste</quote> into a single click of the left mouse button.</para></listitem> | ||||
1268 | </varlistentry> | ||||
1269 | | ||||
1270 | <varlistentry> | ||||
1271 | <term><menuchoice><shortcut><keycombo action="press">∇</keycombo></shortcut><guimenu>Edit</guimenu><guisubmenu><inlinemediaobject><imageobject> | ||||
1272 | <imagedata fileref="edit-delete.png" format="PNG"/></imageobject></inlinemediaobject>Delete Contact</guisubmenu></menuchoice></term> | ||||
1273 | <listitem><para>Delete the selected contact from the current address book.</para></listitem> | ||||
1274 | </varlistentry> | ||||
1275 | | ||||
1276 | <varlistentry> | ||||
1277 | <term><menuchoice><guimenu>Edit</guimenu><guisubmenu><inlinemediaobject><imageobject><imagedata fileref="edit-delete.png" | ||||
1278 | format="PNG"/></imageobject></inlinemediaobject>Delete Address Book</guisubmenu></menuchoice></term> | ||||
1279 | <listitem><para>Delete the current address book. Be careful with this command -- you could lose some data! | ||||
1280 | In theory, this function simply removes the symbolic link between &kaddressbook; and the associated <acronym>vCard</acronym> | ||||
1281 | file or directory (or the hyperlink to a <glossterm linkend="gloss-cloud">cloud-based service</glossterm>), and the real data will | ||||
1282 | not be altered. Still, it's probably wisest to make a backup copy of this address book somewhere before you delete it.</para></listitem> | ||||
1283 | </varlistentry> | ||||
1284 | | ||||
1285 | </variablelist> | ||||
1286 | | ||||
1287 | <para> </para> <!-- add more white space between sections @dcb --> | ||||
1288 | | ||||
1289 | </sect2> | ||||
1290 | | ||||
1291 | <sect2 id="the-view-menu"> | ||||
1292 | <title>The View Menu</title> | ||||
1293 | | ||||
1294 | <para> | ||||
1295 | <screenshot id="screenshot-view-menu"> | ||||
1296 | <screeninfo>A screenshot of &kaddressbook;'s <quote>View</quote> menu.</screeninfo> | ||||
1297 | <mediaobject> | ||||
1298 | <imageobject> | ||||
1299 | <imagedata fileref="addressbook82.png" format="PNG"/> | ||||
1300 | </imageobject> | ||||
1301 | <textobject> | ||||
1302 | <phrase>A screenshot of &kaddressbook;'s <quote>View</quote> menu.</phrase> | ||||
1303 | </textobject> | ||||
1304 | <caption> | ||||
1305 | <para>&kaddressbook;'s <quote>View</quote> menu after clicking the | ||||
1306 | <menuchoice><guimenu>View</guimenu></menuchoice> button on the Menubar.</para> | ||||
1307 | </caption> | ||||
1308 | </mediaobject> | ||||
1309 | </screenshot> | ||||
1310 | </para> | ||||
1311 | | ||||
1312 | <para> </para> <!-- add more white space after screenshot @dcb --> | ||||
1313 | | ||||
1314 | <para>The <menuchoice><guimenu>View</guimenu></menuchoice> menu lets you access four main functions, and one experimental | ||||
1315 | feature which doesn't really do anything yet.</para> | ||||
1316 | | ||||
1317 | <para> </para> <!-- add more white space @dcb --> | ||||
1318 | <variablelist> | ||||
1319 | | ||||
1320 | <varlistentry> | ||||
1321 | <term><menuchoice><guimenu>View</guimenu><guisubmenu>Themes ></guisubmenu></menuchoice></term> | ||||
1322 | <listitem><para>This menu item doesn't really do anything. It will open a <quote>Themes</quote> dialog, | ||||
1323 | but that dialog is broken in release 5.10.3.</para></listitem> | ||||
1324 | </varlistentry> | ||||
1325 | | ||||
1326 | <varlistentry> | ||||
1327 | <term><menuchoice><shortcut><keycombo action="simul">&Ctrl;&Shift;<keycap>1</keycap></keycombo></shortcut> | ||||
1328 | <guimenu>View</guimenu><guisubmenu><inlinemediaobject><imageobject><imagedata fileref="draw-circle.png" | ||||
1329 | format="PNG"/></imageobject></inlinemediaobject>Simple (one column)</guisubmenu></menuchoice></term> | ||||
1330 | <listitem><para>Changes the default three panel layout into a single column. For more details, see | ||||
1331 | <link linkend="view-change-columns">the appendix</link>.</para></listitem> | ||||
1332 | </varlistentry> | ||||
1333 | | ||||
1334 | <varlistentry> | ||||
1335 | <term><menuchoice><shortcut><keycombo action="simul">&Ctrl;&Shift;<keycap>2</keycap></keycombo></shortcut> | ||||
1336 | <guimenu>View</guimenu><guisubmenu><inlinemediaobject><imageobject><imagedata fileref="draw-circle.png" | ||||
1337 | format="PNG"/></imageobject></inlinemediaobject>Two columns</guisubmenu></menuchoice></term> | ||||
1338 | <listitem><para>Changes the default three panel layout into two panels. For more details, see | ||||
1339 | <link linkend="view-change-columns">the appendix</link>.</para></listitem> | ||||
1340 | </varlistentry> | ||||
1341 | | ||||
1342 | <varlistentry> | ||||
1343 | <term><menuchoice><shortcut><keycombo action="simul">&Ctrl;&Shift;<keycap>3</keycap></keycombo></shortcut> | ||||
1344 | <guimenu>View</guimenu><guisubmenu><inlinemediaobject><imageobject><imagedata fileref="draw-circle.png" | ||||
1345 | format="PNG"/></imageobject></inlinemediaobject>Three columns</guisubmenu></menuchoice></term> | ||||
1346 | <listitem><para>Switches back to the default three panel layout.</para></listitem> | ||||
1347 | </varlistentry> | ||||
1348 | | ||||
1349 | <varlistentry> | ||||
1350 | <term><menuchoice><guimenu>View</guimenu><guisubmenu><inlinemediaobject><imageobject><imagedata fileref="draw-rectangle.png" | ||||
1351 | format="PNG"/></imageobject></inlinemediaobject>Show QR Codes</guisubmenu></menuchoice></term> | ||||
1352 | <listitem><para>Check this box to display contact information as a QR code. Uncheck it to suppress QR codes.</para></listitem> | ||||
1353 | </varlistentry> | ||||
1354 | | ||||
1355 | </variablelist> | ||||
1356 | | ||||
1357 | <para> </para> <!-- add more white space between sections @dcb --> | ||||
1358 | | ||||
1359 | </sect2> | ||||
1360 | | ||||
1361 | <sect2 id="the-action-menu"> | ||||
1362 | <title>The Action Menu</title> | ||||
1363 | | ||||
1364 | <para> | ||||
1365 | <screenshot id="screenshot-action-menu"> | ||||
1366 | <screeninfo>A screenshot of &kaddressbook;'s <quote>Action</quote> menu.</screeninfo> | ||||
1367 | <mediaobject> | ||||
1368 | <imageobject> | ||||
1369 | <imagedata fileref="addressbook83.png" format="PNG"/> | ||||
1370 | </imageobject> | ||||
1371 | <textobject> | ||||
1372 | <phrase>A screenshot of &kaddressbook;'s <quote>Action</quote> menu.</phrase> | ||||
1373 | </textobject> | ||||
1374 | <caption> | ||||
1375 | <para>&kaddressbook;'s <quote>Action</quote> menu after clicking the | ||||
1376 | <menuchoice><guimenu>Action</guimenu></menuchoice> button on the Menubar.</para> | ||||
1377 | </caption> | ||||
1378 | </mediaobject> | ||||
1379 | </screenshot> | ||||
1380 | </para> | ||||
1381 | | ||||
1382 | <para> </para> <!-- add more white space after screenshot @dcb --> | ||||
1383 | | ||||
1384 | <para>The <menuchoice><guimenu>Action</guimenu></menuchoice> menu lets you access two data transmission functions.</para> | ||||
1385 | | ||||
1386 | <para> </para> <!-- add more white space @dcb --> | ||||
1387 | <variablelist> | ||||
1388 | | ||||
1389 | <varlistentry> | ||||
1390 | <term><menuchoice><guimenu>Action</guimenu><guisubmenu><inlinemediaobject><imageobject><imagedata fileref="mail-message-new.png" | ||||
1391 | format="PNG"/></imageobject></inlinemediaobject>Send vCards...</guisubmenu></menuchoice></term> | ||||
1392 | <listitem><para>This option is similar to <quote>Send an email...</quote>, below, except that after | ||||
1393 | you select some contacts with &Ctrl; and your mouse, the message composition window will open with a | ||||
1394 | blank list of addressees, and with files attached (the selected contacts, in vCard 3.0 format). This | ||||
1395 | makes it easy to share selected &kaddressbook; information with your friends and business associates.</para></listitem> | ||||
1396 | </varlistentry> | ||||
1397 | | ||||
1398 | <varlistentry> | ||||
1399 | <term><menuchoice><guimenu>Action</guimenu><guisubmenu><inlinemediaobject><imageobject><imagedata fileref="mail-message-new.png" | ||||
1400 | format="PNG"/></imageobject></inlinemediaobject>Send an email...</guisubmenu></menuchoice></term> | ||||
1401 | <listitem><para>This option provides an alternate method for setting a new email message's recipient list. | ||||
1402 | Press &Ctrl; (or &Shift;) and select the people to whom you wish to send the new message, by using your left | ||||
1403 | mouse button. Then click on <quote>Send an Email...</quote>; this will open a &kmail; composition window. All | ||||
1404 | the selected contacts will be listed as <quote>To</quote> addressees.</para></listitem> | ||||
1405 | </varlistentry> | ||||
1406 | | ||||
1407 | </variablelist> | ||||
1408 | | ||||
1409 | <para> </para> <!-- add more white space between sections @dcb --> | ||||
1410 | | ||||
1411 | </sect2> | ||||
1412 | | ||||
1413 | <sect2 id="the-tools-menu"> | ||||
1414 | <title>The Tools Menu</title> | ||||
1415 | | ||||
1416 | <para> | ||||
1417 | <screenshot id="screenshot-tools-menu"> | ||||
1418 | <screeninfo>A screenshot of &kaddressbook;'s <quote>Tools</quote> menu.</screeninfo> | ||||
1419 | <mediaobject> | ||||
1420 | <imageobject> | ||||
1421 | <imagedata fileref="addressbook84.png" format="PNG"/> | ||||
1422 | </imageobject> | ||||
1423 | <textobject> | ||||
1424 | <phrase>A screenshot of &kaddressbook;'s <quote>Tools</quote> menu.</phrase> | ||||
1425 | </textobject> | ||||
1426 | <caption> | ||||
1427 | <para>&kaddressbook;'s <quote>Tools</quote> menu after clicking the | ||||
1428 | <menuchoice><guimenu>Tools</guimenu></menuchoice> button on the Menubar.</para> | ||||
1429 | </caption> | ||||
1430 | </mediaobject> | ||||
1431 | </screenshot> | ||||
1432 | </para> | ||||
1433 | | ||||
1434 | <para> </para> <!-- add more white space after screenshot @dcb --> | ||||
1435 | | ||||
1436 | <para>The <menuchoice><guimenu>Tools</guimenu></menuchoice> menu lets you access two data management functions.</para> | ||||
1437 | | ||||
1438 | <para> </para> <!-- add more white space @dcb --> | ||||
1439 | <variablelist> | ||||
1440 | | ||||
1441 | <varlistentry> | ||||
1442 | <term><menuchoice><guimenu>Tools</guimenu><guisubmenu>Merge Contacts...</guisubmenu></menuchoice></term> | ||||
1443 | <listitem><para>This tool allows you to merge the contents of two or more &kaddressbook; records. To activate it, | ||||
1444 | you must first select two or more contacts (hold &Ctrl; or &Shift; and left-click contacts to make your selection). | ||||
1445 | A dialog box will appear, asking you to verify which contacts you wish to combine, and where the merged record | ||||
1446 | should be saved. Click <quote>merge</quote> to complete the operation.</para></listitem> | ||||
1447 | </varlistentry> | ||||
1448 | | ||||
1449 | <varlistentry> | ||||
1450 | <term><menuchoice><guimenu>Tools</guimenu><guisubmenu>Search Duplicate Contacts...</guisubmenu></menuchoice></term> | ||||
1451 | <listitem><para>This tool will search one or more address books for duplicate entries, and offer you the option | ||||
1452 | of merging any duplicate records it finds.</para></listitem> | ||||
1453 | </varlistentry> | ||||
1454 | </variablelist> | ||||
1455 | | ||||
1456 | <para> </para> <!-- add more white space between sections @dcb --> | ||||
1457 | | ||||
1458 | </sect2> | ||||
1459 | | ||||
1460 | <sect2 id="the-settings-menu"> | ||||
1461 | <title>The Settings Menu</title> | ||||
1462 | | ||||
1463 | <para> | ||||
1464 | <screenshot id="screenshot-settings-menu"> | ||||
1465 | <screeninfo>A screenshot of &kaddressbook;'s <quote>Settings</quote> menu.</screeninfo> | ||||
1466 | <mediaobject> | ||||
1467 | <imageobject> | ||||
1468 | <imagedata fileref="addressbook85.png" format="PNG"/> | ||||
1469 | </imageobject> | ||||
1470 | <textobject> | ||||
1471 | <phrase>A screenshot of &kaddressbook;'s <quote>Settings</quote> menu.</phrase> | ||||
1472 | </textobject> | ||||
1473 | <caption> | ||||
1474 | <para>&kaddressbook;'s <quote>Settings</quote> menu after clicking the | ||||
1475 | <menuchoice><guimenu>Settings</guimenu></menuchoice> button on the Menubar.</para> | ||||
1476 | </caption> | ||||
1477 | </mediaobject> | ||||
1478 | </screenshot> | ||||
1479 | </para> | ||||
1480 | | ||||
1481 | <para> </para> <!-- add more white space after screenshot @dcb --> | ||||
1482 | | ||||
1483 | <para> </para> <!-- add more white space between sections @dcb --> | ||||
1484 | | ||||
1485 | <para>The <menuchoice><guimenu>Settings</guimenu></menuchoice> menu offers you five options for fine-tuning the | ||||
1486 | way &kaddressbook; operates.</para> | ||||
1487 | | ||||
1488 | <para> </para> <!-- add more white space @dcb --> | ||||
1489 | <variablelist> | ||||
1490 | | ||||
1491 | <varlistentry> | ||||
1492 | <term><menuchoice><guimenu>Settings</guimenu><guisubmenu><inlinemediaobject><imageobject><imagedata fileref="draw-rectangle.png" | ||||
1493 | format="PNG"/></imageobject></inlinemediaobject><inlinemediaobject><imageobject><imagedata fileref="show-menu.png" | ||||
1494 | format="PNG"/></imageobject></inlinemediaobject>Show Menubar</guisubmenu></menuchoice> | ||||
1495 | <keycombo action="simul">&Ctrl;<keycap>M</keycap></keycombo></term> | ||||
1496 | <listitem><para>This option allows you to show or hide the Menubar.</para></listitem> | ||||
1497 | </varlistentry> | ||||
1498 | | ||||
1499 | <varlistentry> | ||||
1500 | <term><menuchoice><guimenu>Settings</guimenu><guisubmenu><inlinemediaobject><imageobject><imagedata fileref="draw-rectangle.png" | ||||
1501 | format="PNG"/></imageobject></inlinemediaobject>Show Toolbar</guisubmenu></menuchoice></term> | ||||
1502 | <listitem><para>This option allows you to show or hide the Toolbar.</para></listitem> | ||||
1503 | </varlistentry> | ||||
1504 | | ||||
1505 | <varlistentry> | ||||
1506 | <term><menuchoice><guimenu>Settings</guimenu><guisubmenu><inlinemediaobject><imageobject><imagedata fileref="input-keyboard.png" | ||||
1507 | format="PNG"/></imageobject></inlinemediaobject>Configure Shortcuts...</guisubmenu></menuchoice></term> | ||||
1508 | <listitem><para>This option allows you to customize the keyboard shortcuts available within &kaddressbook;. | ||||
1509 | See <link linkend="settings-configure-shortcuts">the appendix</link> for more details.</para></listitem> | ||||
1510 | </varlistentry> | ||||
1511 | | ||||
1512 | <varlistentry> | ||||
1513 | <term><menuchoice><guimenu>Settings</guimenu><guisubmenu><inlinemediaobject><imageobject><imagedata fileref="configure.png" | ||||
1514 | format="PNG"/></imageobject></inlinemediaobject>Configure Toolbars...</guisubmenu></menuchoice></term> | ||||
1515 | <listitem><para>This option allows you to customize the contents of &kaddressbook;'s Toolbar. | ||||
1516 | See <link linkend="settings-configure-toolbars">the appendix</link> for more details.</para></listitem> | ||||
1517 | </varlistentry> | ||||
1518 | | ||||
1519 | <varlistentry> | ||||
1520 | <term><menuchoice><guimenu>Settings</guimenu><guisubmenu><inlinemediaobject><imageobject><imagedata fileref="configure.png" | ||||
1521 | format="PNG"/></imageobject></inlinemediaobject>Configure &kaddressbook;...</guisubmenu></menuchoice> | ||||
1522 | <keycombo action="simul">&Ctrl;&Shift;<keycap>,</keycap></keycombo></term> | ||||
1523 | <listitem><para>This option allows you to configure several advanced &kaddressbook; options. | ||||
1524 | See <link linkend="settings-configure-kaddressbook">the appendix</link> for more details.</para></listitem> | ||||
1525 | </varlistentry> | ||||
1526 | | ||||
1527 | </variablelist> | ||||
1528 | | ||||
1529 | <para> </para> <!-- add more white space between sections @dcb --> | ||||
1530 | | ||||
1531 | </sect2> | ||||
1532 | | ||||
1533 | <sect2 id="the-help-menu"> | ||||
1534 | <title>The Help Menu</title> | ||||
1535 | | ||||
1536 | <para> | ||||
1537 | <screenshot id="screenshot-help-menu"> | ||||
1538 | <screeninfo>A screenshot of &kaddressbook;'s <quote>Help</quote> menu.</screeninfo> | ||||
1539 | <mediaobject> | ||||
1540 | <imageobject> | ||||
1541 | <imagedata fileref="addressbook86.png" format="PNG"/> | ||||
1542 | </imageobject> | ||||
1543 | <textobject> | ||||
1544 | <phrase>A screenshot of &kaddressbook;'s <quote>Help</quote> menu.</phrase> | ||||
1545 | </textobject> | ||||
1546 | <caption> | ||||
1547 | <para>&kaddressbook;'s <quote>Help</quote> menu after clicking the | ||||
1548 | <menuchoice><guimenu>Help</guimenu></menuchoice> button on the Menubar.</para> | ||||
1549 | </caption> | ||||
1550 | </mediaobject> | ||||
1551 | </screenshot> | ||||
1552 | </para> | ||||
1553 | | ||||
1554 | <para> </para> <!-- add more white space after screenshot @dcb --> | ||||
1555 | | ||||
1556 | <para>The <menuchoice><guimenu>Help</guimenu></menuchoice> menu offers seven options.</para> | ||||
1557 | | ||||
1558 | <para> </para> <!-- add more white space @dcb --> | ||||
1559 | <variablelist> | ||||
1560 | | ||||
1561 | <varlistentry> | ||||
1562 | <term><menuchoice><guimenu>Help</guimenu><guisubmenu><inlinemediaobject><imageobject><imagedata fileref="system-help.png" | ||||
1563 | format="PNG"/></imageobject></inlinemediaobject>&kaddressbook; Handbook</guisubmenu></menuchoice> | ||||
1564 | <keycombo action="press"><keycap>F1</keycap></keycombo></term> | ||||
1565 | <listitem><para>This option displays a copy of <quote>The &kaddressbook; Handbook</quote> via the | ||||
1566 | &khelpcenter; utility program.</para></listitem> | ||||
1567 | </varlistentry> | ||||
1568 | | ||||
1569 | <varlistentry> | ||||
1570 | <term><menuchoice><guimenu>Help</guimenu><guisubmenu><inlinemediaobject><imageobject><imagedata fileref="help-about.png" | ||||
1571 | format="PNG"/></imageobject></inlinemediaobject>What's This?</guisubmenu></menuchoice><keycombo action="simul">&Shift; | ||||
1572 | <keycap>F1</keycap></keycombo></term> | ||||
1573 | <listitem><para>This is &kaddressbook;'s built-in help tool. Left-click this option, then move your cursor and click on any | ||||
1574 | one of the first four items on the Toolbar. A brief description of that tool's function will be displayed.</para></listitem> | ||||
1575 | </varlistentry> | ||||
1576 | | ||||
1577 | <varlistentry> | ||||
1578 | <term><menuchoice><guimenu>Help</guimenu><guisubmenu><inlinemediaobject><imageobject><imagedata fileref="tools-report-bug.png" | ||||
1579 | format="PNG"/></imageobject></inlinemediaobject>Report Bug</guisubmenu></menuchoice></term> | ||||
1580 | <listitem><para>This option opens a dialog that helps you file a bug report at <ulink | ||||
1581 | url="https://bugs.kde.org/">bugs.kde.org</ulink>, &kde;'s main bug tracking page.</para></listitem> | ||||
1582 | </varlistentry> | ||||
1583 | | ||||
1584 | <varlistentry> | ||||
1585 | <term><menuchoice><guimenu>Help</guimenu><guisubmenu><inlinemediaobject><imageobject><imagedata fileref="application-x-ms-shortcut.png" | ||||
1586 | format="PNG"/></imageobject></inlinemediaobject>Donate</guisubmenu></menuchoice></term> | ||||
1587 | <listitem><para>This opens a <ulink url="https://kde.org/community/donations/?app=kaddressbook">web | ||||
1588 | page</ulink> in your browser, where you may donate money to support &kde;. We accept euros, dollars, | ||||
1589 | rubles, sterling, yen, yuan, pesos, &etc;</para></listitem> | ||||
1590 | </varlistentry> | ||||
1591 | | ||||
1592 | <varlistentry> | ||||
1593 | <term><menuchoice><guimenu>Help</guimenu><guisubmenu><inlinemediaobject><imageobject><imagedata fileref="change-language.png" | ||||
1594 | format="PNG"/></imageobject></inlinemediaobject>Switch Application Language</guisubmenu></menuchoice></term> | ||||
1595 | <listitem><para>This option lets you change the language that is used to label the various menu items and built-in | ||||
1596 | help screens. You must quit &kaddressbook; and restart it before the new language takes effect.</para></listitem> | ||||
1597 | </varlistentry> | ||||
1598 | | ||||
1599 | <varlistentry> | ||||
1600 | <term><menuchoice><guimenu>Help</guimenu><guisubmenu><inlinemediaobject><imageobject><imagedata fileref="kaddressbook.png" | ||||
1601 | format="PNG"/></imageobject></inlinemediaobject>About &kaddressbook;</guisubmenu></menuchoice></term> | ||||
1602 | <listitem><para>Click on this item to learn which release of &kaddressbook; you're running, which libraries | ||||
1603 | were used to compile / build the executable code, and who the lead &kde; programmer is.</para></listitem> | ||||
1604 | </varlistentry> | ||||
1605 | | ||||
1606 | <varlistentry> | ||||
1607 | <term><menuchoice><guimenu>Help</guimenu><guisubmenu><inlinemediaobject><imageobject><imagedata fileref="KDE_logo.png" | ||||
1608 | format="PNG"/></imageobject></inlinemediaobject>About &kde;</guisubmenu></menuchoice></term> | ||||
1609 | <listitem><para>This option displays information about &kde;. Be free!</para></listitem> | ||||
1610 | </varlistentry> | ||||
1611 | | ||||
1612 | </variablelist> | ||||
1613 | | ||||
1614 | </sect2> | ||||
1615 | | ||||
1616 | </sect1> | ||||
1617 | | ||||
1618 | <sect1 id="tool-bar-items"> | ||||
1619 | <title>The Tool Bar</title> | ||||
1620 | | ||||
1621 | <para>There are five separate tools available on &kaddressbook;'s Toolbar: <quote>New Contact</quote>, <quote>New Group</quote>, | ||||
1622 | <quote>Edit Contact</quote>, <quote>Search...</quote>, and a category filter. Here's a picture. (Note that I have only documented | ||||
1623 | the default version of &kaddressbook;'s Toolbar. You may alter the Toolbar layout by using the <link linkend="the-settings-menu"> | ||||
1624 | <quote>Settings</quote></link> menu, if you so desire.)</para> | ||||
1625 | | ||||
1626 | <para> | ||||
1627 | <screenshot id="screenshot-tool-bar"> | ||||
1628 | <screeninfo>A closeup of &kaddressbook;'s Toolbar.</screeninfo> | ||||
1629 | <mediaobject> | ||||
1630 | <imageobject> | ||||
1631 | <imagedata fileref="addressbook87.png" format="PNG"/> | ||||
1632 | </imageobject> | ||||
1633 | <textobject> | ||||
1634 | <phrase>A closeup of &kaddressbook;'s Toolbar.</phrase> | ||||
1635 | </textobject> | ||||
1636 | <caption> | ||||
1637 | <para>&kaddressbook;'s standard Toolbar, up close and personal.</para> | ||||
1638 | </caption> | ||||
1639 | </mediaobject> | ||||
1640 | </screenshot> | ||||
1641 | </para> | ||||
1642 | | ||||
1643 | <para> </para> <!-- add more white space after screenshot @dcb --> | ||||
1644 | | ||||
1645 | <variablelist> | ||||
1646 | | ||||
1647 | <varlistentry> | ||||
1648 | <term><guibutton><inlinemediaobject><imageobject><imagedata fileref="list-add.png" | ||||
1649 | format="PNG"/></imageobject></inlinemediaobject>New Contact</guibutton></term> | ||||
1650 | <listitem><para>This Toolbar button opens the <quote>Add New Contact</quote> dialog | ||||
1651 | documented in <link linkend="edit-basic-info">chapter 4</link>, above.</para></listitem> | ||||
1652 | </varlistentry> | ||||
1653 | | ||||
1654 | <varlistentry> | ||||
1655 | <term><guibutton><inlinemediaobject><imageobject><imagedata fileref="user-group-new.png" | ||||
1656 | format="PNG"/></imageobject></inlinemediaobject>New Group</guibutton></term> | ||||
1657 | <listitem><para>This Toolbar button opens the <quote>Add New Group</quote> dialog | ||||
1658 | documented in <link linkend="file-new-group">the appendix</link>.</para></listitem> | ||||
1659 | </varlistentry> | ||||
1660 | | ||||
1661 | <varlistentry> | ||||
1662 | <term><guibutton><inlinemediaobject><imageobject><imagedata fileref="document-edit.png" | ||||
1663 | format="PNG"/></imageobject></inlinemediaobject>Edit Contact</guibutton></term> | ||||
1664 | <listitem><para>This Toolbar button opens the <quote>Edit Contact</quote> dialog | ||||
1665 | documented in <link linkend="edit-basic-info">chapter 4</link>, above.</para></listitem> | ||||
1666 | </varlistentry> | ||||
1667 | | ||||
1668 | <varlistentry> | ||||
1669 | <term>[ Search... <keycombo action="simul">&Alt;<keycap>Q</keycap></keycombo> ]</term> | ||||
1670 | <listitem><para>This tool searches through all the contacts in selected address books as you type. | ||||
1671 | Pressing &Alt;+Q simply positions the cursor inside the <quote>Search...</quote> | ||||
1672 | box. Be aware that this function searches the entirety of each contact record; a search for | ||||
1673 | <quote>and</quote> may return not only Andy Brown and Andrew Jones, but also Bill | ||||
1674 | Smith (who happens to work for Brown and Root Construction Company).</para></listitem> | ||||
1675 | </varlistentry> | ||||
1676 | | ||||
1677 | </variablelist> | ||||
1678 | | ||||
1679 | <para> | ||||
1680 | <screenshot id="toolbar-search"> | ||||
1681 | <screeninfo>A screenshot of &kaddressbook;'s <quote>Search</quote> function.</screeninfo> | ||||
1682 | <mediaobject> | ||||
1683 | <imageobject> | ||||
1684 | <imagedata fileref="addressbook91.png" format="PNG"/> | ||||
1685 | </imageobject> | ||||
1686 | <textobject> | ||||
1687 | <phrase>A screenshot of &kaddressbook;'s <quote>Search</quote> function.</phrase> | ||||
1688 | </textobject> | ||||
1689 | <caption> | ||||
1690 | <para>&kaddressbook;'s <quote>Search</quote> function in action.</para> | ||||
1691 | </caption> | ||||
1692 | </mediaobject> | ||||
1693 | </screenshot> | ||||
1694 | </para> | ||||
1695 | | ||||
1696 | <para> </para> <!-- add more white space after screenshot @dcb --> | ||||
1697 | | ||||
1698 | <variablelist> | ||||
1699 | | ||||
1700 | <varlistentry> | ||||
1701 | <term>[ (All) <inlinemediaobject><imageobject><imagedata fileref="edit-clear.png" format="PNG"/></imageobject></inlinemediaobject> | ||||
1702 | <inlinemediaobject><imageobject><imagedata fileref="go-down.png" format="PNG"/></imageobject></inlinemediaobject>]</term> | ||||
1703 | <listitem><para>This tool performs a filtering function, based on categories. The two default categories are <quote>Untagged</quote> | ||||
1704 | and <quote>Groups</quote>. You can create new categories by associating <quote>Tags</quote> of your own devising with particular | ||||
1705 | contact records (see <link linkend="edit-basic-info">Add New Contact</link> in chapter 4, above). Clicking either <guibutton><inlinemediaobject> | ||||
1706 | <imageobject><imagedata fileref="edit-clear.png" format="PNG"/></imageobject></inlinemediaobject></guibutton> button will set the selected | ||||
1707 | categories to <quote>None</quote>; the <guibutton><inlinemediaobject><imageobject><imagedata fileref="view-refresh.png" format="PNG"/> | ||||
1708 | </imageobject></inlinemediaobject></guibutton> button will reset the selection criteria to <quote>All</quote>.</para></listitem> | ||||
1709 | </varlistentry> | ||||
1710 | | ||||
1711 | </variablelist> | ||||
1712 | | ||||
1713 | <para> | ||||
1714 | <screenshot id="toolbar-filter"> | ||||
1715 | <screeninfo>A screenshot of &kaddressbook;'s <quote>Filter</quote> function.</screeninfo> | ||||
1716 | <mediaobject> | ||||
1717 | <imageobject> | ||||
1718 | <imagedata fileref="addressbook92.png" format="PNG"/> | ||||
1719 | </imageobject> | ||||
1720 | <textobject> | ||||
1721 | <phrase>A screenshot of &kaddressbook;'s <quote>Filter</quote> function.</phrase> | ||||
1722 | </textobject> | ||||
1723 | <caption> | ||||
1724 | <para>&kaddressbook;'s <quote>Filter</quote> function in action.</para> | ||||
1725 | </caption> | ||||
1726 | </mediaobject> | ||||
1727 | </screenshot> | ||||
1728 | </para> | ||||
1729 | | ||||
1730 | </sect1> | ||||
1731 | | ||||
1732 | <sect1 id="context-menus"> | ||||
1733 | <title>The Context Menus</title> | ||||
1734 | | ||||
1735 | <para>When you click the right mouse button anywhere inside the main Text Area, a context menu will appear, as illustrated below. | ||||
1736 | The particular menu that appears depends on both the panel within which the right-click occurred and the particular data item that | ||||
1737 | was selected, if any.</para> | ||||
1738 | | ||||
1739 | <sect2 id="the-addressbook-panel"> | ||||
1740 | <title>The Address Book Context Menu</title> | ||||
1741 | | ||||
1742 | <para> | ||||
1743 | <screenshot id="addressbook-context-menu"> | ||||
1744 | <screeninfo>A screenshot of &kaddressbook;'s <quote>Address Book</quote> context menu.</screeninfo> | ||||
1745 | <mediaobject> | ||||
1746 | <imageobject> | ||||
1747 | <imagedata fileref="addressbook93.png" format="PNG"/> | ||||
1748 | </imageobject> | ||||
1749 | <textobject> | ||||
1750 | <phrase>A screenshot of &kaddressbook;'s <quote>Address Book</quote> context menu.</phrase> | ||||
1751 | </textobject> | ||||
1752 | <caption> | ||||
1753 | <para>&kaddressbook;'s <quote>Address Book</quote> context menu.</para> | ||||
1754 | </caption> | ||||
1755 | </mediaobject> | ||||
1756 | </screenshot> | ||||
1757 | </para> | ||||
1758 | | ||||
1759 | <para> </para> <!-- add more white space after screenshot @dcb --> | ||||
1760 | | ||||
1761 | <variablelist> | ||||
1762 | | ||||
1763 | <varlistentry> | ||||
1764 | <term><menuchoice><guimenu><inlinemediaobject><imageobject><imagedata fileref="folder-new.png" | ||||
1765 | format="PNG"/></imageobject></inlinemediaobject>Add Address Book Folder...</guimenu></menuchoice></term> | ||||
1766 | <listitem><para>This context menu option does not perform a useful function in release 5.10.3.</para></listitem> | ||||
1767 | </varlistentry> | ||||
1768 | | ||||
1769 | <varlistentry> | ||||
1770 | <term><menuchoice><guimenu><inlinemediaobject><imageobject><imagedata fileref="edit-delete.png" | ||||
1771 | format="PNG"/></imageobject></inlinemediaobject>Delete Address Book Folder</guimenu></menuchoice></term> | ||||
1772 | <listitem><para>This context menu option does not perform a useful function in release 5.10.3.</para></listitem> | ||||
1773 | </varlistentry> | ||||
1774 | | ||||
1775 | <varlistentry> | ||||
1776 | <term><menuchoice><guimenu><inlinemediaobject><imageobject><imagedata fileref="folder-new.png" | ||||
1777 | format="PNG"/></imageobject></inlinemediaobject>Add Address Book...</guimenu></menuchoice></term> | ||||
1778 | <listitem><para>This context menu option launches the <quote>Add Address Book</quote> dialog that is | ||||
1779 | documented in <link linkend="how-to-add-a-new-address-book">chapter 2</link>, above.</para></listitem> | ||||
1780 | </varlistentry> | ||||
1781 | | ||||
1782 | <varlistentry> | ||||
1783 | <term><menuchoice><guimenu><inlinemediaobject><imageobject><imagedata fileref="edit-delete.png" | ||||
1784 | format="PNG"/></imageobject></inlinemediaobject>Delete Address Book</guimenu></menuchoice></term> | ||||
1785 | <listitem><para>Choosing this context menu option will delete the selected address book. | ||||
1786 | Be careful!</para></listitem> | ||||
1787 | </varlistentry> | ||||
1788 | | ||||
1789 | <varlistentry> | ||||
1790 | <term><menuchoice><shortcut><keycombo action="press"><keycap>F5</keycap></keycombo></shortcut><guimenu><inlinemediaobject> | ||||
1791 | <imageobject><imagedata fileref="view-refresh.png" format="PNG"/></imageobject></inlinemediaobject>Update Address Book | ||||
1792 | Folder</guimenu></menuchoice></term> | ||||
1793 | <listitem><para>This context menu option forces &kaddressbook; to reload the contact | ||||
1794 | data associated with the selected address book.</para></listitem> | ||||
1795 | </varlistentry> | ||||
1796 | | ||||
1797 | <varlistentry> | ||||
1798 | <term><menuchoice><guimenu><inlinemediaobject><imageobject><imagedata fileref="configure.png" | ||||
1799 | format="PNG"/></imageobject></inlinemediaobject>Folder Properties...</guimenu></menuchoice></term> | ||||
1800 | <listitem><para>This context menu option displays summary information about the selected | ||||
1801 | address book.</para></listitem> | ||||
1802 | </varlistentry> | ||||
1803 | | ||||
1804 | <varlistentry> | ||||
1805 | <term><menuchoice><guimenu><inlinemediaobject><imageobject><imagedata fileref="configure.png" | ||||
1806 | format="PNG"/></imageobject></inlinemediaobject>Address Book Properties...</guimenu></menuchoice></term> | ||||
1807 | <listitem><para>This context menu option displays summary information about the selected | ||||
1808 | address book.</para></listitem> | ||||
1809 | </varlistentry> | ||||
1810 | | ||||
1811 | <varlistentry> | ||||
1812 | <term><menuchoice><guimenu><inlinemediaobject><imageobject><imagedata fileref="document-open.png" | ||||
1813 | format="PNG"/></imageobject></inlinemediaobject>Serverside Subscription...</guimenu></menuchoice></term> | ||||
1814 | <listitem><para>This context menu option may or may not perform a useful function in release 5.10.3; so | ||||
1815 | far as I can tell, it is permanently grayed out. If you understand what it does, please let me know | ||||
1816 | (davidbryant AT gvtc.com).</para></listitem> | ||||
1817 | </varlistentry> | ||||
1818 | | ||||
1819 | </variablelist> | ||||
1820 | | ||||
1821 | <para> </para> <!-- add more white space between sections @dcb --> | ||||
1822 | | ||||
1823 | </sect2> | ||||
1824 | | ||||
1825 | <sect2 id="the-contactslist-panel"> | ||||
1826 | <title>The List of Contacts Context Menu</title> | ||||
1827 | | ||||
1828 | <para> | ||||
1829 | <screenshot id="contactlist-context-menu"> | ||||
1830 | <screeninfo>A screenshot of &kaddressbook;'s <quote>Contact List</quote> context menu.</screeninfo> | ||||
1831 | <mediaobject> | ||||
1832 | <imageobject> | ||||
1833 | <imagedata fileref="addressbook94.png" format="PNG"/> | ||||
1834 | </imageobject> | ||||
1835 | <textobject> | ||||
1836 | <phrase>A screenshot of &kaddressbook;'s <quote>Contact List</quote> context menu.</phrase> | ||||
1837 | </textobject> | ||||
1838 | <caption> | ||||
1839 | <para>&kaddressbook;'s <quote>Contact List</quote> context menu.</para> | ||||
1840 | </caption> | ||||
1841 | </mediaobject> | ||||
1842 | </screenshot> | ||||
1843 | </para> | ||||
1844 | | ||||
1845 | <para> </para> <!-- add more white space after screenshot @dcb --> | ||||
1846 | | ||||
1847 | <variablelist> | ||||
1848 | | ||||
1849 | <varlistentry> | ||||
1850 | <term><menuchoice><shortcut><keycombo action="simul">&Ctrl;<keycap>N</keycap></keycombo></shortcut> | ||||
1851 | <guimenu><inlinemediaobject><imageobject><imagedata fileref="list-add.png" format="PNG"/> | ||||
1852 | </imageobject></inlinemediaobject>New Contact</guimenu></menuchoice></term> | ||||
1853 | <listitem><para>Choosing this context menu option has exactly the same effect as clicking the | ||||
1854 | <guibutton> + New Contact </guibutton> button on the Toolbar. See <link | ||||
1855 | linkend="how-to-add-a-new-contact">chapter 2 above</link> for complete details.</para></listitem> | ||||
1856 | </varlistentry> | ||||
1857 | | ||||
1858 | <varlistentry> | ||||
1859 | <term><menuchoice><shortcut><keycombo action="simul">&Ctrl;<keycap>G</keycap></keycombo></shortcut> | ||||
1860 | <guimenu><inlinemediaobject><imageobject><imagedata fileref="user-group-new.png" format="PNG"/> | ||||
1861 | </imageobject></inlinemediaobject>New Group</guimenu></menuchoice></term> | ||||
1862 | <listitem><para>Choosing this context menu option opens a dialog in which you may define a new group, or mailing | ||||
1863 | list. See <link linkend="file-new-group">the appendix</link> for a detailed explanation.</para></listitem> | ||||
1864 | </varlistentry> | ||||
1865 | | ||||
1866 | <varlistentry> | ||||
1867 | <term><menuchoice><guimenu><inlinemediaobject><imageobject><imagedata fileref="document-edit.png" format="PNG"/> | ||||
1868 | </imageobject></inlinemediaobject>Edit Contact ...</guimenu></menuchoice></term> | ||||
1869 | <listitem><para>Choosing this context menu option has exactly the same effect as clicking the <guibutton><inlinemediaobject> | ||||
1870 | <imageobject><imagedata fileref="document-edit.png" format="PNG"/></imageobject></inlinemediaobject>Edit Contact...</guibutton> button | ||||
1871 | on the Toolbar. See <link linkend="how-to-add-a-new-contact">chapter 2 above</link> for complete details.</para></listitem> | ||||
1872 | </varlistentry> | ||||
1873 | | ||||
1874 | <varlistentry> | ||||
1875 | <term><menuchoice><guimenu>Export ></guimenu></menuchoice></term> | ||||
1876 | <listitem><para>This context menu function allows you to export selected contact data in either <acronym>vCard</acronym> or | ||||
1877 | <acronym>csv</acronym> format.</para></listitem> | ||||
1878 | </varlistentry> | ||||
1879 | | ||||
1880 | <varlistentry> | ||||
1881 | <term><menuchoice><guimenu><inlinemediaobject><imageobject><imagedata fileref="edit-copy.png" format="PNG"/></imageobject> | ||||
1882 | </inlinemediaobject>Copy Contact To ></guimenu></menuchoice></term> | ||||
1883 | <listitem><para>This context menu choice lets you copy the selected contact(s) to a variable destination. The list of | ||||
1884 | destinations displayed when this option is chosen depends on how many address books you have created.</para></listitem> | ||||
1885 | </varlistentry> | ||||
1886 | | ||||
1887 | <varlistentry> | ||||
1888 | <term><menuchoice><guimenu><inlinemediaobject><imageobject><imagedata fileref="go-jump.png" format="PNG"/></imageobject> | ||||
1889 | </inlinemediaobject>Move Contact To ></guimenu></menuchoice></term> | ||||
1890 | <listitem><para>Works just like the <quote>Copy Contact To</quote> operation described above, except that it deletes | ||||
1891 | the source data, instead of creating an extra copy of it.</para></listitem> | ||||
1892 | </varlistentry> | ||||
1893 | | ||||
1894 | <varlistentry> | ||||
1895 | <term><menuchoice><shortcut><keycombo action="simul">&Ctrl;<keycap>P</keycap></keycombo></shortcut><guimenu><inlinemediaobject> | ||||
1896 | <imageobject><imagedata fileref="document-print.png" format="PNG"/></imageobject></inlinemediaobject>Print</guimenu></menuchoice></term> | ||||
1897 | <listitem><para>Choosing this context menu item opens a printer selection dialog. Use the <menuchoice><guisubmenu><inlinemediaobject> | ||||
1898 | <imageobject><imagedata fileref="document-preview-archive.png" format="PNG"/></imageobject></inlinemediaobject>Print Preview</guisubmenu> | ||||
1899 | </menuchoice> dialog below to set up the range of names and the print format before you select this function.</para></listitem> | ||||
1900 | </varlistentry> | ||||
1901 | | ||||
1902 | <varlistentry> | ||||
1903 | <term><menuchoice><guimenu><inlinemediaobject><imageobject><imagedata fileref="document-preview-archive.png" format="PNG"/> | ||||
1904 | </imageobject></inlinemediaobject>Print Preview</guimenu></menuchoice></term> | ||||
1905 | <listitem><para>This context menu option opens a print preview dialog, which also permits you to format the report, select which items to | ||||
1906 | include, and specify a sort order, etc. See <link linkend="file-print-preview">the appendix</link> for further details.</para></listitem> | ||||
1907 | </varlistentry> | ||||
1908 | | ||||
1909 | <varlistentry> | ||||
1910 | <term><menuchoice><shortcut><keycombo action="press">∇</keycombo></shortcut><guimenu><inlinemediaobject><imageobject><imagedata | ||||
1911 | fileref="edit-delete.png" format="PNG"/></imageobject></inlinemediaobject>Delete Contact</guimenu></menuchoice></term> | ||||
1912 | <listitem><para>Delete the selected contact(s) from the current address book.</para></listitem> | ||||
1913 | </varlistentry> | ||||
1914 | | ||||
1915 | </variablelist> | ||||
1916 | | ||||
1917 | <para> </para> <!-- add more white space between sections @dcb --> | ||||
1918 | | ||||
1919 | </sect2> | ||||
1920 | | ||||
1921 | <sect2 id="the-individualcontact-panel"> | ||||
1922 | <title>The Individual Contact Context Menu</title> | ||||
1923 | | ||||
1924 | <para> | ||||
1925 | <screenshot id="individualcontact-context-menu"> | ||||
1926 | <screeninfo>A screenshot of &kaddressbook;'s <quote>Individual Contact</quote> context menu.</screeninfo> | ||||
1927 | <mediaobject> | ||||
1928 | <imageobject> | ||||
1929 | <imagedata fileref="addressbook95.png" format="PNG"/> | ||||
1930 | </imageobject> | ||||
1931 | <textobject> | ||||
1932 | <phrase>A screenshot of &kaddressbook;'s <quote>Individual Contact</quote> context menu.</phrase> | ||||
1933 | </textobject> | ||||
1934 | <caption> | ||||
1935 | <para>&kaddressbook;'s <quote>Individual Contact</quote> context menu.</para> | ||||
1936 | </caption> | ||||
1937 | </mediaobject> | ||||
1938 | </screenshot> | ||||
1939 | </para> | ||||
1940 | | ||||
1941 | <para> </para> <!-- add more white space after screenshot @dcb --> | ||||
1942 | | ||||
1943 | <para>Depending on which data item you select, the caption in this context menu may vary. But in | ||||
1944 | every case, the function is the same: the selected data item is copied to the clipboard.</para> | ||||
1945 | | ||||
1946 | </sect2> | ||||
1947 | | ||||
1948 | </sect1> | ||||
1949 | | ||||
1950 | </chapter> | ||||
1951 | | ||||
1952 | <glossary> | ||||
1953 | | ||||
1954 | <!-- Note to proofreaders: I'm still building the glossary. @dcb2019223 --> | ||||
1955 | | ||||
1956 | <glossentry id="gloss-aim"> | ||||
1957 | <glossterm><acronym>AIM</acronym></glossterm> | ||||
1958 | <glossdef><para><acronym>AIM</acronym> stands for America Online Instant Messaging. AIM was an early leader in | ||||
1959 | the competitive IM marketplace, but fell into disfavor as AOL itself became less popular. The original service | ||||
1960 | was discontinued in 2017, but fans have kept it running <ulink url="http://iwarg.ddns.net/aim/">at this | ||||
1961 | web site</ulink>.</para></glossdef> | ||||
1962 | </glossentry> | ||||
1963 | | ||||
1964 | <glossentry id="gloss-akonadi"> | ||||
1965 | <glossterm>&akonadi;</glossterm> | ||||
1966 | <glossdef><para>An extensible cross-desktop storage service for PIM data and meta data providing | ||||
1967 | concurrent read, write, and query access. &akonadi; can be manipulated with the akonadictl | ||||
1968 | command: enter <quote>akonadictl --help</quote> in a console window to learn more.</para></glossdef> | ||||
1969 | </glossentry> | ||||
1970 | | ||||
1971 | <glossentry id="gloss-cloud"> | ||||
1972 | <glossterm>Cloud-based service</glossterm> | ||||
1973 | <glossdef><para>Any provider of data storage and data processing resources residing in some | ||||
1974 | <quote>cloud</quote> of servers one may access via the internet.</para></glossdef> | ||||
1975 | </glossentry> | ||||
1976 | | ||||
1977 | <glossentry id="gloss-csv"> | ||||
1978 | <glossterm>.csv</glossterm> | ||||
1979 | <glossdef><para>A Comma Separated Values (or <filename class="extension">.csv</filename>) file is a | ||||
1980 | plain text document in which each line, or record, is divided into fields by a specific separator character, | ||||
1981 | usually a comma. The <filename class="extension">.csv</filename> format dates back to the early days | ||||
1982 | of computing. It is still widely used, mainly because it is conceptually so simple.</para></glossdef> | ||||
1983 | </glossentry> | ||||
1984 | | ||||
1985 | <glossentry id="gloss-dav"> | ||||
1986 | <glossterm><acronym>DAV</acronym></glossterm> | ||||
1987 | <glossdef><para><acronym>DAV</acronym> stands for Distributed Authoring and Versioning, which exists in | ||||
1988 | several <quote>flavors</quote>, such as WebDAV (for creating pages on the internet), GroupDAV (for groupware, | ||||
1989 | open source software authored by a group of collaborators), and CalDAV (calendar management for groups), | ||||
1990 | each one of which helps connect open source clients with open source servers.</para></glossdef> | ||||
1991 | </glossentry> | ||||
1992 | | ||||
1993 | <glossentry id="gloss-digest"> | ||||
1994 | <glossterm><acronym>DIGEST-MD5</acronym></glossterm> | ||||
1995 | <glossdef><para><acronym>DIGEST-MD5</acronym> is an authentication technique used to set up secure communications | ||||
1996 | between a client and an internet service. It gets its name from the MD5 hashing function used to encode the client's | ||||
1997 | credentials. See <ulink url="https://en.wikipedia.org/wiki/Digest_access_authentication">this Wikipedia article</ulink> | ||||
1998 | to learn more about it.</para></glossdef> | ||||
1999 | </glossentry> | ||||
2000 | | ||||
2001 | <glossentry id="gloss-ews"> | ||||
2002 | <glossterm><acronym>EWS</acronym></glossterm> | ||||
2003 | <glossdef><para><acronym>EWS</acronym> stands for Exchange Web Services, &Microsoft;'s set of | ||||
2004 | proprietary protocols for exchanging personal data between internet servers and end users, or clients. | ||||
2005 | <glossterm linkend="gloss-kolab">Kolab</glossterm> provides similar functionality.</para></glossdef> | ||||
2006 | </glossentry> | ||||
2007 | | ||||
2008 | <glossentry id="gloss-gadu-gadu"> | ||||
2009 | <glossterm>Gadu-Gadu</glossterm> | ||||
2010 | <glossdef><para>Gadu-Gadu (aka GG) is the most popular instant-messaging app in Poland.</para></glossdef> | ||||
2011 | </glossentry> | ||||
2012 | | ||||
2013 | <glossentry id="gloss-gmx"> | ||||
2014 | <glossterm><acronym>GMX</acronym></glossterm> | ||||
2015 | <glossdef><para><acronym>GMX</acronym> stands for Global Mail eXchange (or, in Germany, Global Message eXchange), | ||||
2016 | a free advertising-supported email service. Visit either <ulink url="https://www.gmx.net/">this web site</ulink> | ||||
2017 | or <ulink url="https://www.gmx.com/">this one</ulink> to learn more about it.</para></glossdef> | ||||
2018 | </glossentry> | ||||
2019 | | ||||
2020 | <glossentry id="gloss-gravatar"> | ||||
2021 | <glossterm>Gravatar</glossterm> | ||||
2022 | <glossdef><para>A Gravatar, or Globally Recognized Avatar, is a graphic image associated with a WordPress | ||||
2023 | user's email address. It is usually displayed as an 80px X 80px graphic image. Since many bloggers use | ||||
2024 | WordPress software, the Gravatar is widely available.</para></glossdef> | ||||
2025 | </glossentry> | ||||
2026 | | ||||
2027 | <glossentry id="gloss-gpws"> | ||||
2028 | <glossterm>GroupWise</glossterm> | ||||
2029 | <glossdef><para>GroupWise Messenger is an instant messaging service sponsored by Micro Focus International | ||||
2030 | plc, a software company located in Newbury, Berkshire, England. You can get a copy of the Messenger software | ||||
2031 | from <ulink url="https://mail.dcbe.org:8300/">this web site</ulink>.</para></glossdef> | ||||
2032 | </glossentry> | ||||
2033 | | ||||
2034 | <glossentry id="gloss-gssapi"> | ||||
2035 | <glossterm><acronym>GSSAPI</acronym></glossterm> | ||||
2036 | <glossdef><para><acronym>GSSAPI</acronym> stands for Generic Security Service Application Program Interface, | ||||
2037 | a sort of <quote>dictionary</quote> for the many security protocols in use on the internet. It consists of a | ||||
2038 | program library and a set of standard subroutine calls that allow an internet client to determine which particular | ||||
2039 | security protocol an internet service is using, and then to encode/decode the user's credentials appropriately.</para></glossdef> | ||||
2040 | </glossentry> | ||||
2041 | | ||||
2042 | <glossentry id="gloss-icq"> | ||||
2043 | <glossterm><acronym>ICQ</acronym></glossterm> | ||||
2044 | <glossdef><para><acronym>ICQ</acronym> is not precisely an acronym: it's a pun meant to sound like <quote>I | ||||
2045 | Seek You</quote>. It is one of the original IM platforms, first coming online in 1996. The software is available | ||||
2046 | for download <ulink url="https://icq.com/linux/en">here</ulink>.</para></glossdef> | ||||
2047 | </glossentry> | ||||
2048 | | ||||
2049 | <glossentry id="gloss-imap"> | ||||
2050 | <glossterm>&IMAP;</glossterm> | ||||
2051 | <glossdef><para><acronym>IMAP</acronym> stands for Internet Message Access Protocol, a widely | ||||
2052 | available method for managing email messages. IMAP maintains and synchronizes local and remote | ||||
2053 | copies of a set of messages -- in other words, the locally stored data for an IMAP account are | ||||
2054 | a mirror image of the messages on the server.</para></glossdef> | ||||
2055 | </glossentry> | ||||
2056 | | ||||
2057 | <glossentry id="gloss-inline-pgp"> | ||||
2058 | <glossterm>Inline OpenPGP</glossterm> | ||||
2059 | <glossdef><para>Inline OpenPGP is an encryption protocol in which PGP signatures are directly | ||||
2060 | embedded in the body of the email message. This protocol is deprecated because of technical | ||||
2061 | difficulties caused by the indiscriminate use of non-ASCII characters in plain-text email | ||||
2062 | messages.</para></glossdef> | ||||
2063 | </glossentry> | ||||
2064 | | ||||
2065 | <glossentry id="gloss-irc"> | ||||
2066 | <glossterm><acronym>IRC</acronym></glossterm> | ||||
2067 | <glossdef><para><acronym>IRC</acronym> stands for Internet Relay Chat, an IM service that has its | ||||
2068 | roots in a Finnish predecessor of the World Wide Web called OuluBox (1988). <acronym>IRC</acronym> | ||||
2069 | has been losing users steadily for many years as social media platforms like Facebook have become | ||||
2070 | more popular. The largest remaining network is known as Freenode; it can be accessed <ulink | ||||
2071 | url="https://webchat.freenode.net/">via this web site</ulink>.</para></glossdef> | ||||
2072 | </glossentry> | ||||
2073 | | ||||
2074 | <glossentry id="gloss-isdn"> | ||||
2075 | <glossterm><acronym>ISDN</acronym></glossterm> | ||||
2076 | <glossdef><para><acronym>ISDN</acronym> stands for Integrated Services Data Network, the very first set of | ||||
2077 | telecommunication standards that permitted the simultaneous transmission of analog voice signals and digital | ||||
2078 | data signals over a switched network of copper wires (&ie; the old-style telephone system). <acronym>ISDN</acronym> | ||||
2079 | was unavoidable in the early days of the Internet, but has lately been supplanted by more robust technologies | ||||
2080 | that permit unswitched connections over networks that utilize fiber optic cables, satellites, and very high | ||||
2081 | frequency microwave transmitters / receivers. It is still widely used in a few industrial applications where | ||||
2082 | a direct point-to-point connection is necessary, but is on the way out in the broader consumer market.</para></glossdef> | ||||
2083 | </glossentry> | ||||
2084 | | ||||
2085 | <glossentry id="gloss-jabber"> | ||||
2086 | <glossterm>Jabber</glossterm> | ||||
2087 | <glossdef><para>Jabber is an instant-messaging service that relies on the <glossterm linkend="gloss-xmpp"><acronym>XMPP</acronym> | ||||
2088 | </glossterm> protocol. The original <quote>Jabber</quote> web site is no longer accepting new registrations, but the | ||||
2089 | <acronym>XMPP</acronym> protocol is in widespread use. See <ulink url="https://xmpp.org/about/">this web site</ulink> | ||||
2090 | for more information.</para></glossdef> | ||||
2091 | </glossentry> | ||||
2092 | | ||||
2093 | <glossentry id="gloss-kmail"> | ||||
2094 | <glossterm>&kmail;</glossterm> | ||||
2095 | <glossdef><para>&kde;'s email management program. Provides a fully integrated environment | ||||
2096 | for sending and receiving email messages from one (or more) email account(s), maintaining | ||||
2097 | as many email identities as you want to have, organizing and archiving your old email | ||||
2098 | messages, and managing your personal email encryption keys.</para></glossdef> | ||||
2099 | </glossentry> | ||||
2100 | | ||||
2101 | <glossentry id="gloss-kolab"> | ||||
2102 | <glossterm>Kolab</glossterm> | ||||
2103 | <glossdef><para>Kolab Systems AG is a corporation headquartered in Zurich, Switzerland that | ||||
2104 | provides both proprietary and open source software tools to facilitate collaboration among | ||||
2105 | groups of people who share data, messages, and calendaring / scheduling resources via the | ||||
2106 | internet. <glossterm linkend="gloss-ews">EWS</glossterm> provides similar, though | ||||
2107 | wholly proprietary, software packages.</para></glossdef> | ||||
2108 | </glossentry> | ||||
2109 | | ||||
2110 | <glossentry id="gloss-ldap"> | ||||
2111 | <glossterm><acronym>LDAP</acronym></glossterm> | ||||
2112 | <glossdef><para>The Lightweight Directory Access Protocol (or <acronym>ldap</acronym>) is | ||||
2113 | a standard protocol, or method, for sharing some particular classes of information among the | ||||
2114 | many server computers that comprise the internet.</para></glossdef> | ||||
2115 | </glossentry> | ||||
2116 | | ||||
2117 | <glossentry id="gloss-ldif"> | ||||
2118 | <glossterm>.ldif</glossterm> | ||||
2119 | <glossdef><para>An <glossterm linkend="gloss-ldap"><acronym>LDAP</acronym></glossterm> | ||||
2120 | Data Interchange Format (or <filename class="extension">.ldif</filename>) file is a type | ||||
2121 | of plain text file designed for exchanging directory information among the various servers | ||||
2122 | in a distributed network.</para></glossdef> | ||||
2123 | </glossentry> | ||||
2124 | | ||||
2125 | <glossentry id="gloss-mnwhl"> | ||||
2126 | <glossterm>Meanwhile</glossterm> | ||||
2127 | <glossdef><para><quote>Meanwhile</quote> is open source software designed to communicate with IBM's | ||||
2128 | <ulink url="https://en.wikipedia.org/wiki/IBM_Sametime"><quote>Sametime</quote></ulink> instant | ||||
2129 | messaging software. See <ulink url="https://github.com/obriencj/meanwhile">this web site</ulink> | ||||
2130 | if you want to learn more about it.</para></glossdef> | ||||
2131 | </glossentry> | ||||
2132 | | ||||
2133 | <glossentry id="gloss-acro-mime"> | ||||
2134 | <glossterm><acronym>MIME</acronym></glossterm> | ||||
2135 | <glossdef><para><acronym>MIME</acronym> stands for Multipurpose Internet Mail Extensions, | ||||
2136 | a set of coding conventions designed to make email messages more flexible by enabling features | ||||
2137 | like extended character sets, embedded images, <quote>rich text</quote> coding, &etc; The original | ||||
2138 | email coding conventions supported nothing besides plain text (or encrypted) messages written with 7-bit | ||||
2139 | ASCII code. Almost all contemporary email messages are <acronym>MIME</acronym> encoded.</para></glossdef> | ||||
2140 | </glossentry> | ||||
2141 | | ||||
2142 | <glossentry id="gloss-open-pgp"> | ||||
2143 | <glossterm>OpenPGP/<acronym>MIME</acronym></glossterm> | ||||
2144 | <glossdef><para>OpenPGP/<acronym>MIME</acronym> refers to an encryption convention for <glossterm | ||||
2145 | linkend="gloss-acro-mime"><acronym>MIME</acronym></glossterm> encoded email messages. A special set | ||||
2146 | of <acronym>MIME</acronym> headers are wrapped around the PGP signature, allowing an email client | ||||
2147 | program to conceal the signature when the message is displayed.</para></glossdef> | ||||
2148 | </glossentry> | ||||
2149 | | ||||
2150 | <glossentry id="gloss-group"> | ||||
2151 | <glossterm>Open-Xchange Groupware Server</glossterm> | ||||
2152 | <glossdef><para>Open-Xchange AG is a corporation headquartered in Cologne, Germany that | ||||
2153 | provides both proprietary and open source software tools to facilitate collaboration among | ||||
2154 | groups of people who share data, messages, and calendaring / scheduling resources via the | ||||
2155 | internet. <glossterm linkend="gloss-ews">EWS</glossterm> and <glossterm | ||||
2156 | linkend="gloss-kolab">Kolab</glossterm> provide similar software packages.</para></glossdef> | ||||
2157 | </glossentry> | ||||
2158 | | ||||
2159 | <glossentry id="gloss-pcs"> | ||||
2160 | <glossterm><acronym>PCS</acronym></glossterm> | ||||
2161 | <glossdef><para><acronym>PCS</acronym> stands for Personal Communication Service, which is basically | ||||
2162 | a cell phone with some extra functionality built in. <acronym>PCS</acronym> phones operate on a | ||||
2163 | higher frequency band than traditional cell phones, which implies that they can provide more | ||||
2164 | bandwidth than older cell phones.</para></glossdef> | ||||
2165 | </glossentry> | ||||
2166 | | ||||
2167 | <glossentry id="gloss-pgp"> | ||||
2168 | <glossterm><acronym>PGP</acronym></glossterm> | ||||
2169 | <glossdef><para><acronym>PGP</acronym> stands for Pretty Good Privacy, a data-encryption program | ||||
2170 | that was released by Philip Zimmerman in 1991. Most email encryption software in use today employs | ||||
2171 | some variant of PGP to encrypt, decrypt, and cryptographically sign messages.</para></glossdef> | ||||
2172 | </glossentry> | ||||
2173 | | ||||
2174 | <glossentry id="gloss-pim"> | ||||
2175 | <glossterm>&PIM;</glossterm> | ||||
2176 | <glossdef><para>&kde;'s Personal Information Management system, a suite of programs | ||||
2177 | to help you manage your contacts and your schedule. &PIM; includes &kontact;, | ||||
2178 | &kmail;, &kaddressbook;, &korganizer;, &akregator;, and | ||||
2179 | &akonadi;. Also used more generally to describe any system for managing personal | ||||
2180 | information such as names, addresses, telephone numbers, &etc;</para></glossdef> | ||||
2181 | </glossentry> | ||||
2182 | | ||||
2183 | <glossentry id="gloss-qrcode"> | ||||
2184 | <glossterm>QR Code</glossterm> | ||||
2185 | <glossdef><para>QR Code stands for Quick Response Code, a two-dimensional barcode used to represent | ||||
2186 | digital data. It was invented in Japan in 1994 for use by automobile manufacturers, but has | ||||
2187 | spread far and wide, so that it is ubiquitous today.</para></glossdef> | ||||
2188 | </glossentry> | ||||
2189 | | ||||
2190 | <glossentry id="gloss-sasl"> | ||||
2191 | <glossterm><acronym>SASL</acronym></glossterm> | ||||
2192 | <glossdef><para><acronym>SASL</acronym> stands for Simple Authentication and Security Layer, a framework for | ||||
2193 | client authentication (passwords and usernames) and data security (encrypted connections). It supports more than | ||||
2194 | a dozen different protocols.</para></glossdef> | ||||
2195 | </glossentry> | ||||
2196 | | ||||
2197 | <glossentry id="gloss-mime"> | ||||
2198 | <glossterm><acronym>S/MIME</acronym></glossterm> | ||||
2199 | <glossdef><para><acronym>S/MIME</acronym> stands for Secure / Multipurpose Internet Mail Extensions, | ||||
2200 | a standard cryptographic method for signing, encrypting, abd decrypting email messages. Unlike | ||||
2201 | <glossterm linkend="gloss-pgp"><acronym>PGP</acronym></glossterm>, which uses private keys, <acronym>S/MIME</acronym> | ||||
2202 | uses publicly published encryption keys certified by a Certificate Authority, such as <ulink | ||||
2203 | url="https://www.verisign.com/">Verisign</ulink>.</para></glossdef> | ||||
2204 | </glossentry> | ||||
2205 | | ||||
2206 | <glossentry id="gloss-opaque"> | ||||
2207 | <glossterm><acronym>S/MIME</acronym> Opaque</glossterm> | ||||
2208 | <glossdef><para><acronym>S/MIME</acronym> Opaque stands for the <quote>opaque</quote> version of Secure / | ||||
2209 | Multipurpose Internet Mail Extensions. It is is similar to the <quote>S/MIME</quote> format defined above, | ||||
2210 | but the entire contents of the message are rolled up into a single MIME object. (Most MIME encoded | ||||
2211 | email messages consist of two or more separate MIME objects.)</para></glossdef> | ||||
2212 | </glossentry> | ||||
2213 | | ||||
2214 | <glossentry id="gloss-sms"> | ||||
2215 | <glossterm><acronym>SMS</acronym></glossterm> | ||||
2216 | <glossdef><para><acronym>SMS</acronym> stands for Short Message Service, a text-messaging service built into | ||||
2217 | most telephone, internet, and mobile device communication networks. It facilitates the exchange of text | ||||
2218 | messages that are less than 161 bytes long.</para></glossdef> | ||||
2219 | </glossentry> | ||||
2220 | | ||||
2221 | <glossentry id="gloss-ssl"> | ||||
2222 | <glossterm><acronym>SSL</acronym></glossterm> | ||||
2223 | <glossdef><para><acronym>SSL</acronym> stands for Secure Socket Layer, a deprecated cryptographic protocol | ||||
2224 | that has been largely supplanted by <acronym>TLS</acronym>.</para></glossdef> | ||||
2225 | </glossentry> | ||||
2226 | | ||||
2227 | <glossentry id="gloss-tls"> | ||||
2228 | <glossterm><acronym>TLS</acronym></glossterm> | ||||
2229 | <glossdef><para><acronym>TLS</acronym> stands for Transport Layer Security, a cryptographic protocol that is | ||||
2230 | widely used to secure internet communications. Its primary function is to allow a client and a server to exchange | ||||
2231 | enough information securely that they can set up a pair of encryption / decryption keys for use during the | ||||
2232 | rest of the internet session. <acronym>TLS</acronym> is the weakest link in the chain connecting a client program | ||||
2233 | to a secure (encrypted) internet service. It has been the target of several hacking exploits, and it has been | ||||
2234 | revised several times in response to those attacks.</para></glossdef> | ||||
2235 | </glossentry> | ||||
2236 | | ||||
2237 | <glossentry id="gloss-vcf"> | ||||
2238 | <glossterm>.vcf</glossterm> | ||||
2239 | <glossdef><para>The Virtual (business) Card Format (or <filename class="extension">.vcf</filename>) | ||||
2240 | is a keyword-oriented data interchange format that has gone through several iterations (2.0, | ||||
2241 | 2.1, 3.0, &etc;) since its introduction <emphasis>ca.</emphasis> 1990. The most recent | ||||
2242 | version is vCard 4.0.</para></glossdef> | ||||
2243 | </glossentry> | ||||
2244 | | ||||
2245 | <glossentry id="gloss-xmpp"> | ||||
2246 | <glossterm><acronym>XMPP</acronym></glossterm> | ||||
2247 | <glossdef><para><acronym>XMPP</acronym> stands for Extensible Messaging and Presence Protocol, the | ||||
2248 | basic technological underpinning for the <quote>Jabber</quote> instant messaging service.</para></glossdef> | ||||
2249 | </glossentry> | ||||
2250 | | ||||
2251 | </glossary> | ||||
2252 | | ||||
2253 | &docbook-reference; | ||||
2254 | | ||||
2255 | </book> |