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 | ]> | ||||
7 | | ||||
8 | <book id="kaddressbook" lang="&language;"> | ||||
9 | | ||||
10 | <bookinfo> | ||||
11 | | ||||
12 | <title>The &kaddressbook; Handbook</title> | ||||
lueck: please add a line with:
<title>The &kaddressbook; Handbook</title> | |||||
13 | | ||||
14 | <authorgroup> | ||||
15 | | ||||
16 | <author> | ||||
17 | <firstname>David</firstname> | ||||
18 | <othername>C.</othername> | ||||
19 | <surname>Bryant</surname> | ||||
20 | <affiliation><address><email>davidbryant@gvtc.com</email></address></affiliation> | ||||
21 | </author> | ||||
22 | | ||||
23 | <!-- TRANS:ROLES_OF_TRANSLATORS --> | ||||
24 | | ||||
25 | </authorgroup> | ||||
26 | | ||||
27 | <copyright> | ||||
28 | <year>2019</year> | ||||
29 | <holder>David C. Bryant</holder> | ||||
30 | </copyright> | ||||
31 | | ||||
&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 | <legalnotice>&CCBYSA4Notice;</legalnotice> | ||||
33 | | ||||
34 | <date>2019-07-20</date> | ||||
35 | <releaseinfo>5.7.3 (Applications 17.12.3)</releaseinfo> | ||||
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 | | ||||
37 | <abstract> | ||||
38 | <para>&kaddressbook; is part of the &kde; suite of personal information management | ||||
39 | (&PIM;) programs. &kaddressbook; is primarily an email address manager, but it can | ||||
40 | also help you keep track of your friends' and associates' telephone numbers, web | ||||
41 | sites, social media connections, snail-mail addresses, and more, besides. It's your | ||||
42 | one-stop shop for keeping track of all the people you know. | ||||
43 | </para> | ||||
44 | </abstract> | ||||
45 | | ||||
46 | <!-- Note to self: add more keywords later. --> | ||||
47 | <keywordset> | ||||
48 | <keyword>KDE</keyword> | ||||
49 | <keyword>KAddressBook</keyword> | ||||
50 | <keyword>kdepim</keyword> | ||||
51 | <keyword>Email</keyword> | ||||
52 | </keywordset> | ||||
53 | | ||||
54 | </bookinfo> | ||||
55 | | ||||
56 | <chapter id="introduction"> | ||||
57 | <title>Introduction</title> | ||||
58 | | ||||
59 | <para> | ||||
60 | &kaddressbook; is part of the &kde; suite of personal information management | ||||
61 | (&PIM;) programs. &kaddressbook; is primarily an email address | ||||
62 | manager, but it can also help you keep track of your friends' and associates' | ||||
63 | telephone numbers, web sites, social media connections, snail-mail addresses, and | ||||
64 | more, besides. It's your one-stop shop for keeping track of all the people | ||||
65 | 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>A screenshot of &kaddressbook;'s primary display. The Menubar is at | ||||
79 | the top, the Toolbar is next, and there are three Panels for dats in the Text Area | ||||
yurchor: Typo: dats -> data | |||||
80 | at the bottom.</para> | ||||
81 | </caption> | ||||
82 | </mediaobject> | ||||
83 | </screenshot> | ||||
84 | | ||||
85 | <para> </para> <!-- add more white space after screenshot @dcb --> | ||||
86 | | ||||
87 | <para> | ||||
88 | &kaddressbook; has been integrated into the structure of &kmail;, the &kde; email | ||||
89 | 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 two 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">.csv</filename> (Comma Separated Values), | ||||
<filename class="extension">.csv</filename> lueck: <filename class="extension">.csv</filename>
<filename class="extension">.ldif</filename>… | |||||
100 | <filename class="extension">.ldif</filename> (LDAP Data Interchange Format), and | ||||
101 | <filename class="extension">.vcf</filename> (Virtual business Card Format) record formats. | ||||
102 | </para> | ||||
103 | | ||||
104 | <!-- Insert additional information about problem reporting here --> | ||||
105 | </chapter> | ||||
106 | | ||||
107 | <chapter id="getting-started"> | ||||
108 | <title>Getting Started</title> | ||||
109 | | ||||
110 | <para> | ||||
111 | Here is a picture of the primary &kaddressbook; user interface before any address | ||||
112 | data have been entered. As you can see, only the main menu items are active. All | ||||
113 | the standard toolbar buttons are grayed out. The first thing you need to do is | ||||
114 | create an address book. | ||||
115 | </para> | ||||
116 | | ||||
117 | <screenshot id="screenshot-blank"> | ||||
118 | <screeninfo>A screenshot of &kaddressbook;'s <quote>empty</quote> &GUI; interface</screeninfo> | ||||
119 | <mediaobject> | ||||
120 | <imageobject> | ||||
121 | <imagedata fileref="addressbook10.png" format="PNG"/> | ||||
122 | </imageobject> | ||||
123 | <textobject> | ||||
124 | <phrase>A screenshot of &kaddressbook;'s <quote>empty</quote> &GUI; interface</phrase> | ||||
125 | </textobject> | ||||
126 | <caption>te | ||||
127 | <para>A screenshot of &kaddressbook;'s <quote>empty</quote> &GUI; interface, | ||||
128 | before any address books have been created.</para> | ||||
129 | </caption> | ||||
130 | </mediaobject> | ||||
131 | </screenshot> | ||||
132 | | ||||
133 | <para> </para> <!-- add more white space after screenshot @dcb --> | ||||
134 | | ||||
135 | <sect1 id="how-to-add-a-new-address-book"> | ||||
136 | <title>How to Add a New Address Book</title> | ||||
137 | | ||||
138 | <procedure id="procedure-add-a-new-addressbook"> | ||||
139 | | ||||
140 | <step id="new-addressbook-dialog-step"><para> | ||||
141 | Open &kaddressbook;'s Add Address Book dialog with the <menuchoice><guimenu>File</guimenu> | ||||
142 | <guisubmenu>New</guisubmenu><guimenuitem>Add Address Book...</guimenuitem></menuchoice> | ||||
143 | option. A dialog box will appear. | ||||
144 | </para> | ||||
145 | | ||||
146 | <para> | ||||
147 | <screenshot id="screenshot-add-an-address-book"> | ||||
148 | <screeninfo>A screenshot of &kaddressbook;'s Add Address Book dialog</screeninfo> | ||||
149 | <mediaobject> | ||||
150 | <imageobject> | ||||
151 | <imagedata fileref="addressbook20.png" format="PNG"/> | ||||
152 | </imageobject> | ||||
153 | <textobject> | ||||
154 | <phrase>A screenshot of &kaddressbook;'s Add Address Book dialog</phrase> | ||||
155 | </textobject> | ||||
156 | <caption> | ||||
157 | <para>A screenshot of &kaddressbook;'s Add Address Book dialog. | ||||
158 | Five cloud services are supported, plus three local storage options. Do | ||||
159 | not try to use <quote>Knut</quote>.</para> | ||||
160 | </caption> | ||||
161 | </mediaobject> | ||||
162 | </screenshot> | ||||
163 | </para> | ||||
164 | <para> </para> <!-- add more white space after screenshot @dcb --> | ||||
165 | </step> | ||||
166 | | ||||
167 | <step id="select-a-format-step"><para> | ||||
168 | Choose one of the options that appear in the dialog. Several of these options | ||||
169 | link to data collections residing in the cloud: DAV groupware (Distributed | ||||
170 | Authoring and Versioning, RFC4918), Google Contacts (your gmail.com account), | ||||
171 | Kolab groupware server (collaboration via &IMAP;), &Microsoft; Exchange Server EWS | ||||
172 | (Exchange Web Services, on servers running MS software), and Open-Xchange Groupware | ||||
173 | Server (an open-source alternative to MS EWS). If you already have access to one | ||||
174 | or more of these cloud-based resources, you can integrate those data into &kaddressbook; | ||||
175 | by simply selecting the option and then entering your login credentials. | ||||
176 | </para> | ||||
177 | | ||||
178 | <para> | ||||
lueck: <filename class="extension">.vcf</filename> | |||||
179 | The remaining options in the dialog (Personal Contacts, vCard Directory, and | ||||
180 | vCard File) all create data sets that are saved on a local storage device. Each | ||||
181 | one of these options uses the same data format ( | ||||
182 | <filename class="extension">.vcf</filename>, or Virtual Card Format), | ||||
183 | the only difference being in which particular directory the data are saved. The | ||||
184 | <quote>Personal Contacts</quote> and <quote>vCard Directory</quote> options create a separate | ||||
185 | file for each named contact you save; the <quote>vCard File</quote> option puts all the data | ||||
186 | into one file. It's probably easiest to start with the <quote>Personal Contacts</quote> address | ||||
187 | book. You will not need more address books unless you have extensive contact | ||||
188 | lists you want to keep separate. | ||||
189 | </para></step> | ||||
190 | | ||||
191 | <step id="add-a-cloud-based-service-step"><para> | ||||
192 | Once you have made your selection, click on OK. If you have selected a cloud-based | ||||
193 | service, a brief dialog will ensue, to establish communications between &akonadi; | ||||
194 | (the &PIM; cross-desktop storage service) and the selected cloud server. Here's what | ||||
195 | the dialog looks like for a Google (gmail.com) account. The other cloud-based servicetes | ||||
yurchor: Typo: servicetes -> services | |||||
196 | are slightly different, but similar. | ||||
197 | </para> | ||||
198 | | ||||
199 | <para> | ||||
200 | <screenshot id="screenshot-add-a-cloud-based-service"> | ||||
201 | <screeninfo>A screenshot of &kaddressbook;'s link-to-gmail dialog</screeninfo> | ||||
202 | <mediaobject> | ||||
203 | <imageobject> | ||||
204 | <imagedata fileref="addressbook30.png" format="PNG"/> | ||||
205 | </imageobject> | ||||
206 | <textobject> | ||||
207 | <phrase>A screenshot of &kaddressbook;'s link-to-gmail dialog</phrase> | ||||
208 | </textobject> | ||||
209 | <caption> | ||||
210 | <para>A screenshot of &kaddressbook;'s link-to-gmail dialog. | ||||
211 | Begin by clicking <quote>Add</quote>. A new dialog will appear. Once your credentials | ||||
212 | have been accepted, this screen will reappear, and you will click <guibutton> ✔ OK </guibutton>. | ||||
213 | If you would like &kaddressbook; to refresh the locally cached copy of your contact list | ||||
214 | automatically, do it here, before you click <guibutton> ✔ OK </guibutton>.</para> | ||||
215 | </caption> | ||||
216 | </mediaobject> | ||||
217 | </screenshot> | ||||
218 | </para> | ||||
219 | | ||||
220 | <para> | ||||
221 | <screenshot id="screenshot-add-a-cloud-based-service-step2"> | ||||
222 | <screeninfo>A second screenshot of &kaddressbook;'s link-to-gmail dialog</screeninfo> | ||||
223 | <mediaobject> | ||||
224 | <imageobject> | ||||
225 | <imagedata fileref="addressbook31.png" format="PNG"/> | ||||
226 | </imageobject> | ||||
227 | <textobject> | ||||
228 | <phrase>A second screenshot of &kaddressbook;'s link-to-gmail dialog</phrase>te | ||||
229 | </textobject> | ||||
230 | <caption> | ||||
231 | <para>Another screenshot of &kaddressbook;'s link-to-gmail dialog. Enter your | ||||
232 | gmail.com address and click <guibutton> Next </guibutton>. You will be asked to | ||||
233 | enter your gmail password.</para> | ||||
234 | </caption> | ||||
235 | </mediaobject> | ||||
236 | </screenshot> | ||||
237 | </para> | ||||
238 | | ||||
239 | <para> | ||||
240 | <screenshot id="screenshot-add-a-cloud-based-service-step3"> | ||||
241 | <screeninfo>A third screenshot of &kaddressbook;'s link-to-gmail dialog</screeninfo> | ||||
242 | <mediaobject> | ||||
243 | <imageobject> | ||||
244 | <imagedata fileref="addressbook32.png" format="PNG"/> | ||||
245 | </imageobject> | ||||
246 | <textobject> | ||||
247 | <phrase>A third screenshot of &kaddressbook;'s link-to-gmail dialog</phrase> | ||||
248 | </textobject> | ||||
249 | <caption> | ||||
250 | <para>Yet another screenshot of &kaddressbook;'s link-to-gmail dialog. | ||||
251 | Your account name and password have been accepted by Google's server. Read | ||||
252 | the privacy notice and press <guibutton> Allow </guibutton>, then | ||||
253 | <guibutton> ✔ OK </guibutton> in the <quote> Add </quote> dialog | ||||
254 | with which you started.</para> | ||||
255 | </caption> | ||||
256 | </mediaobject> | ||||
257 | </screenshot> | ||||
258 | </para> | ||||
259 | | ||||
260 | <para> </para> <!-- add more white space after screenshot @dcb --> | ||||
261 | | ||||
262 | <para> | ||||
263 | Enter your login credentials as illustrated above and say OK. Voila! Your cloud-based | ||||
264 | contact list is now integrated into &kaddressbook;. | ||||
265 | </para> | ||||
266 | | ||||
267 | <para> | ||||
268 | <screenshot id="screenshot-add-a-cloud-based-service-completed"> | ||||
269 | <screeninfo>The &kaddressbook; window after a gmail.com account has been added.</screeninfo> | ||||
270 | <mediaobject> | ||||
271 | <imageobject> | ||||
272 | <imagedata fileref="addressbook33.png" format="PNG"/> | ||||
273 | </imageobject> | ||||
274 | <textobject> | ||||
275 | <phrase>The &kaddressbook; window after a gmail.com account has been added.</phrase> | ||||
276 | </textobject> | ||||
277 | <caption> | ||||
278 | <para>Another screenshot of the &kaddressbook; window, after a gmail.com | ||||
279 | account has been added. You can now manipulate your gmail contacts via | ||||
280 | &kaddressbook;, if you like.</para> | ||||
281 | </caption> | ||||
282 | </mediaobject> | ||||
283 | </screenshot> | ||||
284 | </para> | ||||
285 | | ||||
286 | <para> </para> <!-- add more white space after screenshot @dcb --> | ||||
287 | | ||||
288 | <para> | ||||
289 | As the preceding screenshot indicates, once you have registered &kaddressbook; as a | ||||
290 | trusted resource, you can view and edit your gmail contacts using &kaddressbook;. Of | ||||
291 | course, you may also continue to maintain your contacts by using a web browser, if you wish. | ||||
292 | </para> | ||||
293 | | ||||
294 | <para> </para> <!-- add more white space after screenshot @dcb --> | ||||
295 | | ||||
296 | </step> | ||||
297 | | ||||
298 | <step id="add-a-local-addressbook-step"><para> | ||||
299 | If you selected one of the local address book options in | ||||
300 | <link linkend="select-a-format-step">step 2</link> above, a different | ||||
301 | dialog will ensue. </para> | ||||
302 | | ||||
303 | <para> | ||||
304 | <screenshot id="screenshot-add-a-personal-addressbook"> | ||||
305 | <screeninfo>A screenshot of &kaddressbook;'s <quote>Personal Contacts</quote> dialog.</screeninfo> | ||||
306 | <mediaobject> | ||||
307 | <imageobject> | ||||
308 | <imagedata fileref="addressbook34.png" format="PNG"/> | ||||
309 | </imageobject> | ||||
310 | <textobject> | ||||
311 | <phrase>A screenshot of &kaddressbook;'s <quote>Personal Contacts</quote> dialog.</phrase> | ||||
312 | </textobject> | ||||
313 | <caption> | ||||
314 | <para>A screenshot of &kaddressbook;'s <quote>Personal Contacts</quote> dialog. | ||||
315 | You may specify which directory will contain your data, and whether you have write access to | ||||
316 | this resource, or not. For most people, the default selections (as shown above) work well.</para> | ||||
317 | </caption> | ||||
318 | </mediaobject> | ||||
319 | </screenshot> | ||||
320 | </para> | ||||
321 | | ||||
322 | <para> </para> <!-- add more white space after screenshot @dcb --> | ||||
323 | | ||||
324 | <para> | ||||
325 | Make any modifications you deem necessary in the <quote>Personal Contacts</quote> dialog, | ||||
326 | then click <guibutton> ✔ OK </guibutton>. A new address book will appear in the main | ||||
327 | &kaddressbook; interface window, as shown below. | ||||
328 | </para> | ||||
329 | | ||||
330 | <para> | ||||
331 | <screenshot id="screenshot-personal-addressbook-has-been-added"> | ||||
332 | <screeninfo>A screenshot of &kaddressbook;'s main window with an empty <quote>Personal Contacts</quote> address book.</screeninfo> | ||||
333 | <mediaobject> | ||||
334 | <imageobject> | ||||
335 | <imagedata fileref="addressbook35.png" format="PNG"/> | ||||
336 | </imageobject> | ||||
337 | <textobject> | ||||
338 | <phrase>A screenshot of &kaddressbook;'s main window with an empty <quote>Personal Contacts</quote> address book.</phrase> | ||||
339 | </textobject> | ||||
340 | <caption> | ||||
341 | <para>A screenshot of &kaddressbook;'s main window after the <quote>Personal Contacts</quote> address book has been created.</para> | ||||
342 | </caption> | ||||
343 | </mediaobject> | ||||
344 | </screenshot> | ||||
345 | </para> | ||||
346 | | ||||
347 | <para> </para> <!-- add more white space after screenshot @dcb --> | ||||
348 | </step> | ||||
349 | | ||||
350 | </procedure> | ||||
351 | </sect1> | ||||
352 | | ||||
353 | <sect1 id="how-to-add-a-new-contact"> | ||||
354 | <title>How to Add a New Contact</title> | ||||
355 | | ||||
356 | <procedure id="procedure-add-a-new-contact"> | ||||
357 | | ||||
358 | <step id="new-contact-dialog-step-1"><para> | ||||
359 | Open &kaddressbook;'s New Contact dialog by clicking the <guibutton> + New Contact </guibutton> | ||||
360 | button on the Menubar. A dialog box will appear.</para> | ||||
361 | | ||||
362 | <para> | ||||
363 | <screenshot id="screenshot-new-contact-dialog"> | ||||
364 | <screeninfo>A screenshot of &kaddressbook;'s <quote>New Contact</quote> dialog.</screeninfo> | ||||
365 | <mediaobject> | ||||
366 | <imageobject> | ||||
367 | <imagedata fileref="addressbook40.png" format="PNG"/> | ||||
368 | </imageobject> | ||||
369 | <textobject> | ||||
370 | <phrase>A screenshot of &kaddressbook;'s <quote>New Contact</quote> dialog.</phrase> | ||||
371 | </textobject> | ||||
372 | <caption> | ||||
373 | <para>A screenshot of &kaddressbook;'s <quote>New Contact</quote> dialog after clicking the | ||||
374 | <guibutton> + New Contact </guibutton> button on the Menubar.</para> | ||||
375 | </caption> | ||||
376 | </mediaobject> | ||||
377 | </screenshot> | ||||
378 | </para> | ||||
379 | | ||||
380 | <para> </para> <!-- add more white space after screenshot @dcb --> | ||||
381 | | ||||
382 | </step> | ||||
383 | | ||||
384 | <step id="procedure-new-contact-data-items"><para> | ||||
385 | As you can see from the preceding screenshot, the <quote>New Contact</quote> dialog allows one | ||||
386 | to enter several different data items. Additional data may be entered via the <quote>Location</quote>, | ||||
387 | <quote>Business</quote>, <quote>Personal</quote>, <quote>Notes</quote>, <quote>Custom Fields</quote>, | ||||
388 | and <quote>Crypto Settings</quote> sub-dialogs, as explained more fully in | ||||
389 | <link linkend="editing-contact-data">chapter x</link>, below. For now, let's concentrate on adding | ||||
390 | the <quote>Contact</quote> data items appearing in the preceding illustration.</para> | ||||
391 | </step> | ||||
392 | | ||||
393 | <step id="procedure-entering-basic-new-contact-data"><para> | ||||
394 | If you have created more than one address book, use the drop-down list labeled <quote>Add to:</quote> | ||||
395 | to select the data set to which the new contact will be added. Then enter the new contact's name in | ||||
396 | the input field marked <quote>Name</quote>, and key in his or her email address in the input field | ||||
397 | labeled <quote>Email</quote>. If you want to specify special formatting options for this contact's | ||||
398 | name data, click the <guibutton> ... </guibutton> button to the right of the <quote>Name</quote> | ||||
399 | input field and follow the prompts. If you wish to add more email addresses for this person, click the | ||||
400 | <guibutton> + </guibutton> button to the right of the <quote>Email</quote> input field and another | ||||
401 | Email input field will be generated. To delete an Email address, click the associated | ||||
402 | <guibutton> − </guibutton> button. | ||||
403 | | ||||
404 | </para></step> | ||||
405 | | ||||
406 | <step id="procedure-additional-new-contact-data"><para> | ||||
407 | You may also associate a nickname, one or more telephone numbers, multiple instant messaging services, | ||||
408 | and several web sites with each contact in an address book, as explained in | ||||
409 | <link linkend="editing-contact-data">chapter x</link>. You may also use the <quote>Show messages ...</quote> | ||||
410 | and <quote>Allow remote content ...</quote> options to fine-tune the way &kmail; handles email you receive | ||||
411 | from each contact. See <link linkend="integration-with-other-kde-programs">chapter 3</link> for a more | ||||
412 | complete explanation. | ||||
413 | </para></step> | ||||
414 | | ||||
415 | </procedure> | ||||
416 | </sect1> | ||||
417 | | ||||
418 | </chapter> | ||||
419 | | ||||
420 | <chapter id="integration-with-other-kde-programs"> | ||||
421 | <title>Integration With Other &kde; Programs</title> | ||||
422 | | ||||
Please add <chapter id="credits">, see lueck: Please add <chapter id="credits">, see
https://cgit.kde.org/kdoctools.git/tree/src/template. | |||||
423 | <sect1 id="integration-overview"> | ||||
424 | <title>Integration Overview -- &kmail;</title> | ||||
425 | | ||||
426 | <para> | ||||
427 | Because &kaddressbook; -- an integral part of &PIM;, &kde;'s suite of Personal Information Management programs -- | ||||
428 | is the central repository for information about all your contacts, it has been integrated into &kmail; and also | ||||
429 | into &korganizer;. Here is a quick look at the interface between &kaddressbook; and those two programs. | ||||
430 | </para> | ||||
431 | | ||||
432 | <sect2 id="starting-kaddressbook-from-kmail-tools"> | ||||
433 | <title>Starting &kaddressbook; from &kmail;'s Tools Menu</title> | ||||
434 | | ||||
435 | <para> | ||||
436 | <screenshot id="screenshot-kmail-tools-menu"> | ||||
KAddressBook -> Help -> About KAddressBook reads: lueck: KAddressBook -> Help -> About KAddressBook reads:
"Copyright © 2007–2019 KAddressBook authors"… | |||||
437 | <screeninfo>A screenshot of &kmail;'s <menuchoice><guimenu>Tools</guimenu><guimenuitem>Address Book</guimenuitem></menuchoice> option.</screeninfo> | ||||
438 | <mediaobject> | ||||
439 | <imageobject> | ||||
440 | <imagedata fileref="addressbook50.png" format="PNG"/> | ||||
441 | </imageobject> | ||||
442 | <textobject> | ||||
443 | <phrase>A screenshot of &kmail;'s <menuchoice><guimenu>Tools</guimenu><guimenuitem>Address Book</guimenuitem></menuchoice> option.</phrase> | ||||
444 | </textobject> | ||||
lueck: Please remove these lines, it is just a placeholder from the template | |||||
445 | <caption> | ||||
446 | <para>Launching &kaddressbook; from &kmail;'s <menuchoice><guimenu>Tools</guimenu><guimenuitem>Address Book</guimenuitem></menuchoice> menu choice.</para> | ||||
447 | </caption> | ||||
448 | </mediaobject> | ||||
449 | </screenshot> | ||||
450 | </para> | ||||
451 | | ||||
452 | <para> </para> <!-- add more white space after screenshot @dcb --> | ||||
453 | | ||||
454 | <para>This interface is the epitome of simplicity. Need to consult or update the entry for one of your contacts while reading | ||||
455 | or composing an email message with &kmail;? Left click <menuchoice><guimenu>Tools</guimenu><guimenuitem>Address Book</guimenuitem> | ||||
456 | </menuchoice>, and the &kaddressbook; application will be launched automatically, allowing quick access to the contact | ||||
457 | data you want to view or modify.</para> | ||||
458 | | ||||
459 | <para> </para> <!-- add more white space before next section @dcb --> | ||||
460 | | ||||
461 | </sect2> | ||||
462 | | ||||
463 | <sect2 id="autocompletion-feature-on-new-email"> | ||||
464 | <title>Querying &kaddressbook; from &kmail;'s Message Composition Window</title> | ||||
465 | | ||||
466 | <para> | ||||
467 | <screenshot id="screenshot-autocompletion-feature"> | ||||
468 | <screeninfo>A screenshot of autocompletion from inside &kmail;'s message composition window.</screeninfo> | ||||
469 | <mediaobject> | ||||
470 | <imageobject> | ||||
471 | <imagedata fileref="addressbook51.png" format="PNG"/> | ||||
472 | </imageobject> | ||||
473 | <textobject> | ||||
474 | <phrase>A screenshot of autocompletion from inside &kmail;'s message composition window.</phrase> | ||||
475 | </textobject> | ||||
476 | <caption> | ||||
477 | <para>Using &kaddressbook;'s autocompletion feature from inside &kmail;'s message composition window.</para> | ||||
478 | </caption> | ||||
479 | </mediaobject> | ||||
480 | </screenshot> | ||||
481 | </para> | ||||
482 | | ||||
483 | <para> </para> <!-- add more white space after screenshot @dcb --> | ||||
484 | | ||||
485 | <para>When you are composing a new email message, &kmail; helps you find the recipient's complete email | ||||
486 | address by presenting a list of probable matches drawn from the contents of &kaddressbook; and from | ||||
487 | your email archives, as illustrated above. Just left click an item in the list to use that email address.</para> | ||||
488 | | ||||
489 | <para> </para> <!-- add more white space before next section @dcb --> | ||||
490 | | ||||
491 | </sect2> | ||||
492 | | ||||
493 | <sect2 id="recipient-selection-dialog"> | ||||
494 | <title>&kmail;'s Recipient Selection Dialog</title> | ||||
495 | | ||||
496 | <para> | ||||
497 | <screenshot id="screenshot-recipient-selection"> | ||||
498 | <screeninfo>A screenshot of the recipient selection dialog inside &kmail;'s message composition window.</screeninfo> | ||||
499 | <mediaobject> | ||||
500 | <imageobject> | ||||
501 | <imagedata fileref="addressbook52.png" format="PNG"/> | ||||
502 | </imageobject> | ||||
503 | <textobject> | ||||
504 | <phrase>A screenshot of the recipient selection dialog inside &kmail;'s message composition window.</phrase> | ||||
505 | </textobject> | ||||
506 | <caption> | ||||
507 | <para>Selecting multiple addressees with the recipient selection dialog inside &kmail;'s message composition window.</para> | ||||
508 | </caption> | ||||
509 | </mediaobject> | ||||
510 | </screenshot> | ||||
511 | </para> | ||||
512 | | ||||
513 | <para> </para> <!-- add more white space after screenshot @dcb --> | ||||
514 | | ||||
515 | <para>When you are addressing a new email message to multiple recipients, &kmail; provides a convenient method | ||||
516 | of choosing multiple addressees from the contacts you have saved with &kaddressbook;. Simply left click the | ||||
517 | <guibutton> Select ... </guibutton> button to open a Drop Down Box that lists all the contacts in the | ||||
518 | selected address books. Then scroll through the list (or use the handy <quote>Search:</quote> box), select | ||||
519 | the recipient you want, and left click <guibutton> Add as To </guibutton>, | ||||
520 | <guibutton> Add as CC </guibutton>, or <guibutton> Add as BCC </guibutton> to add | ||||
521 | this person to the list of email recipients for your new message.</para> | ||||
522 | | ||||
523 | <para> </para> <!-- add more white space before next section @dcb --> | ||||
524 | | ||||
525 | </sect2> | ||||
526 | | ||||
527 | <sect2 id="new-contact-creation-interface"> | ||||
528 | <title>&kmail;'s New Contact Creation Interface</title> | ||||
529 | | ||||
530 | <para> | ||||
531 | <screenshot id="screenshot-new-contact-creation"> | ||||
532 | <screeninfo>A screenshot of the new contact creation interface inside &kmail;'s message viewing window.</screeninfo> | ||||
533 | <mediaobject> | ||||
534 | <imageobject> | ||||
535 | <imagedata fileref="addressbook53.png" format="PNG"/> | ||||
536 | </imageobject> | ||||
537 | <textobject> | ||||
538 | <phrase>A screenshot of the new contact creation interface inside &kmail;'s message viewing window.</phrase> | ||||
539 | </textobject> | ||||
540 | <caption> | ||||
541 | <para>Invoking the new contact creation dialog from &kmail;'s message viewing window.</para> | ||||
542 | </caption> | ||||
543 | </mediaobject> | ||||
544 | </screenshot> | ||||
545 | </para> | ||||
546 | | ||||
547 | <para> </para> <!-- add more white space after screenshot @dcb --> | ||||
548 | <para>When you receive an email message from someone who is not yet in your address book, &kmail; makes it very | ||||
549 | easy to create a new contact. Simply point your cursor at the email address you want to save, then click the &RMB; and | ||||
550 | a context menu will appear (see above). Select <guimenuitem> + Add to Address Book </guimenuitem> | ||||
551 | to add the selected email address to one of your address books. If you recognize this person as somebody who's already | ||||
552 | in your address book, and he is using a new email address, you may click on <guimenuitem> + Add to Existing Contact </guimenuitem> | ||||
553 | instead -- this enters a dialog that will direct &kaddressbook; to the spot where you want to insert the new email address.</para> | ||||
554 | <para> </para> <!-- add more white space before next picture @dcb --> | ||||
555 | | ||||
556 | <para> | ||||
557 | <screenshot id="screenshot-new-contact-creation-step2"> | ||||
558 | <screeninfo>A screenshot of the ensuing new contact creation dialog.</screeninfo> | ||||
559 | <mediaobject> | ||||
560 | <imageobject> | ||||
561 | <imagedata fileref="addressbook54.png" format="PNG"/> | ||||
562 | </imageobject> | ||||
563 | <textobject> | ||||
564 | <phrase>A screenshot of the ensuing new contact creation dialog.</phrase> | ||||
565 | </textobject> | ||||
566 | <caption> | ||||
567 | <para>Choosing the address book in which the new contact will be created.</para> | ||||
568 | </caption> | ||||
569 | </mediaobject> | ||||
570 | </screenshot> | ||||
571 | </para> | ||||
572 | | ||||
573 | <para> </para> <!-- add more white space after screenshot @dcb --> | ||||
574 | <para>&kmail; will ask you to choose the address book to which the new contact should be added.</para> | ||||
575 | <para> </para> <!-- add more white space before next picture @dcb --> | ||||
576 | | ||||
577 | <para> | ||||
578 | <screenshot id="screenshot-new-contact-creation-step3"> | ||||
579 | <screeninfo>Another screenshot of the ensuing new contact creation dialog.</screeninfo> | ||||
580 | <mediaobject> | ||||
581 | <imageobject> | ||||
582 | <imagedata fileref="addressbook55.png" format="PNG"/> | ||||
583 | </imageobject> | ||||
584 | <textobject> | ||||
585 | <phrase>Another screenshot of the ensuing new contact creation dialog.</phrase> | ||||
586 | </textobject> | ||||
587 | <caption> | ||||
588 | <para>Deciding if you would like to edit the newly created contact now, or later.</para> | ||||
589 | </caption> | ||||
590 | </mediaobject> | ||||
591 | </screenshot> | ||||
592 | </para> | ||||
593 | | ||||
594 | <para> </para> <!-- add more white space after screenshot @dcb --> | ||||
595 | <para>&kmail; will also ask you if you wish to <link linkend="editing-contact-data"> edit the new contact</link> | ||||
596 | that has just been added. Say <guibutton> ✔ Yes </guibutton> if you want to add more data to the | ||||
597 | new entry right away.</para> | ||||
598 | <para> </para> <!-- add more white space before next section @dcb --> | ||||
599 | | ||||
600 | </sect2> | ||||
601 | </sect1> | ||||
602 | | ||||
603 | <sect1 id="korganizer-overview"> | ||||
604 | <title>&kaddressbook;'s Interface with &korganizer;</title> | ||||
605 | | ||||
606 | <para>&korganizer;, the &kde; scheduling and calendar maagement program, allows you | ||||
yurchor: Typo: maagement -> management | |||||
607 | to send e-mail messages to people you want to invite to a meeting, and provides | ||||
608 | two interfaces with &kaddressbook; in this connection.</para> | ||||
609 | <para> </para> <!-- add more white space before next section @dcb --> | ||||
610 | | ||||
611 | <para> | ||||
612 | <screenshot id="screenshot-inviting-one-attendee"> | ||||
613 | <screeninfo>A screenshot of &korganizer;'s attendees tab.</screeninfo> | ||||
614 | <mediaobject> | ||||
615 | <imageobject> | ||||
616 | <imagedata fileref="addressbook60.png" format="PNG"/> | ||||
617 | </imageobject> | ||||
618 | <textobject> | ||||
619 | <phrase>A screenshot of &korganizer;'s attendees tab.</phrase> | ||||
620 | </textobject> | ||||
621 | <caption> | ||||
622 | <para>Adding a single attendee to a scheduled meeting in &korganizer;.</para> | ||||
623 | </caption> | ||||
624 | </mediaobject> | ||||
625 | </screenshot> | ||||
626 | </para> | ||||
627 | | ||||
628 | <para> </para> <!-- add more white space after screenshot @dcb --> | ||||
629 | <para>The first interface is just like the <link linkend="autocompletion-feature-on-new-email">autocompletion | ||||
630 | feature</link> provided by &kmail;: just start typing the name of the person you want to invite, and you will | ||||
631 | be presented with a list of probable matches, as illustrated above.</para> | ||||
632 | <para> </para> <!-- add more white space before next section @dcb --> | ||||
633 | | ||||
634 | <para> | ||||
635 | <screenshot id="screenshot-inviting-multiple-attendees"> | ||||
636 | <screeninfo>A screenshot of &korganizer;'s attendees tab.</screeninfo> | ||||
637 | <mediaobject> | ||||
638 | <imageobject> | ||||
639 | <imagedata fileref="addressbook61.png" format="PNG"/> | ||||
640 | </imageobject> | ||||
641 | <textobject> | ||||
642 | <phrase>A screenshot of &korganizer;'s attendees tab.</phrase> | ||||
643 | </textobject> | ||||
644 | <caption> | ||||
645 | <para>Adding multiple attendees to a scheduled meeting in &korganizer;.</para> | ||||
646 | </caption> | ||||
647 | </mediaobject> | ||||
648 | </screenshot> | ||||
649 | </para> | ||||
650 | | ||||
651 | <para> </para> <!-- add more white space after screenshot @dcb --> | ||||
652 | <para>The second interface is just like the <link linkend="recipient-selection-dialog">recipient selection | ||||
653 | dialog</link> provided by &kmail;: when you left click the <guibutton> Select Attendees ... </guibutton> | ||||
654 | button, a searchable list of the contacts in all your address books will appear, as the preceding screenshot shows.</para> | ||||
655 | | ||||
656 | </sect1> | ||||
657 | | ||||
658 | </chapter> | ||||
659 | | ||||
660 | <chapter id="editing-contact-data"> | ||||
661 | <title>Editing Contact Data</title> | ||||
662 | <para> </para> | ||||
663 | </chapter> | ||||
664 | | ||||
665 | <chapter id="commands"> | ||||
666 | <title>Command Reference</title> | ||||
667 | <para> </para> | ||||
668 | </chapter> | ||||
669 | | ||||
670 | <chapter id="credits"> | ||||
671 | <title>Credits and Licenses</title> | ||||
672 | | ||||
673 | <para> | ||||
674 | &kaddressbook; | ||||
675 | </para> | ||||
676 | | ||||
677 | <para> | ||||
678 | Copyright © 2007–2019 KAddressBook authors <email>montel@kde.org</email> | ||||
679 | </para> | ||||
680 | | ||||
681 | <para> | ||||
682 | Documentation Copyright © 2019 David C. Bryant <email>davidbryant@gvtc.com</email> | ||||
683 | </para> | ||||
684 | | ||||
685 | <!-- TRANS:CREDIT_FOR_TRANSLATORS --> | ||||
686 | | ||||
687 | <!-- License for new documents after 2017-07-27 (or relicensed) --> | ||||
688 | | ||||
689 | &underCCBYSA4; <!-- CC BY-SA 4.0: do not remove --> | ||||
690 | | ||||
691 | </chapter> | ||||
692 | | ||||
693 | </book> | ||||
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… | |||||
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… |
please add a line with:
<title>The &kaddressbook; Handbook</title>