Changeset View
Standalone View
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 | | ||||
lueck: please add a line with:
<title>The &kaddressbook; Handbook</title> | |||||
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> | ||||
&CCBYSA4Notice; see https://cgit.kde.org/kdoctools.git/tree/src/template.docbook lueck: &CCBYSA4Notice; see https://cgit.kde.org/kdoctools.git/tree/src/template.docbook | |||||
32 | | ||||
33 | <legalnotice>&CCBYSA4Notice;</legalnotice> | ||||
34 | | ||||
35 | <date>2019-07-20</date> | ||||
Plesase use scheme from https://cgit.kde.org/kdoctools.git/tree/src/template.docbook lueck: Plesase use scheme from https://cgit.kde.org/kdoctools.git/tree/src/template.docbook | |||||
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> | ||||
yurchor: Typo: dats -> data | |||||
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 <filename class="extension"><glossterm linkend="gloss-csv">.csv</glossterm> </filename> | ||||
<filename class="extension">.csv</filename> lueck: <filename class="extension">.csv</filename>
<filename class="extension">.ldif</filename>… | |||||
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> | ||||
lueck: <filename class="extension">.vcf</filename> | |||||
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 | ||||
yurchor: Typo: servicetes -> services | |||||
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 | | ||||
Please add <chapter id="credits">, see lueck: Please add <chapter id="credits">, see
https://cgit.kde.org/kdoctools.git/tree/src/template. | |||||
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> | ||||
KAddressBook -> Help -> About KAddressBook reads: lueck: KAddressBook -> Help -> About KAddressBook reads:
"Copyright © 2007–2019 KAddressBook authors"… | |||||
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> | ||||
lueck: Please remove these lines, it is just a placeholder from the template | |||||
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 | | ||||
yurchor: Typo: maagement -> management | |||||
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-isdn"><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> | ||||
I know that we document everything, regardless whether it works, but isn't MSN Messenger discontinued and ceased to work now? yurchor: I know that we document everything, regardless whether it works, but isn't MSN Messenger… | |||||
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> | ||||
Regretfully, LaTeX (our main core to convert DocBook to PDF) does not play well with SVG. Can this and other SVGs be converted to PNGs with a regular convert utility from ImageMagick? convert file.svg file.png yurchor: Regretfully, LaTeX (our main core to convert DocBook to PDF) does not play well with SVG. Can… | |||||
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>, | ||||
1032 | <glossterm linkend="gloss-open-pgp">OpenPGP/MIME</glossterm>, <glossterm linkend="gloss-mime">S/MIME</glossterm>, | ||||
1033 | or <glossterm linkend="gloss-opaque">S/MIME 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 OpenPGP keys, if you have chosen OpenPGP encryption. Use the <guibutton><inlinemediaobject> | ||||
1038 | <imageobject><imagedata fileref="edit-clear.png" format="PNG"/></imageobject></inlinemediaobject></guibutton> button to clear a | ||||
1039 | previously selected key.</para></listitem> | ||||
1040 | </varlistentry> | ||||
1041 | | ||||
1042 | <varlistentry><term>Preferred S/MIME Encryption Certificate:</term><listitem><para>Use the <guibutton> Change... </guibutton> | ||||
1043 | button to select from a list of available certificates, if you are using a verified key. Use the <guibutton><inlinemediaobject> | ||||
1044 | <imageobject><imagedata fileref="edit-clear.png" format="PNG"/></imageobject></inlinemediaobject></guibutton> button to clear a | ||||
1045 | 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><guimenu>File</guimenu><guisubmenu>New ></guisubmenu><guimenuitem><inlinemediaobject><imageobject> | ||||
1103 | <imagedata fileref="list-add.png" format="PNG"/></imageobject></inlinemediaobject>New Contact</guimenuitem> | ||||
1104 | <shortcut><keycombo action="simul">&Ctrl;<keycap>N</keycap></keycombo></shortcut></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><guimenu>File</guimenu><guisubmenu>New ></guisubmenu><guimenuitem><inlinemediaobject><imageobject> | ||||
1111 | <imagedata fileref="user-group-new.png" format="PNG"/></imageobject></inlinemediaobject>New Group</guimenuitem> | ||||
1112 | <shortcut><keycombo action="simul">&Ctrl;<keycap>G</keycap></keycombo></shortcut></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 <acronym>LDAP</acronym> server ...</guimenuitem></menuchoice></term><shortcut><keycombo action="simul">&Ctrl;<keycap>P</keycap></keycombo></shortcut> | ||||
1126 | <listitem><para>This function allows you to import data from an <acronym>LDAP</acronym> server. The server must be configured before | ||||
1127 | you can use this function. See <link linkend="configure-ldap-server">the appendix</link> for full details.</para></listitem> | ||||
1128 | </varlistentry> | ||||
1129 | | ||||
1130 | <varlistentry> | ||||
1131 | <term><menuchoice><guimenu>File</guimenu><guisubmenu>Import ></guisubmenu><guimenuitem>Import <acronym>CSV</acronym> file ...</guimenuitem></menuchoice></term> | ||||
1132 | <listitem><para>This function allows you to import contact data from a comma separated values (<acronym>csv</acronym>) file. A dialog ensues, in which | ||||
1133 | 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 | ||||
1134 | appendix</link> for a more detailed explanation.</para></listitem> | ||||
1135 | </varlistentry> | ||||
1136 | | ||||
1137 | <varlistentry> | ||||
1138 | <term><menuchoice><guimenu>File</guimenu><guisubmenu>Import ></guisubmenu><guimenuitem>Import <acronym>vCard</acronym> ...</guimenuitem></menuchoice></term> | ||||
1139 | <listitem><para>This function facilitates the importation of <acronym>vcf</acronym>, or vCard, data. All three versions of vCard are supported. | ||||
1140 | You can learn more about the vCard formats <ulink url="https://en.wikipedia.org/wiki/VCard">at this web site</ulink>.</para></listitem> | ||||
1141 | </varlistentry> | ||||
1142 | | ||||
1143 | <varlistentry> | ||||
1144 | <term><menuchoice><guimenu>File</guimenu><guisubmenu>Export ></guisubmenu><guimenuitem>Export <acronym>CSV</acronym> file ...</guimenuitem></menuchoice></term> | ||||
1145 | <listitem><para>This function allows you to export selected contact data as a Comma Separated Values (<acronym>csv</acronym>) file. There are 47 | ||||
1146 | 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> | ||||
1147 | </varlistentry> | ||||
1148 | | ||||
1149 | <varlistentry> | ||||
1150 | <term><menuchoice><guimenu>File</guimenu><guisubmenu>Export ></guisubmenu><guimenuitem>Export <acronym>vCard 4.0</acronym> ...</guimenuitem></menuchoice></term> | ||||
1151 | <listitem><para>This function allows you to export selected contact data as a file in <acronym>vCard 4.0</acronym> format. See | ||||
1152 | <ulink url="https://en.wikipedia.org/wiki/VCard">this Wikipedia article</ulink> for more information.</para></listitem> | ||||
1153 | </varlistentry> | ||||
1154 | | ||||
1155 | <varlistentry> | ||||
1156 | <term><menuchoice><guimenu>File</guimenu><guisubmenu>Export ></guisubmenu><guimenuitem>Export <acronym>vCard 3.0</acronym> ...</guimenuitem></menuchoice></term> | ||||
1157 | <listitem><para>This function allows you to export selected contact data as a file in <acronym>vCard 3.0</acronym> format. This | ||||
1158 | format is similar to <acronym>vCard 4.0</acronym> format.</para></listitem> | ||||
1159 | </varlistentry> | ||||
1160 | | ||||
1161 | <varlistentry> | ||||
1162 | <term><menuchoice><guimenu>File</guimenu><guisubmenu>Export ></guisubmenu><guimenuitem>Export <acronym>vCard 2.1</acronym> ...</guimenuitem></menuchoice></term> | ||||
1163 | <listitem><para>This function allows you to export selected contact data as a file in <acronym>vCard 2.1</acronym> format. This | ||||
1164 | format is similar to <acronym>vCard 3.0</acronym> format.</para></listitem> | ||||
1165 | </varlistentry> | ||||
1166 | | ||||
1167 | <varlistentry> | ||||
1168 | <term><menuchoice><guimenu>File</guimenu><guisubmenu><inlinemediaobject><imageobject><imagedata fileref="document-print.png" format="PNG"/></imageobject> | ||||
1169 | </inlinemediaobject>Print</guisubmenu><shortcut><keycombo action="simul">&Ctrl;<keycap>P</keycap></keycombo></shortcut></menuchoice></term> | ||||
1170 | <listitem><para>Opens a printer selection dialog. Use the <menuchoice><guisubmenu><inlinemediaobject><imageobject> | ||||
1171 | <imagedata fileref="document-preview-archive.png" format="PNG"/></imageobject></inlinemediaobject>Print Preview</guisubmenu></menuchoice> | ||||
1172 | dialog below to set up the range of names and the print format before you select this function.</para></listitem> | ||||
1173 | </varlistentry> | ||||
1174 | | ||||
1175 | <varlistentry> | ||||
1176 | <term><menuchoice><guimenu>File</guimenu><guisubmenu><inlinemediaobject><imageobject><imagedata fileref="document-preview-archive.png" format="PNG"/> | ||||
1177 | </imageobject></inlinemediaobject>Print Preview</guisubmenu></menuchoice></term> | ||||
1178 | <listitem><para>Opens a print preview dialog, which also permits you to format the report, select which items to include, and | ||||
1179 | specify a sort order, etc. See <link linkend="file-print-preview">the appendix</link> for further details.</para></listitem> | ||||
1180 | </varlistentry> | ||||
1181 | | ||||
1182 | <varlistentry><inlinemediaobject><imageobject><imagedata fileref="view-calendar-birthday.png" format="PNG"/></imageobject></inlinemediaobject> | ||||
1183 | <term><menuchoice><guimenu>File</guimenu><guisubmenu><inlinemediaobject><imageobject><imagedata fileref="application-exit.png" format="PNG"/> | ||||
1184 | </imageobject></inlinemediaobject>Quit</guisubmenu><shortcut><keycombo action="simul">&Ctrl;<keycap>Q</keycap></keycombo></shortcut></menuchoice></term> | ||||
1185 | <listitem><para>Closes the &kaddressbook; application.</para></listitem> | ||||
1186 | </varlistentry> | ||||
1187 | | ||||
1188 | </variablelist> | ||||
1189 | | ||||
1190 | </sect2> | ||||
1191 | | ||||
1192 | <para> </para> <!-- add more white space between sections @dcb --> | ||||
1193 | | ||||
1194 | <sect2 id="the-edit-menu"> | ||||
1195 | <title>The Edit Menu</title> | ||||
1196 | | ||||
1197 | <para> | ||||
1198 | <screenshot id="screenshot-edit-menu"> | ||||
1199 | <screeninfo>A screenshot of &kaddressbook;'s <quote>Edit</quote> menu.</screeninfo> | ||||
1200 | <mediaobject> | ||||
1201 | <imageobject> | ||||
1202 | <imagedata fileref="addressbook81.png" format="PNG"/> | ||||
1203 | </imageobject> | ||||
1204 | <textobject> | ||||
1205 | <phrase>A screenshot of &kaddressbook;'s <quote>Edit</quote> menu.</phrase> | ||||
1206 | </textobject> | ||||
1207 | <caption> | ||||
1208 | <para>&kaddressbook;'s <quote>Edit</quote> menu after clicking the | ||||
1209 | <menuchoice><guimenu>Edit</guimenu></menuchoice> button on the Menubar.</para> | ||||
1210 | </caption> | ||||
1211 | </mediaobject> | ||||
1212 | </screenshot> | ||||
1213 | </para> | ||||
1214 | | ||||
1215 | <para> </para> <!-- add more white space after screenshot @dcb --> | ||||
1216 | | ||||
1217 | <para>The <menuchoice><guimenu>Edit</guimenu></menuchoice> menu lets you access eight main functions, two of which have multiple options.</para> | ||||
1218 | | ||||
1219 | <para> </para> <!-- add more white space @dcb --> | ||||
1220 | <variablelist> | ||||
1221 | | ||||
1222 | <varlistentry> | ||||
1223 | <term><menuchoice><guimenu>Edit</guimenu><guisubmenu><inlinemediaobject><imageobject><imagedata fileref="document-edit.png" | ||||
1224 | format="PNG"/></imageobject></inlinemediaobject>Edit Contact ...</guisubmenu></menuchoice></term> | ||||
1225 | <listitem><para>This has nearly the same effect as clicking the <guibutton> + New Contact </guibutton> button | ||||
1226 | on the Toolbar. The difference is that this menu item allows you to edit a contact record that already exists, instead of creating | ||||
1227 | a brand new one. See <link linkend="how-to-add-a-new-contact">chapter 2 above</link> for complete details.</para></listitem> | ||||
1228 | </varlistentry> | ||||
1229 | | ||||
1230 | <varlistentry> | ||||
1231 | <term><menuchoice><guimenu>Edit</guimenu><guisubmenu><inlinemediaobject><imageobject><imagedata fileref="edit-cut.png" format="PNG"/></imageobject> | ||||
1232 | </inlinemediaobject>Cut Contact ...</guisubmenu><shortcut><keycombo action="simul">&Ctrl;<keycap>X</keycap></keycombo></shortcut></menuchoice></term> | ||||
1233 | <listitem><para>Performs a <quote>Cut</quote> operation on the selected contact. A copy of this contact, in | ||||
1234 | <glossterm linkend="gloss-vcf"><acronym>vCard 3.0</acronym></glossterm> format, is placed on the clipboard. The | ||||
1235 | <quote>Cut</quote> will be completed when you <quote>Paste</quote> this contact somewhere.</para></listitem> | ||||
1236 | </varlistentry> | ||||
1237 | | ||||
1238 | <varlistentry> | ||||
1239 | <term><menuchoice><guimenu>Edit</guimenu><guisubmenu><inlinemediaobject><imageobject><imagedata fileref="edit-copy.png" | ||||
1240 | format="PNG"/></imageobject></inlinemediaobject>Copy Contact ...</guisubmenu></menuchoice></term> | ||||
1241 | <listitem><para>Places a copy of this contact on the clipboard, so you can paste it somewhere else.</para></listitem> | ||||
1242 | </varlistentry> | ||||
1243 | | ||||
1244 | <varlistentry> | ||||
1245 | <term><menuchoice><guimenu>Edit</guimenu><guisubmenu><inlinemediaobject><imageobject><imagedata fileref="edit-paste.png" format="PNG"/></imageobject> | ||||
1246 | </inlinemediaobject>Paste</guisubmenu><shortcut><keycombo action="simul">&Ctrl;<keycap>V</keycap></keycombo></shortcut></menuchoice></term> | ||||
1247 | <listitem><para><quote>Pastes</quote> the cut or copied contact at the current location. This may be in the same address book you | ||||
1248 | did the <quote>Cut</quote> or <quote>Copy</quote> from, or in another address book. Since the preceding operations placed | ||||
1249 | the contact information on the system's clipboard, you may also paste it somewhere else besides &kaddressbook; (⪚ into a | ||||
1250 | text editor, or as a <acronym>vCard 3.0</acronym> file in your home folder).</para></listitem> | ||||
1251 | </varlistentry> | ||||
1252 | | ||||
1253 | <varlistentry> | ||||
1254 | <term><menuchoice><guimenu>Edit</guimenu><guisubmenu><inlinemediaobject><imageobject><imagedata fileref="edit-copy.png" format="PNG"/></imageobject> | ||||
1255 | </inlinemediaobject>Copy Contact To ></guisubmenu><guimenuitem>(a variable list)</guimenuitem></menuchoice></term> | ||||
1256 | <listitem><para>Combines the <quote>Copy</quote> and <quote>Paste</quote> operations into a single click of the left | ||||
1257 | mouse button. The list of destinations displayed depends on how many address books you have created.</para></listitem> | ||||
1258 | </varlistentry> | ||||
1259 | | ||||
1260 | <varlistentry> | ||||
1261 | <term><menuchoice><guimenu>Edit</guimenu><guisubmenu><inlinemediaobject><imageobject><imagedata fileref="go-jump.png" format="PNG"/></imageobject> | ||||
1262 | </inlinemediaobject>Move Contact To ></guisubmenu><guimenuitem>(a variable list)</guimenuitem></menuchoice></term> | ||||
1263 | <listitem><para>Works just like the <quote>Copy Contact To</quote> operation described above, except that it combines | ||||
1264 | <quote>Cut</quote> and <quote>Paste</quote> into a single click of the left mouse button.</para></listitem> | ||||
1265 | </varlistentry> | ||||
1266 | | ||||
1267 | <varlistentry> | ||||
1268 | <term><menuchoice><guimenu>Edit</guimenu><guisubmenu><inlinemediaobject><imageobject><imagedata fileref="edit-delete.png" format="PNG"/></imageobject> | ||||
1269 | </inlinemediaobject>Delete Contact</guisubmenu><shortcut><keycombo action="press">∇</keycombo></shortcut></menuchoice></term> | ||||
1270 | <listitem><para>Delete the selected contact from the current address book.</para></listitem> | ||||
1271 | </varlistentry> | ||||
1272 | | ||||
1273 | <varlistentry> | ||||
1274 | <term><menuchoice><guimenu>Edit</guimenu><guisubmenu><inlinemediaobject><imageobject><imagedata fileref="edit-delete.png" | ||||
1275 | format="PNG"/></imageobject></inlinemediaobject>Delete Address Book</guisubmenu></menuchoice></term> | ||||
1276 | <listitem><para>Delete the current address book. Be careful with this command -- you could lose some data! | ||||
1277 | In theory, this function simply removes the symbolic link between &kaddressbook; and the associated <acronym>vCard</acronym> | ||||
1278 | file or directory (or the hyperlink to a <glossterm linkend="gloss-cloud">cloud-based service</glossterm>), and the real data will | ||||
1279 | not be altered. Still, it's probably wisest to make a backup copy of this address book somewhere before you delete it.</para></listitem> | ||||
1280 | </varlistentry> | ||||
1281 | | ||||
1282 | </variablelist> | ||||
1283 | </sect2> | ||||
1284 | | ||||
1285 | <para> </para> <!-- add more white space between sections @dcb --> | ||||
1286 | | ||||
1287 | <sect2 id="the-view-menu"> | ||||
1288 | <title>The View Menu</title> | ||||
1289 | | ||||
1290 | <para> | ||||
1291 | <screenshot id="screenshot-view-menu"> | ||||
1292 | <screeninfo>A screenshot of &kaddressbook;'s <quote>View</quote> menu.</screeninfo> | ||||
1293 | <mediaobject> | ||||
1294 | <imageobject> | ||||
1295 | <imagedata fileref="addressbook82.png" format="PNG"/> | ||||
1296 | </imageobject> | ||||
1297 | <textobject> | ||||
1298 | <phrase>A screenshot of &kaddressbook;'s <quote>View</quote> menu.</phrase> | ||||
1299 | </textobject> | ||||
1300 | <caption> | ||||
1301 | <para>&kaddressbook;'s <quote>View</quote> menu after clicking the | ||||
1302 | <menuchoice><guimenu>View</guimenu></menuchoice> button on the Menubar.</para> | ||||
1303 | </caption> | ||||
1304 | </mediaobject> | ||||
1305 | </screenshot> | ||||
1306 | </para> | ||||
1307 | | ||||
1308 | <para> </para> <!-- add more white space after screenshot @dcb --> | ||||
1309 | | ||||
1310 | <para>The <menuchoice><guimenu>View</guimenu></menuchoice> menu lets you access four main functions, and one experimental | ||||
1311 | feature which doesn't really do anything yet.</para> | ||||
1312 | | ||||
1313 | <para> </para> <!-- add more white space @dcb --> | ||||
1314 | <variablelist> | ||||
1315 | | ||||
1316 | <varlistentry> | ||||
1317 | <term><menuchoice><guimenu>View</guimenu><guisubmenu>Themes ></guisubmenu></menuchoice></term> | ||||
1318 | <listitem><para>This menu item doesn't really do anything. It will open a <quote>Themes</quote> dialog, | ||||
1319 | but that dialog is broken in release 5.10.3.</para></listitem> | ||||
1320 | </varlistentry> | ||||
1321 | | ||||
1322 | <varlistentry> | ||||
1323 | <term><menuchoice><guimenu>View</guimenu><guisubmenu><inlinemediaobject><imageobject><imagedata fileref="draw-circle.png" | ||||
1324 | format="PNG"/></imageobject></inlinemediaobject>Simple (one column)</guisubmenu></menuchoice> (<shortcut><keycombo | ||||
1325 | action="simul">&Ctrl;&Shift;<keycap>1</keycap></keycombo></shortcut>)</term> | ||||
1326 | <listitem><para>Changes the default three panel layout into a single column. For more details, see | ||||
1327 | <link linkend="view-change-columns">the appendix</link>.</para></listitem> | ||||
1328 | </varlistentry> | ||||
1329 | | ||||
1330 | <varlistentry> | ||||
1331 | <term><menuchoice><guimenu>View</guimenu><guisubmenu><inlinemediaobject><imageobject><imagedata fileref="draw-circle.png" | ||||
1332 | format="PNG"/></imageobject></inlinemediaobject>Two columns</guisubmenu></menuchoice> (<shortcut><keycombo | ||||
1333 | action="simul">&Ctrl;&Shift;<keycap>2</keycap></keycombo></shortcut>)</term> | ||||
1334 | <listitem><para>Changes the default three panel layout into two panels. For more details, see | ||||
1335 | <link linkend="view-change-columns">the appendix</link>.</para></listitem> | ||||
1336 | </varlistentry> | ||||
1337 | | ||||
1338 | <varlistentry> | ||||
1339 | <term><menuchoice><guimenu>View</guimenu><guisubmenu><inlinemediaobject><imageobject><imagedata fileref="draw-circle.png" | ||||
1340 | format="PNG"/></imageobject></inlinemediaobject>Three columns</guisubmenu></menuchoice> (<shortcut><keycombo | ||||
1341 | action="simul">&Ctrl;&Shift;<keycap>3</keycap></keycombo></shortcut>)</term> | ||||
1342 | <listitem><para>Switches back to the default three panel layout.</para></listitem> | ||||
1343 | </varlistentry> | ||||
1344 | | ||||
1345 | <varlistentry> | ||||
1346 | <term><menuchoice><guimenu>View</guimenu><guisubmenu><inlinemediaobject><imageobject><imagedata fileref="draw-rectangle.png" | ||||
1347 | format="PNG"/></imageobject></inlinemediaobject>Show QR Codes</guisubmenu></menuchoice></term> | ||||
1348 | <listitem><para>Check this box to display contact information as a QR code. Uncheck it to suppress QR codes.</para></listitem> | ||||
1349 | </varlistentry> | ||||
1350 | | ||||
1351 | </variablelist> | ||||
1352 | | ||||
1353 | </sect2> | ||||
1354 | | ||||
1355 | <para> </para> <!-- add more white space between sections @dcb --> | ||||
1356 | | ||||
1357 | <sect2 id="the-action-menu"> | ||||
1358 | <title>The Action Menu</title> | ||||
1359 | | ||||
1360 | <para> | ||||
1361 | <screenshot id="screenshot-action-menu"> | ||||
1362 | <screeninfo>A screenshot of &kaddressbook;'s <quote>Action</quote> menu.</screeninfo> | ||||
1363 | <mediaobject> | ||||
1364 | <imageobject> | ||||
1365 | <imagedata fileref="addressbook83.png" format="PNG"/> | ||||
1366 | </imageobject> | ||||
1367 | <textobject> | ||||
1368 | <phrase>A screenshot of &kaddressbook;'s <quote>Action</quote> menu.</phrase> | ||||
1369 | </textobject> | ||||
1370 | <caption> | ||||
1371 | <para>&kaddressbook;'s <quote>Action</quote> menu after clicking the | ||||
1372 | <menuchoice><guimenu>Action</guimenu></menuchoice> button on the Menubar.</para> | ||||
1373 | </caption> | ||||
1374 | </mediaobject> | ||||
1375 | </screenshot> | ||||
1376 | </para> | ||||
1377 | | ||||
1378 | <para> </para> <!-- add more white space after screenshot @dcb --> | ||||
1379 | | ||||
1380 | <para>The <menuchoice><guimenu>Action</guimenu></menuchoice> menu lets you access two data transmission functions.</para> | ||||
1381 | | ||||
1382 | <para> </para> <!-- add more white space @dcb --> | ||||
1383 | <variablelist> | ||||
1384 | | ||||
1385 | <varlistentry> | ||||
1386 | <term><menuchoice><guimenu>Action</guimenu><guisubmenu><inlinemediaobject><imageobject><imagedata fileref="mail-message-new.png" | ||||
1387 | format="PNG"/></imageobject></inlinemediaobject>Send vCards...</guisubmenu></menuchoice></term> | ||||
1388 | <listitem><para>This option is similar to <quote>Send an email...</quote>, below, except that after | ||||
1389 | you select some contacts with &Ctrl; and your mouse, the message composition window will open with a | ||||
1390 | blank list of addressees, and with files attached (the selected contacts, in vCard 3.0 format). This | ||||
1391 | makes it easy to share selected &kaddressbook; information with your friends and business associates.</para></listitem> | ||||
1392 | </varlistentry> | ||||
1393 | | ||||
1394 | <varlistentry> | ||||
1395 | <term><menuchoice><guimenu>Action</guimenu><guisubmenu><inlinemediaobject><imageobject><imagedata fileref="mail-message-new.png" | ||||
1396 | format="PNG"/></imageobject></inlinemediaobject>Send an email...</guisubmenu></menuchoice></term> | ||||
1397 | <listitem><para>This option provides an alternate method for setting a new email message's recipient list. | ||||
1398 | Press &Ctrl; (or &Shift;) and select the people to whom you wish to send the new message, by using your left | ||||
1399 | mouse button. Then click on <quote>Send an Email...</quote>; this will open a &kmail; composition window. All | ||||
1400 | the selected contacts will be listed as <quote>To</quote> addressees.</para></listitem> | ||||
1401 | </varlistentry> | ||||
1402 | | ||||
1403 | </variablelist> | ||||
1404 | | ||||
1405 | </sect2> | ||||
1406 | | ||||
1407 | <para> </para> <!-- add more white space between sections @dcb --> | ||||
1408 | | ||||
1409 | <sect2 id="the-tools-menu"> | ||||
1410 | <title>The Tools Menu</title> | ||||
1411 | | ||||
1412 | <para> | ||||
1413 | <screenshot id="screenshot-tools-menu"> | ||||
1414 | <screeninfo>A screenshot of &kaddressbook;'s <quote>Tools</quote> menu.</screeninfo> | ||||
1415 | <mediaobject> | ||||
1416 | <imageobject> | ||||
1417 | <imagedata fileref="addressbook84.png" format="PNG"/> | ||||
1418 | </imageobject> | ||||
1419 | <textobject> | ||||
1420 | <phrase>A screenshot of &kaddressbook;'s <quote>Tools</quote> menu.</phrase> | ||||
1421 | </textobject> | ||||
1422 | <caption> | ||||
1423 | <para>&kaddressbook;'s <quote>Tools</quote> menu after clicking the | ||||
1424 | <menuchoice><guimenu>Tools</guimenu></menuchoice> button on the Menubar.</para> | ||||
1425 | </caption> | ||||
1426 | </mediaobject> | ||||
1427 | </screenshot> | ||||
1428 | </para> | ||||
1429 | | ||||
1430 | <para> </para> <!-- add more white space after screenshot @dcb --> | ||||
1431 | | ||||
1432 | <para>The <menuchoice><guimenu>Tools</guimenu></menuchoice> menu lets you access two data management functions.</para> | ||||
1433 | | ||||
1434 | <para> </para> <!-- add more white space @dcb --> | ||||
1435 | <variablelist> | ||||
1436 | | ||||
1437 | <varlistentry> | ||||
1438 | <term><menuchoice><guimenu>Tools</guimenu><guisubmenu>Merge Contacts...</guisubmenu></menuchoice></term> | ||||
1439 | <listitem><para>This tool allows you to merge the contents of two or more &kaddressbook; records. To activate it, | ||||
1440 | you must first select two or more contacts (hold &Ctrl; or &Shift; and left-click contacts to make your selection). | ||||
1441 | A dialog box will appear, asking you to verify which contacts you wish to combine, and where the merged record | ||||
1442 | should be saved. Click <quote>merge</quote> to complete the operation.</para></listitem> | ||||
1443 | </varlistentry> | ||||
1444 | | ||||
1445 | <varlistentry> | ||||
1446 | <term><menuchoice><guimenu>Tools</guimenu><guisubmenu>Search Duplicate Contacts...</guisubmenu></menuchoice></term> | ||||
1447 | <listitem><para>This tool will search one or more address books for duplicate entries, and offer you the option | ||||
1448 | of merging any duplicate records it finds.</para></listitem> | ||||
1449 | </varlistentry> | ||||
1450 | </variablelist> | ||||
1451 | | ||||
1452 | </sect2> | ||||
1453 | | ||||
1454 | <para> </para> <!-- add more white space between sections @dcb --> | ||||
1455 | | ||||
1456 | <sect2 id="the-settings-menu"> | ||||
1457 | <title>The Settings Menu</title> | ||||
1458 | | ||||
1459 | <para> | ||||
1460 | <screenshot id="screenshot-settings-menu"> | ||||
1461 | <screeninfo>A screenshot of &kaddressbook;'s <quote>Settings</quote> menu.</screeninfo> | ||||
1462 | <mediaobject> | ||||
1463 | <imageobject> | ||||
1464 | <imagedata fileref="addressbook85.png" format="PNG"/> | ||||
1465 | </imageobject> | ||||
1466 | <textobject> | ||||
1467 | <phrase>A screenshot of &kaddressbook;'s <quote>Settings</quote> menu.</phrase> | ||||
1468 | </textobject> | ||||
1469 | <caption> | ||||
1470 | <para>&kaddressbook;'s <quote>Settings</quote> menu after clicking the | ||||
1471 | <menuchoice><guimenu>Settings</guimenu></menuchoice> button on the Menubar.</para> | ||||
1472 | </caption> | ||||
1473 | </mediaobject> | ||||
1474 | </screenshot> | ||||
1475 | </para> | ||||
1476 | | ||||
1477 | <para> </para> <!-- add more white space after screenshot @dcb --> | ||||
1478 | | ||||
1479 | <para>The <menuchoice><guimenu>Settings</guimenu></menuchoice> menu offers you five options for fine-tuning the | ||||
1480 | way &kaddressbook; operates.</para> | ||||
1481 | | ||||
1482 | <para> </para> <!-- add more white space @dcb --> | ||||
1483 | <variablelist> | ||||
1484 | | ||||
1485 | <varlistentry> | ||||
1486 | <term><menuchoice><guimenu>Settings</guimenu><guisubmenu><inlinemediaobject><imageobject><imagedata fileref="draw-rectangle.png" | ||||
1487 | format="PNG"/></imageobject></inlinemediaobject><inlinemediaobject><imageobject><imagedata fileref="show-menu.png" | ||||
1488 | format="PNG"/></imageobject></inlinemediaobject>Show Menubar</guisubmenu></menuchoice> | ||||
1489 | <keycombo action="simul">&Ctrl;<keycap>M</keycap></keycombo></term> | ||||
1490 | <listitem><para>This option allows you to show or hide the Menubar.</para></listitem> | ||||
1491 | </varlistentry> | ||||
1492 | | ||||
1493 | <varlistentry> | ||||
1494 | <term><menuchoice><guimenu>Settings</guimenu><guisubmenu><inlinemediaobject><imageobject><imagedata fileref="draw-rectangle.png" | ||||
1495 | format="PNG"/></imageobject></inlinemediaobject>Show Toolbar</guisubmenu></menuchoice></term> | ||||
1496 | <listitem><para>This option allows you to show or hide the Toolbar.</para></listitem> | ||||
1497 | </varlistentry> | ||||
1498 | | ||||
1499 | <varlistentry> | ||||
1500 | <term><menuchoice><guimenu>Settings</guimenu><guisubmenu><inlinemediaobject><imageobject><imagedata fileref="input-keyboard.png" | ||||
1501 | format="PNG"/></imageobject></inlinemediaobject>Configure Shortcuts...</guisubmenu></menuchoice></term> | ||||
1502 | <listitem><para>This option allows you to customize the keyboard shortcuts available within &kaddressbook;. | ||||
1503 | See <link linkend="settings-configure-shortcuts">the appendix</link> for more details.</para></listitem> | ||||
1504 | </varlistentry> | ||||
1505 | | ||||
1506 | <varlistentry> | ||||
1507 | <term><menuchoice><guimenu>Settings</guimenu><guisubmenu><inlinemediaobject><imageobject><imagedata fileref="configure.png" | ||||
1508 | format="PNG"/></imageobject></inlinemediaobject>Configure Toolbars...</guisubmenu></menuchoice></term> | ||||
1509 | <listitem><para>This option allows you to customize the contents of &kaddressbook;'s Toolbar. | ||||
1510 | See <link linkend="settings-configure-toolbars">the appendix</link> for more details.</para></listitem> | ||||
1511 | </varlistentry> | ||||
1512 | | ||||
1513 | <varlistentry> | ||||
1514 | <term><menuchoice><guimenu>Settings</guimenu><guisubmenu><inlinemediaobject><imageobject><imagedata fileref="configure.png" | ||||
1515 | format="PNG"/></imageobject></inlinemediaobject>Configure &kaddressbook;...</guisubmenu></menuchoice> | ||||
1516 | <keycombo action="simul">&Ctrl;&Shift;<keycap>,</keycap></keycombo></term> | ||||
1517 | <listitem><para>This option allows you to configure several advanced &kaddressbook; options. | ||||
1518 | See <link linkend="settings-configure-kaddressbook">the appendix</link> for more details.</para></listitem> | ||||
1519 | </varlistentry> | ||||
1520 | | ||||
1521 | </variablelist> | ||||
1522 | | ||||
1523 | </sect2> | ||||
1524 | | ||||
1525 | <para> </para> <!-- add more white space between sections @dcb --> | ||||
1526 | | ||||
1527 | <sect2 id="the-help-menu"> | ||||
1528 | <title>The Help Menu</title> | ||||
1529 | | ||||
1530 | <para> | ||||
1531 | <screenshot id="screenshot-help-menu"> | ||||
1532 | <screeninfo>A screenshot of &kaddressbook;'s <quote>Help</quote> menu.</screeninfo> | ||||
1533 | <mediaobject> | ||||
1534 | <imageobject> | ||||
1535 | <imagedata fileref="addressbook86.png" format="PNG"/> | ||||
1536 | </imageobject> | ||||
1537 | <textobject> | ||||
1538 | <phrase>A screenshot of &kaddressbook;'s <quote>Help</quote> menu.</phrase> | ||||
1539 | </textobject> | ||||
1540 | <caption> | ||||
1541 | <para>&kaddressbook;'s <quote>Help</quote> menu after clicking the | ||||
1542 | <menuchoice><guimenu>Help</guimenu></menuchoice> button on the Menubar.</para> | ||||
1543 | </caption> | ||||
1544 | </mediaobject> | ||||
1545 | </screenshot> | ||||
1546 | </para> | ||||
1547 | | ||||
1548 | <para> </para> <!-- add more white space after screenshot @dcb --> | ||||
1549 | | ||||
1550 | <para>The <menuchoice><guimenu>Help</guimenu></menuchoice> menu offers seven options.</para> | ||||
1551 | | ||||
1552 | <para> </para> <!-- add more white space @dcb --> | ||||
1553 | <variablelist> | ||||
1554 | | ||||
1555 | <varlistentry> | ||||
1556 | <term><menuchoice><guimenu>Help</guimenu><guisubmenu><inlinemediaobject><imageobject><imagedata fileref="system-help.png" | ||||
1557 | format="PNG"/></imageobject></inlinemediaobject>&kaddressbook; Handbook</guisubmenu></menuchoice> | ||||
1558 | <keycombo action="press"><keycap>F1</keycap></keycombo></term> | ||||
1559 | <listitem><para>This option displays a copy of <quote>The &kaddressbook; Handbook</quote> via the | ||||
1560 | &khelpcenter; utility program.</para></listitem> | ||||
1561 | </varlistentry> | ||||
1562 | | ||||
1563 | <varlistentry> | ||||
1564 | <term><menuchoice><guimenu>Help</guimenu><guisubmenu><inlinemediaobject><imageobject><imagedata fileref="help-about.png" | ||||
1565 | format="PNG"/></imageobject></inlinemediaobject>What's This?</guisubmenu></menuchoice><keycombo action="simul">&Shift; | ||||
1566 | <keycap>F1</keycap></keycombo></term> | ||||
1567 | <listitem><para>This is &kaddressbook;'s built-in help tool. Left-click this option, then move your cursor and click on any | ||||
1568 | one of the first four items on the Toolbar. A brief description of that tool's function will be displayed.</para></listitem> | ||||
1569 | </varlistentry> | ||||
1570 | | ||||
1571 | <varlistentry> | ||||
1572 | <term><menuchoice><guimenu>Help</guimenu><guisubmenu><inlinemediaobject><imageobject><imagedata fileref="tools-report-bug.png" | ||||
1573 | format="PNG"/></imageobject></inlinemediaobject>Report Bug</guisubmenu></menuchoice></term> | ||||
1574 | <listitem><para>This option opens a dialog that helps you file a bug report at <ulink | ||||
1575 | url="https://bugs.kde.org/">bugs.kde.org</ulink>, &kde;'s main bug tracking page.</para></listitem> | ||||
1576 | </varlistentry> | ||||
1577 | | ||||
1578 | <varlistentry> | ||||
1579 | <term><menuchoice><guimenu>Help</guimenu><guisubmenu><inlinemediaobject><imageobject><imagedata fileref="application-x-ms-shortcut.png" | ||||
1580 | format="PNG"/></imageobject></inlinemediaobject>Donate</guisubmenu></menuchoice></term> | ||||
1581 | <listitem><para>This opens a <ulink url="https://kde.org/community/donations/?app=kaddressbook">web | ||||
1582 | page</ulink> in your browser, where you may donate money to support &kde;. We accept euros, dollars, | ||||
1583 | rubles, sterling, yen, yuan, pesos, &etc;</para></listitem> | ||||
1584 | </varlistentry> | ||||
1585 | | ||||
1586 | <varlistentry> | ||||
1587 | <term><menuchoice><guimenu>Help</guimenu><guisubmenu><inlinemediaobject><imageobject><imagedata fileref="change-language.png" | ||||
1588 | format="PNG"/></imageobject></inlinemediaobject>Switch Application Language</guisubmenu></menuchoice></term> | ||||
1589 | <listitem><para>This option lets you change the language that is used to label the various menu items and built-in | ||||
1590 | help screens. You must quit &kaddressbook; and restart it before the new language takes effect.</para></listitem> | ||||
1591 | </varlistentry> | ||||
1592 | | ||||
1593 | <varlistentry> | ||||
1594 | <term><menuchoice><guimenu>Help</guimenu><guisubmenu><inlinemediaobject><imageobject><imagedata fileref="kaddressbook.png" | ||||
1595 | format="PNG"/></imageobject></inlinemediaobject>About &kaddressbook;</guisubmenu></menuchoice></term> | ||||
1596 | <listitem><para>Click on this item to learn which release of &kaddressbook; you're running, which libraries | ||||
1597 | were used to compile / build the executable code, and who the lead &kde; programmer is.</para></listitem> | ||||
1598 | </varlistentry> | ||||
1599 | | ||||
1600 | <varlistentry> | ||||
1601 | <term><menuchoice><guimenu>Help</guimenu><guisubmenu><inlinemediaobject><imageobject><imagedata fileref="KDE_logo.png" | ||||
1602 | format="PNG"/></imageobject></inlinemediaobject>About &kde;</guisubmenu></menuchoice></term> | ||||
1603 | <listitem><para>This option displays information about &kde;. Be free!</para></listitem> | ||||
1604 | </varlistentry> | ||||
1605 | | ||||
1606 | </variablelist> | ||||
1607 | | ||||
1608 | </sect2> | ||||
1609 | | ||||
1610 | </sect1> | ||||
1611 | | ||||
1612 | <sect1 id="tool-bar-items"> | ||||
1613 | <title>The Tool Bar</title> | ||||
1614 | | ||||
1615 | <sect2> | ||||
1616 | <para>There are five separate tools available on &kaddressbook;'s Toolbar: <quote>New Contact</quote>, <quote>New Group</quote>, | ||||
1617 | <quote>Edit Contact</quote>, <quote>Search...</quote>, and a category filter. Here's a picture. (Note that I have only documented | ||||
1618 | the default version of &kaddressbook;'s Toolbar. You may alter the Toolbar layout by using the <link linkend="the-settings-menu"> | ||||
1619 | <quote>Settings</quote></link> menu, if you so desire.)</para> | ||||
1620 | | ||||
1621 | <para> | ||||
1622 | <screenshot id="screenshot-tool-bar"> | ||||
1623 | <screeninfo>A closeup of &kaddressbook;'s Toolbar.</screeninfo> | ||||
1624 | <mediaobject> | ||||
1625 | <imageobject> | ||||
1626 | <imagedata fileref="addressbook87.png" format="PNG"/> | ||||
1627 | </imageobject> | ||||
1628 | <textobject> | ||||
1629 | <phrase>A closeup of &kaddressbook;'s Toolbar.</phrase><para> </para> <!-- add more white space after screenshot @dcb --> | ||||
1630 | </textobject> | ||||
1631 | <caption> | ||||
1632 | <para>&kaddressbook;'s standard Toolbar, up close and personal.</para> | ||||
1633 | </caption> | ||||
1634 | </mediaobject> | ||||
1635 | </screenshot> | ||||
1636 | </para> | ||||
1637 | | ||||
1638 | <para> </para> <!-- add more white space after screenshot @dcb --> | ||||
1639 | | ||||
1640 | <variablelist> | ||||
1641 | | ||||
1642 | <varlistentry> | ||||
1643 | <term><guibutton><inlinemediaobject><imageobject><imagedata fileref="list-add.png" | ||||
1644 | format="PNG"/></imageobject></inlinemediaobject>New Contact</guibutton></term> | ||||
1645 | <listitem><para>This Toolbar button opens the <quote>Add New Contact</quote> dialog | ||||
1646 | documented in <link linkend="edit-basic-info">chapter 4</link>, above.</para></listitem> | ||||
1647 | </varlistentry> | ||||
1648 | | ||||
1649 | <varlistentry> | ||||
1650 | <term><guibutton><inlinemediaobject><imageobject><imagedata fileref="user-group-new.png" | ||||
1651 | format="PNG"/></imageobject></inlinemediaobject>New Group</guibutton></term> | ||||
1652 | <listitem><para>This Toolbar button opens the <quote>Add New Group</quote> dialog | ||||
1653 | documented in <link linkend="file-new-group">the appendix</link>.</para></listitem> | ||||
1654 | </varlistentry> | ||||
1655 | | ||||
1656 | <varlistentry> | ||||
1657 | <term><guibutton><inlinemediaobject><imageobject><imagedata fileref="document-edit.png" | ||||
1658 | format="PNG"/></imageobject></inlinemediaobject>Edit Contact</guibutton></term> | ||||
1659 | <listitem><para>This Toolbar button opens the <quote>Edit Contact</quote> dialog | ||||
1660 | documented in <link linkend="edit-basic-info">chapter 4</link>, above.</para></listitem> | ||||
1661 | </varlistentry> | ||||
1662 | | ||||
1663 | <varlistentry> | ||||
1664 | <term>[ Search... <keycombo action="simul">&Alt;<keycap>Q</keycap></keycombo> ]</term> | ||||
1665 | <listitem><para>This tool searches through all the contacts in selected address books as you type. | ||||
1666 | Pressing &Alt;+Q simply positions the cursor inside the <quote>Search...</quote> | ||||
1667 | box. Be aware that this function searches the entirety of each contact record; a search for | ||||
1668 | <quote>and</quote> may return not only Andy Brown and Andrew Jones, but also Bill | ||||
1669 | Smith (who happens to work for Brown and Root Construction Company).</para></listitem> | ||||
1670 | </varlistentry> | ||||
1671 | | ||||
1672 | </variablelist> | ||||
1673 | | ||||
1674 | <para> | ||||
1675 | <screenshot id="toolbar-search"> | ||||
1676 | <screeninfo>A screen<para> </para> <!-- add more white space after screenshot @dcb -->shot of &kaddressbook;'s <quote>Search</quote> function.</screeninfo> | ||||
1677 | <mediaobject> | ||||
1678 | <imageobject> | ||||
1679 | <imagedata fileref="addressbook91.png" format="PNG"/> | ||||
1680 | </imageobject> | ||||
1681 | <textobject> | ||||
1682 | <phrase>A screenshot of &kaddressbook;'s <quote>Search</quote> function.</phrase> | ||||
1683 | </textobject> | ||||
1684 | <caption> | ||||
1685 | <para>&kaddressbook;'s <quote>Search</quote> function in action.</para> | ||||
1686 | </caption> | ||||
1687 | </mediaobject> | ||||
1688 | </screenshot> | ||||
1689 | </para> | ||||
1690 | | ||||
1691 | <para> </para> <!-- add more white space after screenshot @dcb --> | ||||
1692 | | ||||
1693 | <variablelist> | ||||
1694 | | ||||
1695 | <varlistentry> | ||||
1696 | <term>[ (All) <inlinemediaobject><imageobject><imagedata fileref="edit-clear.png" format="PNG"/></imageobject></inlinemediaobject> | ||||
1697 | <inlinemediaobject><imageobject><imagedata fileref="go-down.png" format="PNG"/></imageobject></inlinemediaobject>]</term> | ||||
1698 | <listitem><para>This tool performs a filtering function, based on categories. The two default categories are <quote>Untagged</quote> | ||||
1699 | and <quote>Groups</quote>. You can create new categories by associating <quote>Tags</quote> of your own devising with particular | ||||
1700 | contact records (see <link linkend="edit-basic-info">Add New Contact</link> in chapter 4, above). Clicking either <guibutton><inlinemediaobject> | ||||
1701 | <imageobject><imagedata fileref="edit-clear.png" format="PNG"/></imageobject></inlinemediaobject></guibutton> button will set the selected | ||||
1702 | categories to <quote>None</quote>; the <guibutton><inlinemediaobject><imageobject><imagedata fileref="view-refresh.png" format="PNG"/> | ||||
1703 | </imageobject></inlinemediaobject></guibutton> button will reset the selection criteria to <quote>All</quote>.</para></listitem> | ||||
1704 | </varlistentry> | ||||
1705 | | ||||
1706 | </variablelist> | ||||
1707 | | ||||
1708 | <para> | ||||
1709 | <screenshot id="toolbar-filter"> | ||||
1710 | <screeninfo>A screenshot of &kaddressbook;'s <quote>Filter</quote> function.</screeninfo> | ||||
1711 | <mediaobject> | ||||
1712 | <imageobject> | ||||
1713 | <imagedata fileref="addressbook92.png" format="PNG"/> | ||||
1714 | </imageobject> | ||||
1715 | <textobject> | ||||
1716 | <phrase>A screenshot of &kaddressbook;'s <quote>Filter</quote> function.</phrase> | ||||
1717 | </textobject> | ||||
1718 | <caption> | ||||
1719 | <para>&kaddressbook;'s <quote>Filter</quote> function in action.</para> | ||||
1720 | </caption> | ||||
1721 | </mediaobject> | ||||
1722 | </screenshot> | ||||
1723 | </para> | ||||
1724 | | ||||
1725 | </sect2> | ||||
1726 | | ||||
1727 | </sect1> | ||||
1728 | | ||||
1729 | <sect1 id="context-menus"> | ||||
1730 | <title>The Context Menus</title> | ||||
1731 | | ||||
1732 | <para>When you click the right mouse button anywhere inside the main Text Area, a context menu will appear, as illustrated below. | ||||
1733 | The particular menu that appears depends on both the panel within which the right-click occurred and the particular data item that | ||||
1734 | was selected, if any.</para> | ||||
1735 | | ||||
1736 | <sect2 id="the-addressbook-panel"> | ||||
1737 | <title>The Address Book Context Menu</title> | ||||
1738 | | ||||
1739 | <para> | ||||
1740 | <screenshot id="addressbook-context-menu"> | ||||
1741 | <screeninfo>A screenshot of &kaddressbook;'s <quote>Address Book</quote> context menu.</screeninfo> | ||||
1742 | <mediaobject> | ||||
1743 | <imageobject> | ||||
1744 | <imagedata fileref="addressbook93.png" format="PNG"/> | ||||
1745 | </imageobject> | ||||
1746 | <textobject> | ||||
1747 | <phrase>A screenshot of &kaddressbook;'s <quote>Address Book</quote> context menu.</phrase> | ||||
1748 | </textobject> | ||||
1749 | <caption> | ||||
1750 | <para>&kaddressbook;'s <quote>Address Book</quote> context menu.</para> | ||||
1751 | </caption> | ||||
1752 | </mediaobject> | ||||
1753 | </screenshot> | ||||
1754 | </para> | ||||
1755 | | ||||
1756 | <para> </para> <!-- add more white space after screenshot @dcb --> | ||||
1757 | | ||||
1758 | <variablelist> | ||||
1759 | | ||||
1760 | <varlistentry> | ||||
1761 | <term><menuchoice><guimenu><inlinemediaobject><imageobject><imagedata fileref="folder-new.png" | ||||
1762 | format="PNG"/></imageobject></inlinemediaobject>Add Address Book Folder...</guimenu></menuchoice></term> | ||||
1763 | <listitem><para>This context menu option does not perform a useful function in release 5.10.3.</para></listitem> | ||||
1764 | </varlistentry> | ||||
1765 | | ||||
1766 | <varlistentry> | ||||
1767 | <term><menuchoice><guimenu><inlinemediaobject><imageobject><imagedata fileref="edit-delete.png" | ||||
1768 | format="PNG"/></imageobject></inlinemediaobject>Delete Address Book Folder</guimenu></menuchoice></term> | ||||
1769 | <listitem><para>This context menu option does not perform a useful function in release 5.10.3.</para></listitem> | ||||
1770 | </varlistentry> | ||||
1771 | | ||||
1772 | <varlistentry> | ||||
1773 | <term><menuchoice><guimenu><inlinemediaobject><imageobject><imagedata fileref="folder-new.png" | ||||
1774 | format="PNG"/></imageobject></inlinemediaobject>Add Address Book...</guimenu></menuchoice></term> | ||||
1775 | <listitem><para>This context menu option launches the <quote>Add Address Book</quote> dialog that is | ||||
1776 | documented in <link linkend="how-to-add-a-new-address-book">chapter 2</link>, above.</para></listitem> | ||||
1777 | </varlistentry> | ||||
1778 | | ||||
1779 | <varlistentry> | ||||
1780 | <term><menuchoice><guimenu><inlinemediaobject><imageobject><imagedata fileref="edit-delete.png" | ||||
1781 | format="PNG"/></imageobject></inlinemediaobject>Delete Address Book</guimenu></menuchoice></term> | ||||
1782 | <listitem><para>Choosing this context menu option will delete the selected address book. | ||||
1783 | Be careful!</para></listitem> | ||||
1784 | </varlistentry> | ||||
1785 | | ||||
1786 | <varlistentry> | ||||
1787 | <term><menuchoice><guimenu><inlinemediaobject><imageobject><imagedata fileref="view-refresh.png" | ||||
1788 | format="PNG"/></imageobject></inlinemediaobject>Update Address Book Folder</guimenu> | ||||
1789 | <shortcut><keycombo action="press"><keycap>F5</keycap></keycombo></shortcut></menuchoice></term> | ||||
1790 | <listitem><para>This context menu option forces &kaddressbook; to reload the contact | ||||
1791 | data associated with the selected address book.</para></listitem> | ||||
1792 | </varlistentry> | ||||
1793 | | ||||
1794 | <varlistentry> | ||||
1795 | <term><menuchoice><guimenu><inlinemediaobject><imageobject><imagedata fileref="configure.png" | ||||
1796 | format="PNG"/></imageobject></inlinemediaobject>Folder Properties...</guimenu></menuchoice></term> | ||||
1797 | <listitem><para>This context menu option displays summary information about the selected | ||||
1798 | address book.</para></listitem> | ||||
1799 | </varlistentry> | ||||
1800 | | ||||
1801 | <varlistentry> | ||||
1802 | <term><menuchoice><guimenu><inlinemediaobject><imageobject><imagedata fileref="configure.png" | ||||
1803 | format="PNG"/></imageobject></inlinemediaobject>Address Book Properties...</guimenu></menuchoice></term> | ||||
1804 | <listitem><para>This context menu option displays summary information about the selected | ||||
1805 | address book.</para></listitem> | ||||
1806 | </varlistentry> | ||||
1807 | | ||||
1808 | <varlistentry> | ||||
1809 | <term><menuchoice><guimenu><inlinemediaobject><imageobject><imagedata fileref="document-open.png" | ||||
1810 | format="PNG"/></imageobject></inlinemediaobject>Serverside Subscription...</guimenu></menuchoice></term> | ||||
1811 | <listitem><para>This context menu option may or may not perform a useful function in release 5.10.3; so | ||||
1812 | far as I can tell, it is permanently grayed out. If you understand what it does, please let me know | ||||
1813 | (davidbryant AT gvtc.com).</para></listitem> | ||||
1814 | </varlistentry> | ||||
1815 | | ||||
1816 | </variablelist> | ||||
1817 | | ||||
1818 | <para> </para> <!-- add more white space between sections @dcb --> | ||||
1819 | | ||||
1820 | </sect2> | ||||
1821 | | ||||
1822 | <sect2 id="the-contactslist-panel"> | ||||
1823 | <title>The List of Contacts Context Menu</title> | ||||
1824 | | ||||
1825 | <para> | ||||
1826 | <screenshot id="contactlist-context-menu"> | ||||
1827 | <screeninfo>A screenshot of &kaddressbook;'s <quote>Contact List</quote> context menu.</screeninfo> | ||||
1828 | <mediaobject> | ||||
1829 | <imageobject> | ||||
1830 | <imagedata fileref="addressbook94.png" format="PNG"/> | ||||
1831 | </imageobject> | ||||
1832 | <textobject> | ||||
1833 | <phrase>A screenshot of &kaddressbook;'s <quote>Contact List</quote> context menu.</phrase> | ||||
1834 | </textobject> | ||||
1835 | <caption> | ||||
1836 | <para>&kaddressbook;'s <quote>Contact List</quote> context menu.</para> | ||||
1837 | </caption> | ||||
1838 | </mediaobject> | ||||
1839 | </screenshot> | ||||
1840 | </para> | ||||
1841 | | ||||
1842 | <para> </para> <!-- add more white space after screenshot @dcb --> | ||||
1843 | | ||||
1844 | <variablelist> | ||||
1845 | | ||||
1846 | <varlistentry> | ||||
1847 | <term><menuchoice><guimenu><inlinemediaobject><imageobject><imagedata fileref="list-add.png" format="PNG"/> | ||||
1848 | </imageobject></inlinemediaobject>New Contact</guimenu><shortcut><keycombo action="simul">&Ctrl;<keycap>N</keycap> | ||||
1849 | </keycombo></shortcut></menuchoice></term> | ||||
1850 | <listitem><para>Choosing this context menu option has exactly the same effect as clicking the | ||||
1851 | <guibutton> + New Contact </guibutton> button on the Toolbar. See <link | ||||
1852 | linkend="how-to-add-a-new-contact">chapter 2 above</link> for complete details.</para></listitem> | ||||
1853 | </varlistentry> | ||||
1854 | | ||||
1855 | <varlistentry> | ||||
1856 | <term><menuchoice><guimenu><inlinemediaobject><imageobject><imagedata fileref="user-group-new.png" format="PNG"/> | ||||
1857 | </imageobject></inlinemediaobject>New Group</guimenu><shortcut><keycombo action="simul">&Ctrl;<keycap>G</keycap> | ||||
1858 | </keycombo></shortcut></menuchoice></term> | ||||
1859 | <listitem><para>Choosing this context menu option opens a dialog in which you may define a new group, or mailing | ||||
1860 | list. See <link linkend="file-new-group">the appendix</link> for a detailed explanation.</para></listitem> | ||||
1861 | </varlistentry> | ||||
1862 | | ||||
1863 | <varlistentry> | ||||
1864 | <term><menuchoice><guimenu><inlinemediaobject><imageobject><imagedata fileref="document-edit.png" format="PNG"/> | ||||
1865 | </imageobject></inlinemediaobject>Edit Contact ...</guimenu></menuchoice></term> | ||||
1866 | <listitem><para>Choosing this context menu option has exactly the same effect as clicking the <guibutton><inlinemediaobject> | ||||
1867 | <imageobject><imagedata fileref="document-edit.png" format="PNG"/></imageobject></inlinemediaobject>Edit Contact...</guibutton> button | ||||
1868 | on the Toolbar. See <link linkend="how-to-add-a-new-contact">chapter 2 above</link> for complete details.</para></listitem> | ||||
1869 | </varlistentry> | ||||
1870 | | ||||
1871 | <varlistentry> | ||||
1872 | <term><menuchoice><guimenu>Export ></guimenu></menuchoice></term> | ||||
1873 | <listitem><para>This context menu function allows you to export selected contact data in either <acronym>vCard</acronym> or | ||||
1874 | <acronym>csv</acronym> format.</para></listitem> | ||||
1875 | </varlistentry> | ||||
1876 | | ||||
1877 | <varlistentry> | ||||
1878 | <term><menuchoice><guimenu><inlinemediaobject><imageobject><imagedata fileref="edit-copy.png" format="PNG"/></imageobject> | ||||
1879 | </inlinemediaobject>Copy Contact To ></guimenu></menuchoice></term> | ||||
1880 | <listitem><para>This context menu choice lets you copy the selected contact(s) to a variable destination. The list of | ||||
1881 | destinations displayed when this option is chiosen depends on how many address books you have created.</para></listitem> | ||||
1882 | </varlistentry> | ||||
1883 | | ||||
1884 | <varlistentry> | ||||
1885 | <term><menuchoice><guimenu><inlinemediaobject><imageobject><imagedata fileref="go-jump.png" format="PNG"/></imageobject> | ||||
1886 | </inlinemediaobject>Move Contact To ></guimenu></menuchoice></term> | ||||
1887 | <listitem><para>Works just like the <quote>Copy Contact To</quote> operation described above, except that it deletes | ||||
1888 | the source data, instead of creating an extra copy of it.</para></listitem> | ||||
1889 | </varlistentry> | ||||
1890 | | ||||
1891 | <varlistentry> | ||||
1892 | <term><menuchoice><guimenu><inlinemediaobject><imageobject><imagedata fileref="document-print.png" format="PNG"/></imageobject> | ||||
1893 | </inlinemediaobject>Print</guimenu><shortcut><keycombo action="simul">&Ctrl;<keycap>P</keycap></keycombo></shortcut></menuchoice></term> | ||||
1894 | <listitem><para>Choosing this context menu item opens a printer selection dialog. Use the <menuchoice><guisubmenu><inlinemediaobject> | ||||
1895 | <imageobject><imagedata fileref="document-preview-archive.png" format="PNG"/></imageobject></inlinemediaobject>Print Preview</guisubmenu> | ||||
1896 | </menuchoice> dialog below to set up the range of names and the print format before you select this function.</para></listitem> | ||||
1897 | </varlistentry> | ||||
1898 | | ||||
1899 | <varlistentry> | ||||
1900 | <term><menuchoice><guimenu><inlinemediaobject><imageobject><imagedata fileref="document-preview-archive.png" format="PNG"/> | ||||
1901 | </imageobject></inlinemediaobject>Print Preview</guimenu></menuchoice></term> | ||||
1902 | <listitem><para>This context menu option opens a print preview dialog, which also permits you to format the report, select which items to | ||||
1903 | include, and specify a sort order, etc. See <link linkend="file-print-preview">the appendix</link> for further details.</para></listitem> | ||||
1904 | </varlistentry> | ||||
1905 | | ||||
1906 | <varlistentry> | ||||
1907 | <term><menuchoice><guimenu><inlinemediaobject><imageobject><imagedata fileref="edit-delete.png" format="PNG"/></imageobject> | ||||
1908 | </inlinemediaobject>Delete Contact</guimenu><shortcut><keycombo action="press">∇</keycombo></shortcut></menuchoice></term> | ||||
1909 | <listitem><para>Delete the selected contact(s) from the current address book.</para></listitem> | ||||
1910 | </varlistentry> | ||||
1911 | | ||||
1912 | </variablelist> | ||||
1913 | | ||||
1914 | <para> </para> <!-- add more white space between sections @dcb --> | ||||
1915 | | ||||
1916 | </sect2> | ||||
1917 | | ||||
1918 | <sect2 id="the-individualcontact-panel"> | ||||
1919 | <title>The Individual Contact Context Menu</title> | ||||
1920 | | ||||
1921 | <para> | ||||
1922 | <screenshot id="individualcontact-context-menu"> | ||||
1923 | <screeninfo>A screenshot of &kaddressbook;'s <quote>Individual Contact</quote> context menu.</screeninfo> | ||||
1924 | <mediaobject> | ||||
1925 | <imageobject> | ||||
1926 | <imagedata fileref="addressbook95.png" format="PNG"/> | ||||
1927 | </imageobject> | ||||
1928 | <textobject> | ||||
1929 | <phrase>A screenshot of &kaddressbook;'s <quote>Individual Contact</quote> context menu.</phrase> | ||||
1930 | </textobject> | ||||
1931 | <caption> | ||||
1932 | <para>&kaddressbook;'s <quote>Individual Contact</quote> context menu.</para> | ||||
1933 | </caption> | ||||
1934 | </mediaobject> | ||||
1935 | </screenshot> | ||||
1936 | </para> | ||||
1937 | | ||||
1938 | <para> </para> <!-- add more white space after screenshot @dcb --> | ||||
1939 | | ||||
1940 | <para>Depending on which data item you select, the caption in this context menu may vary. But in | ||||
1941 | every case, the function is the same: the selected data item is copied to the clipboard.</para> | ||||
1942 | | ||||
1943 | </sect2> | ||||
1944 | | ||||
1945 | </sect1> | ||||
1946 | | ||||
1947 | </chapter> | ||||
1948 | | ||||
1949 | <glossary> | ||||
1950 | | ||||
1951 | <!-- Note to proofreaders: I'm still building the glossary. @dcb2019223 --> | ||||
1952 | | ||||
1953 | <glossentry id="gloss-aim"> | ||||
1954 | <glossterm>AIM</glossterm> | ||||
1955 | <glossdef><para><acronym>AIM</acronym> stands for (to be filled in ...).</para></glossdef> | ||||
1956 | </glossentry> | ||||
1957 | | ||||
1958 | <glossentry id="gloss-akonadi"> | ||||
1959 | <glossterm>&akonadi;</glossterm> | ||||
1960 | <glossdef><para>An extensible cross-desktop storage service for PIM data and meta data providing | ||||
1961 | concurrent read, write, and query access. &akonadi; can be manipulated with the akonadictl | ||||
1962 | command: enter <quote>akonadictl --help</quote> in a console window to learn more.</para></glossdef> | ||||
1963 | </glossentry> | ||||
1964 | | ||||
1965 | <glossentry id="gloss-cloud"> | ||||
1966 | <glossterm>Cloud-based service</glossterm> | ||||
1967 | <glossdef><para>Any provider of data storage and data processing resources residing in some | ||||
1968 | <quote>cloud</quote> of servers one may access via the internet.</para></glossdef> | ||||
1969 | </glossentry> | ||||
1970 | | ||||
1971 | <glossentry id="gloss-csv"> | ||||
1972 | <glossterm>.csv</glossterm> | ||||
1973 | <glossdef><para>A Comma Separated Values (or <acronym>.csv</acronym>) file is a plain text | ||||
1974 | document in which each line, or record, is divided into fields by a specific separator character, | ||||
1975 | usually a comma. The <filename class="extension">.csv</filename> format dates back to the early days | ||||
1976 | of computing. It is still widely used, mainly because it is conceptually so simple.</para></glossdef> | ||||
1977 | </glossentry> | ||||
1978 | | ||||
1979 | <glossentry id="gloss-dav"> | ||||
1980 | <glossterm>DAV</glossterm> | ||||
1981 | <glossdef><para><acronym>DAV</acronym> stands for Distributed Authoring and Versioning, which exists in | ||||
1982 | several "flavors", such as WebDAV (for creating pages on the internet), GroupDAV (for groupware, &ie;, | ||||
1983 | open source software authored by a group of collaborators), and CalDAV (calendar management for groups), | ||||
1984 | each one of which helps connect open source clients with open source servers.</para></glossdef> | ||||
1985 | </glossentry> | ||||
1986 | | ||||
1987 | <glossentry id="gloss-ews"> | ||||
1988 | <glossterm>EWS</glossterm> | ||||
1989 | <glossdef><para><acronym>EWS</acronym> stands for Exchange Web Services, &Microsoft;'s set of | ||||
1990 | proprietary protocols for exchanging personal data between internet servers and end users, or clients. | ||||
1991 | <glossterm linkend="gloss-kolab">Kolab</glossterm> provides similar functionality.</para></glossdef> | ||||
1992 | </glossentry> | ||||
1993 | | ||||
1994 | <glossentry id="gloss-gadu-gadu"> | ||||
1995 | <glossterm>Gadu-Gadu</glossterm> | ||||
1996 | <glossdef><para>Gadu-Gadu (aka GG) is the most popular instant-messaging app in Poland.</para></glossdef> | ||||
1997 | </glossentry> | ||||
1998 | | ||||
1999 | <glossentry id="gloss-gpws"> | ||||
2000 | <glossterm>GroupWise</glossterm> | ||||
2001 | <glossdef><para>GroupWise stands for (to be filled in ...).</para></glossdef> | ||||
2002 | </glossentry> | ||||
2003 | | ||||
2004 | <glossentry id="gloss-icq"> | ||||
2005 | <glossterm>ICQ</glossterm> | ||||
2006 | <glossdef><para><acronym>ICQ</acronym> stands for (to be filled in ...).</para></glossdef> | ||||
2007 | </glossentry> | ||||
2008 | | ||||
2009 | <glossentry id="gloss-imap"> | ||||
2010 | <glossterm>&IMAP;</glossterm> | ||||
2011 | <glossdef><para><acronym>IMAP</acronym> stands for Internet Message Access Protocol, a widely | ||||
2012 | available method for managing email messages. IMAP maintains and synchronizes local and remote | ||||
2013 | copies of a set of messages -- in other words, the locally stored data for an IMAP account are | ||||
2014 | a mirror image of the messages on the server.</para></glossdef> | ||||
2015 | </glossentry> | ||||
2016 | | ||||
2017 | <glossentry id="gloss-inline-pgp"> | ||||
2018 | <glossterm>Inline OpenPGP</glossterm> | ||||
2019 | <glossdef><para>Inline OpenPGP is (to be filled in ...).</para></glossdef> | ||||
2020 | </glossentry> | ||||
2021 | | ||||
2022 | <glossentry id="gloss-irc"> | ||||
2023 | <glossterm>IRC</glossterm> | ||||
2024 | <glossdef><para><acronym>IRC</acronym> stands for (to be filled in ...).</para></glossdef> | ||||
2025 | </glossentry> | ||||
2026 | | ||||
2027 | <glossentry id="gloss-isdn"> | ||||
2028 | <glossterm>ISDN</glossterm> | ||||
2029 | <glossdef><para><acronym>ISDN</acronym> stands for (to be filled in ...).</para></glossdef> | ||||
2030 | </glossentry> | ||||
2031 | | ||||
2032 | <glossentry id="gloss-jabber"> | ||||
2033 | <glossterm>Jabber</glossterm> | ||||
2034 | <glossdef><para>Jabber stands for (to be filled in ...).</para></glossdef> | ||||
2035 | </glossentry> | ||||
2036 | | ||||
2037 | <glossentry id="gloss-kmail"> | ||||
2038 | <glossterm>&kmail;</glossterm> | ||||
2039 | <glossdef><para>&kde;'s email management program. Provides a fully integrated environment | ||||
2040 | for sending and receiving email messages from one (or more) email account(s), maintaining | ||||
2041 | as many email identities as you want to have, organizing and archiving your old email | ||||
2042 | messages, and managing your personal email encryption keys.</para></glossdef> | ||||
2043 | </glossentry> | ||||
2044 | | ||||
2045 | <glossentry id="gloss-kolab"> | ||||
2046 | <glossterm>Kolab</glossterm> | ||||
2047 | <glossdef><para>Kolab Systems AG is a corporation headquartered in Zurich, Switzerland that | ||||
2048 | provides both proprietary and open source software tools to facilitate collaboration among | ||||
2049 | groups of people who share data, messages, and calendaring / scheduling resources via the | ||||
2050 | internet. <glossterm linkend="gloss-ews">EWS</glossterm> provides similar, though | ||||
2051 | wholly proprietary, software packages.</para></glossdef> | ||||
2052 | </glossentry> | ||||
2053 | | ||||
2054 | <glossentry id="gloss-ldap"> | ||||
2055 | <glossterm>LDAP</glossterm> | ||||
2056 | <glossdef><para>The Lightweight Directory Access Protocol (or <acronym>ldap</acronym>) is | ||||
2057 | a standard protocol, or method, for sharing some particular classes of information among the | ||||
2058 | many server computers that comprise the internet.</para></glossdef> | ||||
2059 | </glossentry> | ||||
2060 | | ||||
2061 | <glossentry id="gloss-ldif"> | ||||
2062 | <glossterm>.ldif</glossterm> | ||||
2063 | <glossdef><para>An <glossterm linkend="gloss-ldap"><acronym>LDAP</acronym></glossterm> | ||||
2064 | Data Interchange Format (or <filename class="extension">.ldif</filename>) file is a type | ||||
2065 | of plain text file designed for exchanging directory information among the various servers | ||||
2066 | in a distributed network.</para></glossdef> | ||||
2067 | </glossentry> | ||||
2068 | | ||||
2069 | <glossentry id="gloss-mnwhl"> | ||||
2070 | <glossterm>Meanwhile</glossterm> | ||||
2071 | <glossdef><para>Meanwhile stands for (to be filled in ...).</para></glossdef> | ||||
2072 | </glossentry> | ||||
2073 | | ||||
2074 | <glossentry id="gloss-open-pgp"> | ||||
2075 | <glossterm>OpenPGP/MIME</glossterm> | ||||
2076 | <glossdef><para>OpenPGP/MIME stands for (to be filled in ...).</para></glossdef> | ||||
2077 | </glossentry> | ||||
2078 | | ||||
2079 | <glossentry id="gloss-group"> | ||||
2080 | <glossterm>Open-Xchange Groupware Server</glossterm> | ||||
2081 | <glossdef><para>Open-Xchange AG is a corporation headquartered in Cologne, Germany that | ||||
2082 | provides both proprietary and open source software tools to facilitate collaboration among | ||||
2083 | groups of people who share data, messages, and calendaring / scheduling resources via the | ||||
2084 | internet. <glossterm linkend="gloss-ews">EWS</glossterm> and <glossterm | ||||
2085 | linkend="gloss-kolab">Kolab</glossterm> provide similar software packages.</para></glossdef> | ||||
2086 | </glossentry> | ||||
2087 | | ||||
2088 | <glossentry id="gloss-pcs"> | ||||
2089 | <glossterm>PCS</glossterm> | ||||
2090 | <glossdef><para><acronym>PCS</acronym> stands for (to be filled in ...).</para></glossdef> | ||||
2091 | </glossentry> | ||||
2092 | | ||||
2093 | <glossentry id="gloss-pim"> | ||||
2094 | <glossterm>&PIM;</glossterm> | ||||
2095 | <glossdef><para>&kde;'s Personal Information Management system, a suite of programs | ||||
2096 | to help you manage your contacts and your schedule. &PIM; includes &kontact;, | ||||
2097 | &kmail;, &kaddressbook;, &korganizer;, &akregator;, and | ||||
2098 | &akonadi;. Also used more generally to describe any system for managing personal | ||||
2099 | information such as names, addresses, telephone numbers, &etc;</para></glossdef> | ||||
2100 | </glossentry> | ||||
2101 | | ||||
2102 | <glossentry id="gloss-mime"> | ||||
2103 | <glossterm>S/MIME</glossterm> | ||||
2104 | <glossdef><para>S/MIME stands for (to be filled in ...).</para></glossdef> | ||||
2105 | </glossentry> | ||||
2106 | | ||||
2107 | <glossentry id="gloss-opaque"> | ||||
2108 | <glossterm>S/MIME Opaque</glossterm> | ||||
2109 | <glossdef><para>S/MIME Opaque stands for (to be filled in ...).</para></glossdef> | ||||
2110 | </glossentry> | ||||
2111 | | ||||
2112 | <glossentry id="gloss-sms"> | ||||
2113 | <glossterm>SMS</glossterm> | ||||
2114 | <glossdef><para><acronym>SMS</acronym> stands for (to be filled in ...).</para></glossdef> | ||||
2115 | </glossentry> | ||||
2116 | | ||||
2117 | <glossentry id="gloss-vcf"> | ||||
2118 | <glossterm>.vcf</glossterm> | ||||
2119 | <glossdef><para>The Virtual (business) Card Format (or <filename class="extension">.vcf</filename>) | ||||
2120 | is a keyword-oriented data interchange format that has gone through several iterations (2.0, | ||||
2121 | 2.1, 3.0, &etc;) since its introduction <emphasis>ca.</emphasis> 1990. The most recent | ||||
2122 | version is vCard 4.0.</para></glossdef> | ||||
2123 | </glossentry> | ||||
2124 | | ||||
2125 | </glossary> | ||||
2126 | | ||||
2127 | &docbook-reference; | ||||
2128 | | ||||
2129 | </book> |
please add a line with:
<title>The &kaddressbook; Handbook</title>