Differential D22799 Diff 66263 doc/docbook-reference.docbook

Changeset View

Standalone View

View Options

doc/docbook-reference.docbook

  • This file was added.
1​<appendix id="docbook-reference">
2​
3​<appendixinfo>
4​
5​<authorgroup>
6​
7​ <author>
8​ <firstname>David</firstname>
9​ <othername>C.</othername>
10​ <surname>Bryant</surname>
11​ <affiliation><address><email>davidbryant@gvtc.com</email></address></affiliation>
12​ </author>
13​
14​<!-- TRANS:ROLES_OF_TRANSLATORS -->
15​
16​</authorgroup>
17​
18​<copyright>
19​ <year>2019</year>
20​ <holder>David C. Bryant</holder>
21​</copyright>
22​
23​<legalnotice>&CCBYSA4Notice;</legalnotice>
24​
25​<date>2019-08-26</date>
26​<releaseinfo>5.10.3 (Applications 18.12.3)</releaseinfo>
27​
28​<abstract>
29​ <para>&kaddressbook; is a very complicated program with lots of built-in features.
30​ Some of the more advanced features of &kaddressbook; are documented in this appendix,
31​ primarily to keep the main document from getting too large and unwieldy.
32​ </para>
33​</abstract>
34​
35​<!--TODO Note to self: add more keywords later. -->
36​<keywordset>
37​ <keyword>KDE</keyword>
38​ <keyword>KAddressBook</keyword>
39​ <keyword>kdepim</keyword>
40​ <keyword>Email</keyword>chapter
41​</keywordset>
42​
43​</appendixinfo>
44​
45​<title>&kaddressbook; Advanced Features Reference Section</title>
46​
47​<sect1 id="placeholder">
48​<title></title>
49​</sect1> <!-- Force a page break after Table of Contents. dcb -->
50​
51​<sect1 id="file-new-group">
52​<title>The New Group Dialog</title>
53​
54​ <para>When you invoke the <guibutton><inlinemediaobject><imageobject><imagedata fileref="user-group-new.png" format="PNG"/>
55​ </imageobject></inlinemediaobject>New Group</guibutton> function, a dialog will begin, as shown below.</para>
56​
57​ <para>
58​ <screenshot id="screenshot-new-group">
59​ <screeninfo>A screenshot of &kaddressbook;'s <quote>New Group</quote> dialog.</screeninfo>
60​ <mediaobject>
61​ <imageobject>
62​ <imagedata fileref="addressbook101.png" format="PNG"/>
63​ </imageobject>
64​ <textobject>
65​ <phrase>A screenshot of &kaddressbook;'s <quote>New Group</quote> dialog.</phrase>
66​ </textobject>
67​ <caption>
68​ <para>&kaddressbook;'s <quote>New Group</quote> dialog after choosing the <menuchoice><guimenu>File</guimenu><guisubmenu>New&nbsp;
69​ &nbsp;&gt;</guisubmenu><guimenuitem><inlinemediaobject><imageobject><imagedata fileref="user-group-new.png" format="PNG"/>
70​ </imageobject></inlinemediaobject>New Group</guimenuitem></menuchoice> function.</para>
71​ </caption>
72​ </mediaobject>
73​ </screenshot>
74​ </para>
75​
76​ <para>&nbsp;</para> <!-- add more white space after screenshot @dcb -->
77​
78​ <para>Use the <quote>Add To:</quote> drop-down box to choose the address book to which the new group should be added. Use the
79​ <quote>Name</quote> field to give the new group a name. Enter e-mail addresses, or portions of email addresses, in the blue
80​ <quote>&plus;</quote> area. A list of potential matches will appear. Select an item in the list that pops up, and a new name
81​ will be added to the list. Continue adding individual contacts to the list until it is complete, then click the
82​ <guibutton>&nbsp;✔&nbsp;OK&nbsp;</guibutton> button to add this group to your address book. If you want to delete a name from
83​ the list, click the <inlinemediaobject><imageobject><imagedata fileref="list-remove.png" format="PNG"/></imageobject>
84​ </inlinemediaobject> icon to the right of that particular name. If you need to make changes to the group later, simply select
85​ the group and use the <quote>Edit</quote> menu, or the <quote>Edit Contact</quote> button on the toolbar, to open a substantially
86​ similar dialog that will let you make the desired changes.</para>
87​
88​ <para>The &kmail; program provides an alternative method of creating a new group in &kaddressbook;. After you have addressed an e-mail
89​ message to several people, you are given the option of adding a new group to your address book, as shown below.</para>
90​
91​ <para>
92​ <screenshot id="screenshot-new-group-via-kmail">
93​ <screeninfo>A screenshot of &kmail;'s <quote>New Group</quote> dialog.</screeninfo>
94​ <mediaobject>
95​ <imageobject>
96​ <imagedata fileref="addressbook102.png" format="PNG"/>
97​ </imageobject>
98​ <textobject>
99​ <phrase>A screenshot of &kmail;'s <quote>New Group</quote> dialog.</phrase>
100​ </textobject>
101​ <caption>
102​ <para>&kmail;'s <quote>New Group</quote> dialog after choosing the <guibutton>&nbsp;Save List...
103​ &nbsp;</guibutton> function.</para>
104​ </caption>
105​ </mediaobject>
106​ </screenshot>
107​ </para>
108​
109​ <para>&nbsp;</para> <!-- add more white space after screenshot @dcb -->
110​
111​ <para>After addressing a message to a group of people, clicking the <guibutton>&nbsp;Save List...&nbsp;</guibutton>
112​ button to the right of the address input area will cause the illustrated dialog box to appear. Give the list a name
113​ and left click the <guibutton>&nbsp;Save List&nbsp;</guibutton> button. Another dialog box will pop up, asking you
114​ to select an address book. Make your selection, and a new group will be created for you.</para>
115​
116​ <para><link linkend="docbook-reference">Click here to return to the Table of Contents for this Appendix.</link></para>
117​
118​</sect1>
119​
120​<sect1 id="file-print-preview">
121​<title>The Print-Preview Dialog</title>
122​
123​ <para>&kaddressbook;'s <quote>Print Preview</quote> function lets you tailor a hard-copy of your address book
124​ data just about any way you want.</para>
125​
126​ <para>
127​ <screenshot id="screenshot-print-preview-a">
128​ <screeninfo>A screenshot of &kaddressbook;'s <quote>Print Preview</quote> dialog.</screeninfo>
129​ <mediaobject>
130​ <imageobject>
131​ <imagedata fileref="addressbook120.png" format="PNG"/>
132​ </imageobject>
133​ <textobject>
134​ <phrase>A screenshot of &kaddressbook;'s <quote>Print Preview</quote> dialog.</phrase>
135​ </textobject>
136​ <caption>
137​ <para>&kaddressbook;'s <quote>Print Preview</quote> dialog. You may select one or more entire
138​ address books, or just a smattering of individual contacts.</para>
139​ </caption>
140​ </mediaobject>
141​ </screenshot>
142​ </para>
143​
144​ <para>&nbsp;</para> <!-- add more white space after screenshot @dcb -->
145​
146​ <para>The first step is to select the contacts to be included in the printout. If you wish to print just a
147​ smattering of individual contacts, you must choose the contacts to be printed before invoking the
148​ <menuchoice><guisubmenu><inlinemediaobject><imageobject><imagedata fileref="document-preview-archive.png"
149​ format="PNG"/></imageobject></inlinemediaobject>Print Preview</guisubmenu></menuchoice> dialog. If you wish
150​ to select all your contacts, or all the contacts in a particular address book, you can do it here. Click
151​ <guibutton><inlinemediaobject><imageobject><imagedata fileref="go-next.png" format="PNG"/></imageobject>
152​ </inlinemediaobject>Next</guibutton> when you have made your selection. A new screen will appear.</para>
153​
154​ <para>
155​ <screenshot id="screenshot-print-preview-b">
156​ <screeninfo>A second screenshot of &kaddressbook;'s <quote>Print Preview</quote> dialog.</screeninfo>
157​ <mediaobject>
158​ <imageobject>
159​ <imagedata fileref="addressbook121.png" format="PNG"/>
160​ </imageobject>
161​ <textobject>
162​ <phrase>A screenshot of &kaddressbook;'s <quote>Print Preview</quote> dialog.</phrase>
163​ </textobject>
164​ <caption>
165​ <para>The second screen in &kaddressbook;'s <quote>Print Preview</quote> dialog. You may choose a sort field
166​ and a sort direction (up or down). You may also choose among seven different print layouts.</para>
167​ </caption>
168​ </mediaobject>
169​ </screenshot>
170​ </para>
171​
172​ <para>&nbsp;</para> <!-- add more white space after screenshot @dcb -->
173​
174​ <para>Here you can choose a sort field (any one of the 47 named fields in the contact record), the
175​ direction of the sort, and any one of seven different report formats. When you click <guibutton>
176​ <inlinemediaobject><imageobject><imagedata fileref="go-next.png" format="PNG"/></imageobject>
177​ </inlinemediaobject>Next</guibutton>, you will be given a chance to tailor the color scheme to
178​ be used.</para>
179​
180​ <para>
181​ <screenshot id="screenshot-print-preview-c">
182​ <screeninfo>A third screenshot of &kaddressbook;'s <quote>Pint Preview</quote> dialog.</screeninfo>
183​ <mediaobject>
184​ <imageobject>
185​ <imagedata fileref="addressbook122.png" format="PNG"/>
186​ </imageobject>
187​ <textobject>
188​ <phrase>A third screenshot of &kaddressbook;'s <quote>Print Preview</quote> dialog.</phrase>
189​ </textobject>
190​ <caption>
191​ <para>The third screen in &kaddressbook;'s <quote>Print Preview</quote> dialog. You may select a
192​ color scheme here.</para>
193​ </caption>
194​ </mediaobject>
195​ </screenshot>
196​ </para>
197​
198​ <para>&nbsp;</para> <!-- add more white space after screenshot @dcb -->
199​
200​ <para>Here is a picture of the completed report. It is now ready for printing.</para>
201​
202​ <para>
203​ <screenshot id="screenshot-print-preview-d">
204​ <screeninfo>A screenshot of &kaddressbook;'s <quote>Pint Preview</quote> dialog.</screeninfo>
205​ <mediaobject>
206​ <imageobject>
207​ <imagedata fileref="addressbook123.png" format="PNG"/>
208​ </imageobject>
209​ <textobject>
210​ <phrase>A screenshot of &kaddressbook;'s <quote>Print Preview</quote> dialog.</phrase>
211​ </textobject>
212​ <caption>
213​ <para>&kaddressbook;'s <quote>Print Preview</quote> after the report has been generated and
214​ is ready to print. You may select alternative print orientations (landscape or portrait) and
215​ launch the print task from this window.</para>
216​ </caption>
217​ </mediaobject>
218​ </screenshot>
219​ </para>
220​
221​ <para>&nbsp;</para> <!-- add more white space after screenshot @dcb -->
222​
223​ <para><link linkend="docbook-reference">Click here to return to the Table of Contents for this Appendix.</link></para>
224​
225​</sect1>
226​
227​<sect1 id="configure-ldap-server">
228​<title>The Configure LDAP Dialog</title>
229​
230​ <para>Add verbiage here about configuration of an LDAP server.</para>
231​
232​ <para><link linkend="docbook-reference">Click here to return to the Table of Contents for this Appendix.</link></para>
233​
234​</sect1>
235​
236​<sect1 id="import-csv-data">
237​<title>The Import CSV File Function</title>
238​
239​ <para>When you choose the <menuchoice><guimenu>File</guimenu><guisubmenu>Import&nbsp; &nbsp;&gt;</guisubmenu>
240​ <guimenuitem>Import CSV file...</guimenuitem></menuchoice> function, you will be presented with a dialog.
241​ After you click the <guibutton><inlinemediaobject><imageobject><imagedata fileref="document-open.png" format="PNG"/>
242​ </imageobject></inlinemediaobject></guibutton> button and choose the file to be imported, the screen will
243​ look like this.</para>
244​
245​ <para>
246​ <screenshot id="screenshot-import-csv">
247​ <screeninfo>A screenshot of &kaddressbook;'s <quote>Import CSV File</quote> dialog.</screeninfo>
248​ <mediaobject>
249​ <imageobject>
250​ <imagedata fileref="addressbook103.png" format="PNG"/>
251​ </imageobject>
252​ <textobject>
253​ <phrase>A screenshot of &kaddressbook;'s <quote>Import CSV File</quote> dialog.</phrase>
254​ </textobject>
255​ <caption>
256​ <para>&kaddressbook;'s <quote>Import CSV File</quote> dialog after choosing the <menuchoice><guimenu>File</guimenu><guisubmenu>Import&nbsp;
257​ &nbsp;&gt;</guisubmenu><guimenuitem>Import CSV file...</guimenuitem></menuchoice> function and selecting the file to be imported.</para>
258​ </caption>
259​ </mediaobject>
260​ </screenshot>
261​ </para>
262​
263​ <para>&nbsp;</para> <!-- add more white space after screenshot @dcb -->
264​
265​ <para>Use the <quote>Delimiter</quote> section of this dialog to specify which separator character defines the end of a field in the
266​ chosen input file. If quote marks are used to delimit fields with embedded separator characters, you may specify the style (single
267​ or double quote) used via the <quote>Text quote:</quote> drop-down box. If the input file contains dates, use the <quote>Date format:</quote>
268​ field to define the way dates have been encoded. The default is yyyy-mm-dd. If that's the wrong format, hover your cursor over the
269​ <quote>Date format:</quote> box and a handy set of formatting instructions will be displayed. If the input file is not UTF-8 encoded,
270​ use the <quote>Text codec:</quote> drop-down box to specify the binary encoding scheme to use. If the first row of the file contains
271​ column headers, check the <quote>Skip first row of file</quote> box to avoid importing the column headers as data. Use the
272​ <quote>Undefined</quote> boxes at the top of each column to specify which data fields are to be imported, and where they should be
273​ stored, as shown below.</para>
274​
275​ <para>
276​ <screenshot id="screenshot-import-csv-2">
277​ <screeninfo>A second screenshot of &kaddressbook;'s <quote>Import CSV File</quote> dialog.</screeninfo>
278​ <mediaobject>
279​ <imageobject>
280​ <imagedata fileref="addressbook104.png" format="PNG"/>
281​ </imageobject>
282​ <textobject>
283​ <phrase>A second screenshot of &kaddressbook;'s <quote>Import CSV File</quote> dialog.</phrase>
284​ </textobject>
285​ <caption>
286​ <para>&kaddressbook;'s <quote>Import CSV File</quote> dialog after choosing the <menuchoice><guimenu>File</guimenu><guisubmenu>Import&nbsp;
287​ &nbsp;&gt;</guisubmenu><guimenuitem>Import CSV file...</guimenuitem></menuchoice> function, selecting the file to be imported, and
288​ beginning to define the fields to be imported.</para>
289​ </caption>
290​ </mediaobject>
291​ </screenshot>
292​ </para>
293​
294​ <para>&nbsp;</para> <!-- add more white space after screenshot @dcb -->
295​
296​ <para>If you wish the contents of the current column to be imported, choose a destination from the list of field names appearing beneath the
297​ blue <quote>Undefined</quote> box. See <link linkend="export-csv-data">the next section</link> for a list of the pre-defined fields. Use the
298​ horizontal scrollbar near the bottom of the dialog to view all the columns in the input file. When your selections are complete, click the
299​ <guibutton>&nbsp;✔&nbsp;OK&nbsp;</guibutton> button. If you have defined multiple address books, you will be asked to specify which address
300​ book is to be used. &kaddressbook; will then import the selected data as new contacts.</para>
301​
302​ <para>If you intend to import additional datasets in the same format sometime in the future, you may click the <guibutton>Save template...</guibutton>
303​ button (cf. the first illustration in this section) to save the selections you have made. You will be prompted to give the template a name.
304​ Later, when you import another file with the same layout, you can save time by clicking the <guibutton>Apply template...</guibutton> button.</para>
305​
306​ <para><link linkend="docbook-reference">Click here to return to the Table of Contents for this Appendix.</link></para>
307​
308​</sect1>
309​
310​<sect1 id="export-csv-data">
311​<title>The Export CSV File Function</title>
312​
313​ <para>When you invoke the <menuchoice><guimenu>File</guimenu><guisubmenu>Export&nbsp;&nbsp;&gt;</guisubmenu><guimenuitem>Export
314​ <acronym>CSV</acronym> file ...</guimenuitem></menuchoice> function, a dialog box appears.</para>
315​
316​ <para>
317​ <screenshot id="screenshot-export-csv">
318​ <screeninfo>A screenshot of &kaddressbook;'s <quote>Export CSV File</quote> dialog.</screeninfo>
319​ <mediaobject>
320​ <imageobject>
321​ <imagedata fileref="addressbook100.png" format="PNG"/>
322​ </imageobject>
323​ <textobject>
324​ <phrase>A screenshot of &kaddressbook;'s <quote>Export CSV File</quote> dialog.</phrase>
325​ </textobject>
326​ <caption>
327​ <para>&kaddressbook;'s <quote>Export CSV File</quote> dialog after choosing the <menuchoice><guimenu>File</guimenu><guisubmenu>Export&nbsp;
328​ &nbsp;&gt;</guisubmenu><guimenuitem>Export <acronym>CSV</acronym> file ...</guimenuitem></menuchoice> function.</para>
329​ </caption>
330​ </mediaobject>
331​ </screenshot>
332​ </para>
333​
334​ <para>&nbsp;</para> <!-- add more white space after screenshot @dcb -->
335​
336​ <para>You may select all your contact data, or just a portion of it. When you press the <guibutton>&nbsp;✔&nbsp;OK&nbsp;</guibutton> button,
337​ you will be allowed to choose the name of the generated file, and the directory in which it will be written. The output file will contain the
338​ following forty-seven (47) output fields, in this order, left to right. This list of field names is included as the first record in the file.</para>
339​
340​ <para>Formatted Name | Honorific Prefixes | Given Name | Additional Names | Family Name | Honorific Suffixes | Nick Name | Birthday | Anniversary |
341​ EMail (preferred) | EMail (2) | EMail (3) | EMail (4) | Home Address Street | Home Address Post Office Box | Home Address City | Home Address State |
342​ Home Address Zip Code | Home Address Country | Home Address Label | Business Address Street | Business Address Post Office Box | Business Address City |
343​ Business Address State | Business Address Zip Code | Business Address Country | Business Address Label | Home Phone | Business Phone | Mobile Phone |
344​ Home Fax | Business Fax | Car Phone | ISDN | Pager | Mail Client | Title | Role | Organization | Note | Homepage | Blog Feed | Profession | Office |
345​ Manager | Assistant | Spouse</para>
346​
347​ <para>All fields are formatted as character class data. Dates (Birthday and Anniversary, if present) are coded as
348​ yyyy-mm-dd (Year, Month, Day).</para>
349​
350​ <para><link linkend="docbook-reference">Click here to return to the Table of Contents for this Appendix.</link></para>
351​
352​
353​</sect1>
354​
355​<sect1 id="view-change-columns">
356​<title>The Change Number of Columns Function</title>
357​
358​ <para>When you open the <menuchoice><guimenu>View</guimenu></menuchoice> menu, the following screen appears.</para>
359​
360​ <para>
361​ <screenshot id="screenshot-view-menu-appendix">
362​ <screeninfo>A screenshot of &kaddressbook;'s <quote>View</quote> menu.</screeninfo>
363​ <mediaobject>
364​ <imageobject>
365​ <imagedata fileref="addressbook82.png" format="PNG"/>
366​ </imageobject>
367​ <textobject>
368​ <phrase>A screenshot of &kaddressbook;'s <quote>View</quote> menu.</phrase>
369​ </textobject>
370​ <caption>
371​ <para>&kaddressbook;'s <quote>View</quote> menu after choosing the <menuchoice><guimenu>View</guimenu></menuchoice>
372​ menu on the main Menubar.</para>
373​ </caption>
374​ </mediaobject>
375​ </screenshot>
376​ </para>
377​
378​ <para>&nbsp;</para> <!-- add more white space after screenshot @dcb -->
379​
380​ <para>Not happy with the hum-drum three column layout appearing above? Jazz things up a little with this minimalist approach.</para>
381​
382​ <para>
383​ <screenshot id="screenshot-view-menu-appendix-2">
384​ <screeninfo>A screenshot of &kaddressbook;'s single panel layout.</screeninfo>
385​ <mediaobject>
386​ <imageobject>
387​ <imagedata fileref="addressbook110.png" format="PNG"/>
388​ </imageobject>
389​ <textobject>
390​ <phrase>A screenshot of &kaddressbook;'s single panel layout.</phrase>
391​ </textobject>
392​ <caption>
393​ <para>&kaddressbook;'s <quote>Simple (one column)</quote> layout. Only the basic contact
394​ data are visible.</para>
395​ </caption>
396​ </mediaobject>
397​ </screenshot>
398​ </para>
399​
400​ <para>&nbsp;</para> <!-- add more white space after screenshot @dcb -->
401​
402​ <para>Notice that the information about which address books exist and are in use is not visible when this <quote>Simple</quote>
403​ layout is in effect. Only the contacts from the address books that were selected before choosing this view are displayed.</para>
404​
405​ <para>&nbsp;</para> <!-- add more white space @dcb -->
406​
407​ <para>If the <quote>Simple</quote> layout does not appeal to you, you may want to try the <quote>Two columns</quote> style.</para>
408​
409​ <para>
410​ <screenshot id="screenshot-view-menu-appendix-3">
411​ <screeninfo>A screenshot of &kaddressbook;'s double panel layout.</screeninfo>
412​ <mediaobject>
413​ <imageobject>
414​ <imagedata fileref="addressbook111.png" format="PNG"/>
415​ </imageobject>
416​ <textobject>
417​ <phrase>A screenshot of &kaddressbook;'s double panel layout.</phrase>
418​ </textobject>
419​ <caption>
420​ <para>&kaddressbook;'s <quote>Two columns</quote> layout. The list of address books is
421​ stacked on top of the alphabetized contact list.</para>
422​ </caption>
423​ </mediaobject>
424​ </screenshot>
425​ </para>
426​
427​ <para>&nbsp;</para> <!-- add more white space after screenshot @dcb -->
428​
429​ <para> At &kde;, our motto is "Be Free!" We aim to give you maximum flexibility when it comes to tailoring
430​ and configuring our software to suit your tastes. We toyed with the idea of adding even more views to
431​ &kaddressbook; (Four columns! Five!), but eventually concluded that enough is enough.</para>
432​
433​ <para>&nbsp;</para> <!-- add more white space @dcb -->
434​
435​ <para><link linkend="docbook-reference">Click here to return to the Table of Contents for this Appendix.</link></para>
436​
437​</sect1>
438​
439​<sect1 id="settings-configure-shortcuts">
440​<title>The Configure Shortcuts Option</title>
441​
442​ <para>When you first select the <menuchoice><guimenu>Settings</guimenu><guisubmenu><inlinemediaobject><imageobject>
443​ <imagedata fileref="input-keyboard.png" format="PNG"/></imageobject></inlinemediaobject>Configure Shortcuts...</guisubmenu>
444​ </menuchoice> option, this is what you will see.</para>
445​
446​ <para>
447​ <screenshot id="screenshot-config-shortcut1">
448​ <screeninfo>A screenshot of &kaddressbook;'s <quote>Configure Shortcuts</quote> dialog.</screeninfo>
449​ <mediaobject>
450​ <imageobject>
451​ <imagedata fileref="addressbook112.png" format="PNG"/>
452​ </imageobject>
453​ <textobject>
454​ <phrase>A screenshot of &kaddressbook;'s <quote>Configure Shortcuts</quote> dialog.</phrase>
455​ </textobject>
456​ <caption>
457​ <para>&kaddressbook;'s <quote>Configure Shortcuts</quote> dialog. Use the <quote>Search</quote> field, or the
458​ vertical scrollbar, to locate the action for which a new keyboard shortcut is to be defined.</para>
459​ </caption>
460​ </mediaobject>
461​ </screenshot>
462​ </para>
463​
464​ <para>&nbsp;</para> <!-- add more white space after screenshot @dcb -->
465​
466​ <para>The &kaddressbook; actions for which keyboard shortcuts have already been defined are clearly marked in the
467​ <quote>Shortcut</quote> column. You may either assign additional shortcuts via the <quote>Alternate</quote>,
468​ <quote>Global</quote>, and <quote>Global Alternate</quote> columns in this table, or assign a new shortcut to
469​ an action for which no keyboard shortcut has as yet been defined. Select the action to be configured by clicking
470​ its name, as illustrated above. </para>
471​
472​ <para>&nbsp;</para> <!-- add more white space @dcb -->
473​
474​ <para>When you left-click the <guibutton><inlinemediaobject><imageobject><imagedata fileref="configure.png" format="PNG"/>
475​ </imageobject></inlinemediaobject>None</guibutton> button, its name will change to <quote>Input...</quote>; you can then
476​ record the combination of keystrokes you wish to assign to the selected action. (Hover the cursor over the <guibutton>
477​ <inlinemediaobject><imageobject><imagedata fileref="configure.png" format="PNG"/></imageobject></inlinemediaobject>None</guibutton>
478​ button to view a handy hint about this procedure.) The program will note which keys you have pressed, and record the new
479​ keyboard shortcut, as illustrated below. If you choose a combination that conflicts with an existing shortcut assignment,
480​ you will see an error message, and you will be prompted to make a different selection. You may use the <guibutton><inlinemediaobject>
481​ <imageobject><imagedata fileref="edit-clear.png" format="PNG"/></imageobject></inlinemediaobject></guibutton> button to
482​ erase your selection.</para>
483​
484​ <para>
485​ <screenshot id="screenshot-config-shortcut2">
486​ <screeninfo>A second screenshot of &kaddressbook;'s <quote>Configure Shortcuts</quote> dialog.</screeninfo>
487​ <mediaobject>
488​ <imageobject>
489​ <imagedata fileref="addressbook113.png" format="PNG"/>
490​ </imageobject>
491​ <textobject>
492​ <phrase>A second screenshot of &kaddressbook;'s <quote>Configure Shortcuts</quote> dialog.</phrase>
493​ </textobject>
494​ <caption>
495​ <para>&kaddressbook;'s <quote>Configure Shortcuts</quote> dialog after a new keyboard shortcut has
496​ been entered, but before the new configuration has been saved.</para>
497​ </caption>
498​ </mediaobject>
499​ </screenshot>
500​ </para>
501​
502​ <para>&nbsp;</para> <!-- add more white space after screenshot @dcb -->
503​
504​ <para>Click the <guibutton>&nbsp;✔&nbsp;OK&nbsp;</guibutton> button to save your changes. Click on
505​ <guibutton>&nbsp;⦸&nbsp;Cancel&nbsp;</guibutton> to exit without saving your changes. Click
506​ <guibutton><inlinemediaobject><imageobject><imagedata fileref="document-revert.png" format="PNG"/>
507​ </imageobject></inlinemediaobject>Defaults</guibutton> to restore &kaddressbook;'s default set of
508​ keyboard shortcuts. Choose <guibutton>&nbsp;Manage Schemes&nbsp;&gt;&gt;&nbsp;</guibutton> to integrate
509​ your custom assignments into a larger scheme of shortcut assignments; see the <quote>Customizing KDE
510​ Software</quote> chapter in the <quote>Fundamentals</quote> handbook for more details.</para>
511​
512​ <para>You may select the <guibutton><inlinemediaobject><imageobject><imagedata fileref="document-print.png"
513​ format="PNG"/></imageobject></inlinemediaobject>Print</guibutton> button to produce a hard-copy version
514​ of the keyboard shortcut assignments. Here is a sample from the printed table.</para>
515​
516​ <para>
517​ <screenshot id="screenshot-config-shortcut3">
518​ <screeninfo>A screenshot of &kaddressbook;'s <quote>Print</quote> output.</screeninfo>
519​ <mediaobject>
520​ <imageobject>
521​ <imagedata fileref="addressbook114.png" format="PNG"/>
522​ </imageobject>
523​ <textobject>
524​ <phrase>A screenshot of &kaddressbook;'s <quote>Print</quote> output.</phrase>
525​ </textobject>
526​ <caption>
527​ <para>An excerpt from &kaddressbook;'s printed list of keyboard shortcuts.</para>
528​ </caption>
529​ </mediaobject>
530​ </screenshot>
531​ </para>
532​
533​ <para>&nbsp;</para> <!-- add more white space after screenshot @dcb -->
534​
535​ <para><link linkend="docbook-reference">Click here to return to the Table of Contents for this Appendix.</link></para>
536​
537​</sect1>
538​
539​<sect1 id="settings-configure-toolbars">
540​<title>The Configure Toolbars Option</title>
541​
542​ <para>Here is a picture of the screen that appears when you click on the <menuchoice><guimenu>Settings</guimenu>
543​ <guisubmenu><inlinemediaobject><imageobject><imagedata fileref="configure.png" format="PNG"/></imageobject>
544​ </inlinemediaobject>Configure Toolbars...</guisubmenu></menuchoice> menu item.</para>
545​
546​ <para>
547​ <screenshot id="screenshot-config-toolbars">
548​ <screeninfo>A screenshot of &kaddressbook;'s <quote>Configure Toolbars</quote> dialog.</screeninfo>
549​ <mediaobject>
550​ <imageobject>
551​ <imagedata fileref="addressbook130.png" format="PNG"/>
552​ </imageobject>
553​ <textobject>
554​ <phrase>A screenshot of &kaddressbook;'s <quote>Configure Toolbars</quote> dialog.</phrase>
555​ </textobject>
556​ <caption>
557​ <para>&kaddressbook;'s <quote>Configure Toolbars</quote> dialog. Actions that are already displayed
558​ on the Toolbar appear in the large window on the right. Actions in the left-hand window may be
559​ added to the Toolbar, as explained below.</para>
560​ </caption>
561​ </mediaobject>
562​ </screenshot>
563​ </para>
564​
565​ <para>&nbsp;</para> <!-- add more white space after screenshot @dcb -->
566​
567​ <para>Use either one of the <quote>Filter</quote> fields to restrict the range of choices displayed in the corresponding
568​ window. Select an action in the left-hand window (as shown above) if you wish to add it to the Toolbar. Left click the
569​ <guibutton><inlinemediaobject><imageobject><imagedata fileref="go-next.png" format="PNG"/></imageobject></inlinemediaobject>
570​ </guibutton> button to add the item to the list in the right-hand window (and thence to &kaddressbook;'s Toolbar). If you
571​ want to delete an item from the Toolbar simply reverse the procedure: highlight the item to be deleted from the right-hand
572​ window and click the <guibutton><inlinemediaobject><imageobject><imagedata fileref="go-previous.png" format="PNG"/></imageobject>
573​ </inlinemediaobject></guibutton> button. The selected item will be removed from the Toolbar.</para>
574​
575​ <para>You may tailor the order in which selected items appear on the Toolbar by using drag and drop within the right-hand
576​ window. The order of items on the Toolbar, left to right, corresponds with the order in the window, top to bottom. You may
577​ make additional changes to the appearance of the Toolbar by using the <guibutton><inlinemediaobject><imageobject><imagedata
578​ fileref="change-icon.png" format="PNG"/></imageobject></inlinemediaobject>Change Icon...</guibutton> button to alter the icon
579​ associated with a particular action. Similarly, you may change the description of each item on the Toolbar by clicking the
580​ <guibutton><inlinemediaobject><imageobject><imagedata fileref="document-edit.png" format="PNG"/></imageobject>
581​ </inlinemediaobject>Change Text...</guibutton> button.</para>
582​
583​ <para>Use the <guibutton><inlinemediaobject><imageobject><imagedata fileref="document-revert.png" format="PNG"/></imageobject>
584​ </inlinemediaobject>Defaults</guibutton> button to restore the default Toolbar settings. Choose <quote>OK</quote> to
585​ save your changes and exit the dialog, <quote>Apply</quote> to apply your changes while keeping the dialog open, or
586​ <quote>Cancel</quote> to exit the dialog without saving your changes. (See the <quote>Customizing KDE Software</quote>
587​ chapter in the <quote>Fundamentals</quote> handbook for a more detailed explanation of this procedure.)</para>
588​
589​ <para>&nbsp;</para> <!-- add more white space @dcb -->
590​
591​ <para><link linkend="docbook-reference">Click here to return to the Table of Contents for this Appendix.</link></para>
592​
593​</sect1>
594​
595​<sect1 id="settings-configure-kaddressbook">
596​<title>The Configure &kaddressbook; Option</title>
597​
598​ <para>Add verbiage here about configuring &kaddressbook;.</para>
599​
600​ <para><link linkend="docbook-reference">Click here to return to the Table of Contents for this Appendix.</link></para>
601​
602​</sect1>
603​
604​<sect1 id="credits-and-licenses">
605​<title>Credits and Licenses</title>
606​
607​ <para>
608​ &kaddressbook;
609​ </para>
610​
611​ <para>
612​ Copyright &copy; 2007–2019 KAddressBook authors <email>montel@kde.org</email>
613​ </para>
614​
615​ <para>
616​ Documentation Copyright &copy; 2019 David C. Bryant <email>davidbryant@gvtc.com</email>
617​ </para>
618​
619​ <!-- TRANS:CREDIT_FOR_TRANSLATORS -->
620​
621​ <!-- License for new documents after 2017-07-27 (or relicensed) -->
622​
623​ &underCCBYSA4; <!-- CC BY-SA 4.0: do not remove -->
624​
625​ <para><link linkend="docbook-reference">Click here to return to the Table of Contents for this Appendix.</link></para>
626​
627​</sect1>
628​
629​</appendix>