Differential D22799 Diff 67010 doc/docbook-reference.docbook

Changeset View

Standalone View

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>
		41		</keywordset>
		42
		43		</appendixinfo>
		44
		45		<title>&kaddressbook; Advanced Features Reference Section</title>
		46
		47		<sect1 id="placeholder">
		48		<title></title>
		49		<para></para>
		50		</sect1> <!-- Force a page break after Table of Contents. dcb -->
		51
		52		<sect1 id="file-new-group">
		53		<title>The New Group Dialog</title>
		54
		55		<para>When you invoke the <guibutton><inlinemediaobject><imageobject><imagedata fileref="user-group-new.png" format="PNG"/>
		56		</imageobject></inlinemediaobject>New Group</guibutton> function, a dialog will begin, as shown below.</para>
		57
		58		<para>
		59		<screenshot id="screenshot-new-group">
		60		<screeninfo>A screenshot of &kaddressbook;'s <quote>New Group</quote> dialog.</screeninfo>
		61		<mediaobject>
		62		<imageobject>
		63		<imagedata fileref="addressbook101.png" format="PNG"/>
		64		</imageobject>
		65		<textobject>
		66		<phrase>A screenshot of &kaddressbook;'s <quote>New Group</quote> dialog.</phrase>
		67		</textobject>
		68		<caption>
		69		<para>&kaddressbook;'s <quote>New Group</quote> dialog after choosing the <menuchoice><guimenu>File</guimenu><guisubmenu>New
		70		></guisubmenu><guimenuitem><inlinemediaobject><imageobject><imagedata fileref="user-group-new.png" format="PNG"/>
		71		</imageobject></inlinemediaobject>New Group</guimenuitem></menuchoice> function.</para>
		72		</caption>
		73		</mediaobject>
		74		</screenshot>
		75		</para>
		76
		77		<para> </para> <!-- add more white space after screenshot @dcb -->
		78
		79		<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
		80		<quote>Name</quote> field to give the new group a name. Enter e-mail addresses, or portions of email addresses, in the blue
		81		<quote>+</quote> area. A list of potential matches will appear. Select an item in the list that pops up, and a new name
		82		will be added to the list. Continue adding individual contacts to the list until it is complete, then click the
		83		<guibutton> ✔ OK </guibutton> button to add this group to your address book. If you want to delete a name from
		84		the list, click the <inlinemediaobject><imageobject><imagedata fileref="list-remove.png" format="PNG"/></imageobject>
		85		</inlinemediaobject> icon to the right of that particular name. If you need to make changes to the group later, simply select
		86		the group and use the <quote>Edit</quote> menu, or the <quote>Edit Contact</quote> button on the toolbar, to open a substantially
		87		similar dialog that will let you make the desired changes.</para>
		88
		89		<para>The &kmail; program provides an alternative method of creating a new group in &kaddressbook;. After you have addressed an e-mail
		90		message to several people, you are given the option of adding a new group to your address book, as shown below.</para>
		91
		92		<para>
		93		<screenshot id="screenshot-new-group-via-kmail">
		94		<screeninfo>A screenshot of &kmail;'s <quote>New Group</quote> dialog.</screeninfo>
		95		<mediaobject>
		96		<imageobject>
		97		<imagedata fileref="addressbook102.png" format="PNG"/>
		98		</imageobject>
		99		<textobject>
		100		<phrase>A screenshot of &kmail;'s <quote>New Group</quote> dialog.</phrase>
		101		</textobject>
		102		<caption>
		103		<para>&kmail;'s <quote>New Group</quote> dialog after choosing the <guibutton> Save List...
		104		</guibutton> function.</para>
		105		</caption>
		106		</mediaobject>
		107		</screenshot>
		108		</para>
		109
		110		<para> </para> <!-- add more white space after screenshot @dcb -->
		111
		112		<para>After addressing a message to a group of people, clicking the <guibutton> Save List... </guibutton>
		113		button to the right of the address input area will cause the illustrated dialog box to appear. Give the list a name
		114		and left click the <guibutton> Save List </guibutton> button. Another dialog box will pop up, asking you
		115		to select an address book. Make your selection, and a new group will be created for you.</para>
		116
		117		<para><link linkend="docbook-reference">Click here to return to the Table of Contents for this Appendix.</link></para>
		118
		119		</sect1>
		120
		121		<sect1 id="file-print-preview">
		122		<title>The Print-Preview Dialog</title>
		123
		124		<para>&kaddressbook;'s <quote>Print Preview</quote> function lets you tailor a hard-copy of your address book
		125		data just about any way you want.</para>
		126
		127		<para>
		128		<screenshot id="screenshot-print-preview-a">
		129		<screeninfo>A screenshot of &kaddressbook;'s <quote>Print Preview</quote> dialog.</screeninfo>
		130		<mediaobject>
		131		<imageobject>
		132		<imagedata fileref="addressbook120.png" format="PNG"/>
		133		</imageobject>
		134		<textobject>
		135		<phrase>A screenshot of &kaddressbook;'s <quote>Print Preview</quote> dialog.</phrase>
		136		</textobject>
		137		<caption>
		138		<para>&kaddressbook;'s <quote>Print Preview</quote> dialog. You may select one or more entire
		139		address books, or just a smattering of individual contacts.</para>
		140		</caption>
		141		</mediaobject>
		142		</screenshot>
		143		</para>
		144
		145		<para> </para> <!-- add more white space after screenshot @dcb -->
		146
		147		<para>The first step is to select the contacts to be included in the printout. If you wish to print just a
		148		smattering of individual contacts, you must choose the contacts to be printed before invoking the
		149		<menuchoice><guisubmenu><inlinemediaobject><imageobject><imagedata fileref="document-preview-archive.png"
		150		format="PNG"/></imageobject></inlinemediaobject>Print Preview</guisubmenu></menuchoice> dialog. If you wish
		151		to select all your contacts, or all the contacts in a particular address book, you can do it here. Click
		152		<guibutton><inlinemediaobject><imageobject><imagedata fileref="go-next.png" format="PNG"/></imageobject>
		153		</inlinemediaobject>Next</guibutton> when you have made your selection. A new screen will appear.</para>
		154
		155		<para>
		156		<screenshot id="screenshot-print-preview-b">
		157		<screeninfo>A second screenshot of &kaddressbook;'s <quote>Print Preview</quote> dialog.</screeninfo>
		158		<mediaobject>
		159		<imageobject>
		160		<imagedata fileref="addressbook121.png" format="PNG"/>
		161		</imageobject>
		162		<textobject>
		163		<phrase>A screenshot of &kaddressbook;'s <quote>Print Preview</quote> dialog.</phrase>
		164		</textobject>
		165		<caption>
		166		<para>The second screen in &kaddressbook;'s <quote>Print Preview</quote> dialog. You may choose a sort field
		167		and a sort direction (up or down). You may also choose among seven different print layouts.</para>
		168		</caption>
		169		</mediaobject>
		170		</screenshot>
		171		</para>
		172
		173		<para> </para> <!-- add more white space after screenshot @dcb -->
		174
		175		<para>Here you can choose a sort field (any one of the 47 named fields in the contact record), the
		176		direction of the sort, and any one of seven different report formats. When you click <guibutton>
		177		<inlinemediaobject><imageobject><imagedata fileref="go-next.png" format="PNG"/></imageobject>
		178		</inlinemediaobject>Next</guibutton>, you will be given a chance to tailor the color scheme to
		179		be used.</para>
		180
		181		<para>
		182		<screenshot id="screenshot-print-preview-c">
		183		<screeninfo>A third screenshot of &kaddressbook;'s <quote>Pint Preview</quote> dialog.</screeninfo>
		184		<mediaobject>
		185		<imageobject>
		186		<imagedata fileref="addressbook122.png" format="PNG"/>
		187		</imageobject>
		188		<textobject>
		189		<phrase>A third screenshot of &kaddressbook;'s <quote>Print Preview</quote> dialog.</phrase>
		190		</textobject>
		191		<caption>
		192		<para>The third screen in &kaddressbook;'s <quote>Print Preview</quote> dialog. You may select a
		193		color scheme here.</para>
		194		</caption>
		195		</mediaobject>
		196		</screenshot>
		197		</para>
		198
		199		<para> </para> <!-- add more white space after screenshot @dcb -->
		200
		201		<para>Here is a picture of the completed report. It is now ready for printing.</para>
		202
		203		<para>
		204		<screenshot id="screenshot-print-preview-d">
		205		<screeninfo>A screenshot of &kaddressbook;'s <quote>Pint Preview</quote> dialog.</screeninfo>
		206		<mediaobject>
		207		<imageobject>
		208		<imagedata fileref="addressbook123.png" format="PNG"/>
		209		</imageobject>
		210		<textobject>
		211		<phrase>A screenshot of &kaddressbook;'s <quote>Print Preview</quote> dialog.</phrase>
		212		</textobject>
		213		<caption>
		214		<para>&kaddressbook;'s <quote>Print Preview</quote> after the report has been generated and
		215		is ready to print. You may select alternative print orientations (landscape or portrait) and
		216		launch the print task from this window.</para>
		217		</caption>
		218		</mediaobject>
		219		</screenshot>
		220		</para>
		221
		222		<para> </para> <!-- add more white space after screenshot @dcb -->
		223
		224		<para><link linkend="docbook-reference">Click here to return to the Table of Contents for this Appendix.</link></para>
		225
		226		</sect1>
		227
		228		<sect1 id="configure-ldap-server">
		229		<title>The Configure LDAP Dialog</title>
		230
		231		<para>Here is a picture of the first configuration screen that appears when you choose either the
		232		<guibutton>Configure LDAP Servers...</guibutton> button in the <menuchoice><guimenu>File</guimenu>
		233		<guisubmenu>Import   ></guisubmenu><guimenuitem>Import from LDAP Server...</guimenuitem>
		234		</menuchoice> dialog or the <menuchoice><guimenu>Settings</guimenu><guisubmenu><inlinemediaobject>
		235		<imageobject><imagedata fileref="configure.png" format="PNG"/></imageobject></inlinemediaobject>Configure
		236		&kaddressbook;...</guisubmenu></menuchoice> menu item.</para>
		237
		238		<para>
		239		<screenshot id="screenshot-ldap1">
		240		<screeninfo>A screenshot of &kaddressbook;'s <quote>Configure LDAP Server</quote> dialog.</screeninfo>
		241		<mediaobject>
		242		<imageobject>
		243		<imagedata fileref="addressbook131.png" format="PNG"/>
		244		</imageobject>
		245		<textobject>
		246		<phrase>A screenshot of &kaddressbook;'s <quote>Configure LDAP Server</quote> dialog.</phrase>
		247		</textobject>
		248		<caption>
		249		<para>&kaddressbook;'s <quote>Configure LDAP Server</quote> dialog after choosing the <menuchoice><guimenu>File</guimenu><guisubmenu>Import
		250		></guisubmenu><guimenuitem>Import from LDAP Server...</guimenuitem></menuchoice> function and left clicking the
		251		<guibutton>Configure LDAP Servers...</guibutton> button.</para>
		252		</caption>
		253		</mediaobject>
		254		</screenshot>
		255		</para>
		256
		257		<para> </para> <!-- add more white space after screenshot @dcb -->
		258
		259		<para>If you have already configured one or more <acronym>LDAP</acronym> servers, use this screen to select the servers
		260		that should be queried when you search for a name or email address. Use the <guibutton>Add host...</guibutton> button to
		261		add a new server to the list of available <acronym>LDAP</acronym> hosts. Use the <guibutton>Edit host...</guibutton>
		262		button to reconfigure a server that's already on the list, and the <guibutton>Remove host</guibutton> button to
		263		delete an entry you don't need any more. The <guibutton><inlinemediaobject><imageobject><imagedata fileref="edit-undo.png"
		264		format="PNG"/></imageobject></inlinemediaobject>Reset</guibutton> button can be used to undo the last <quote>Add</quote>
		265		or <quote>Remove</quote> action performed. The <quote>Defaults</quote> button is inoperative in release 5.10.3. The rest
		266		of the buttons (OK, Apply, Cancel) have their ordinary functions: apply changes and exit, apply changes and stay here,
		267		and exit the dialog without making any changes, respectively.</para>
		268
		269		<para> </para> <!-- add more white space @dcb -->
		270
		271		<para>When you choose either the <guibutton>Add host...</guibutton> button or the <guibutton>Edit host...</guibutton>
		272		button, the following dialog will appear.</para>
		273
		274		<para>
		275		<screenshot id="screenshot-ldap2">
		276		<screeninfo>A second screenshot of &kaddressbook;'s <quote>Configure LDAP Server</quote> dialog.</screeninfo>
		277		<mediaobject>
		278		<imageobject>
		279		<imagedata fileref="addressbook132.png" format="PNG"/>
		280		</imageobject>
		281		<textobject>
		282		<phrase>A second screenshot of &kaddressbook;'s <quote>Configure LDAP Server</quote> dialog.</phrase>
		283		</textobject>
		284		<caption>
		285		<para>&kaddressbook;'s <quote>Configure LDAP Server</quote> dialog after left clicking either the
		286		<guibutton>Add Host...</guibutton> or the <guibutton>Edit Host...</guibutton> button.</para>
		287		</caption>
		288		</mediaobject>
		289		</screenshot>
		290		</para>
		291
		292		<para> </para> <!-- add more white space after screenshot @dcb -->
		293
		294		<para>The first four fields (<quote>User:</quote>, <quote>Bind DN:</quote>, <quote>Realm:</quote>, and
		295		<quote>Password:</quote>) will all be grayed out unless authentication is required. Obtain these credentials
		296		from the LDAP server's administrator. Enter the appropriate URI in the <quote>Host:</quote> field. The default
		297		values for <quote>Port:</quote>, <quote>Size limit:</quote>, &etc; will work OK for most users. You can use the
		298		<guibutton>Query Server</guibutton> button to set up the <quote>DN:</quote> field. I have no idea what the
		299		<quote>Filter:</quote> field is for. If you figure it out, please let me know (davidbryant AT gvtc.com).</para>
		300
		301		<para>Use the <quote>Security</quote> section to specify the encryption method to use: <quote>No</quote> for
		302		an unencrypted connection, <glossterm linkend="gloss-tls"><acronym>TLS</acronym></glossterm> for Transport Layer
		303		Security, or <glossterm linkend="gloss-ssl"><acronym>SSL</acronym></glossterm> for Secure Socket Layer. Use the
		304		<quote>Authentication</quote> options to specify what level of authentication the server requires:
		305		<quote>Anonymous</quote> for no name or password at all, <quote>Simple</quote> if <quote>Bind DN</quote> and
		306		<quote>Password</quote> must be given, and <glossterm linkend="gloss-sasl"><acronym>SASL</acronym></glossterm>
		307		(Simple Authentication and Security Layer) for the whole schmear (four data items). If <quote>SASL</quote> is
		308		chosen, use the <guibutton>Query Server</guibutton> button to set the advanced options for this host.</para>
		309
		310		<para> </para> <!-- add more white space @dcb -->
		311
		312		<para><link linkend="docbook-reference">Click here to return to the Table of Contents for this Appendix.</link></para>
		313
		314		</sect1>
		315
		316		<sect1 id="import-csv-data">
		317		<title>The Import CSV File Function</title>
		318
		319		<para>When you choose the <menuchoice><guimenu>File</guimenu><guisubmenu>Import   ></guisubmenu>
		320		<guimenuitem>Import CSV file...</guimenuitem></menuchoice> function, you will be presented with a dialog.
		321		After you click the <guibutton><inlinemediaobject><imageobject><imagedata fileref="document-open.png" format="PNG"/>
		322		</imageobject></inlinemediaobject></guibutton> button and choose the file to be imported, the screen will
		323		look like this.</para>
		324
		325		<para>
		326		<screenshot id="screenshot-import-csv">
		327		<screeninfo>A screenshot of &kaddressbook;'s <quote>Import CSV File</quote> dialog.</screeninfo>
		328		<mediaobject>
		329		<imageobject>
		330		<imagedata fileref="addressbook103.png" format="PNG"/>
		331		</imageobject>
		332		<textobject>
		333		<phrase>A screenshot of &kaddressbook;'s <quote>Import CSV File</quote> dialog.</phrase>
		334		</textobject>
		335		<caption>
		336		<para>&kaddressbook;'s <quote>Import CSV File</quote> dialog after choosing the <menuchoice><guimenu>File</guimenu><guisubmenu>Import
		337		></guisubmenu><guimenuitem>Import CSV file...</guimenuitem></menuchoice> function and selecting the file to be imported.</para>
		338		</caption>
		339		</mediaobject>
		340		</screenshot>
		341		</para>
		342
		343		<para> </para> <!-- add more white space after screenshot @dcb -->
		344
		345		<para>Use the <quote>Delimiter</quote> section of this dialog to specify which separator character defines the end of a field in the
		346		chosen input file. If quote marks are used to delimit fields with embedded separator characters, you may specify the style (single
		347		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>
		348		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
		349		<quote>Date format:</quote> box and a handy set of formatting instructions will be displayed. If the input file is not UTF-8 encoded,
		350		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
		351		column headers, check the <quote>Skip first row of file</quote> box to avoid importing the column headers as data. Use the
		352		<quote>Undefined</quote> boxes at the top of each column to specify which data fields are to be imported, and where they should be
		353		stored, as shown below.</para>
		354
		355		<para>
		356		<screenshot id="screenshot-import-csv-2">
		357		<screeninfo>A second screenshot of &kaddressbook;'s <quote>Import CSV File</quote> dialog.</screeninfo>
		358		<mediaobject>
		359		<imageobject>
		360		<imagedata fileref="addressbook104.png" format="PNG"/>
		361		</imageobject>
		362		<textobject>
		363		<phrase>A second screenshot of &kaddressbook;'s <quote>Import CSV File</quote> dialog.</phrase>
		364		</textobject>
		365		<caption>
		366		<para>&kaddressbook;'s <quote>Import CSV File</quote> dialog after choosing the <menuchoice><guimenu>File</guimenu><guisubmenu>Import
		367		></guisubmenu><guimenuitem>Import CSV file...</guimenuitem></menuchoice> function, selecting the file to be imported, and
		368		beginning to define the fields to be imported.</para>
		369		</caption>
		370		</mediaobject>
		371		</screenshot>
		372		</para>
		373
		374		<para> </para> <!-- add more white space after screenshot @dcb -->
		375
		376		<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
		377		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
		378		horizontal scrollbar near the bottom of the dialog to view all the columns in the input file. When your selections are complete, click the
		379		<guibutton> ✔ OK </guibutton> button. If you have defined multiple address books, you will be asked to specify which address
		380		book is to be used. &kaddressbook; will then import the selected data as new contacts.</para>
		381
		382		<para>If you intend to import additional datasets in the same format sometime in the future, you may click the <guibutton>Save template...</guibutton>
		383		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.
		384		Later, when you import another file with the same layout, you can save time by clicking the <guibutton>Apply template...</guibutton> button.</para>
		385
		386		<para><link linkend="docbook-reference">Click here to return to the Table of Contents for this Appendix.</link></para>
		387
		388		</sect1>
		389
		390		<sect1 id="export-csv-data">
		391		<title>The Export CSV File Function</title>
		392
		393		<para>When you invoke the <menuchoice><guimenu>File</guimenu><guisubmenu>Export  ></guisubmenu><guimenuitem>Export
		394		CSV file ...</guimenuitem></menuchoice> function, a dialog box appears.</para>
		395
		396		<para>
		397		<screenshot id="screenshot-export-csv">
		398		<screeninfo>A screenshot of &kaddressbook;'s <quote>Export CSV File</quote> dialog.</screeninfo>
		399		<mediaobject>
		400		<imageobject>
		401		<imagedata fileref="addressbook100.png" format="PNG"/>
		402		</imageobject>
		403		<textobject>
		404		<phrase>A screenshot of &kaddressbook;'s <quote>Export CSV File</quote> dialog.</phrase>
		405		</textobject>
		406		<caption>
		407		<para>&kaddressbook;'s <quote>Export CSV File</quote> dialog after choosing the <menuchoice><guimenu>File</guimenu><guisubmenu>Export
		408		></guisubmenu><guimenuitem>Export CSV file ...</guimenuitem></menuchoice> function.</para>
		409		</caption>
		410		</mediaobject>
		411		</screenshot>
		412		</para>
		413
		414		<para> </para> <!-- add more white space after screenshot @dcb -->
		415
		416		<para>You may select all your contact data, or just a portion of it. When you press the <guibutton> ✔ OK </guibutton> button,
		417		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
		418		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>
		419
		420		<para>Formatted Name \| Honorific Prefixes \| Given Name \| Additional Names \| Family Name \| Honorific Suffixes \| Nick Name \| Birthday \| Anniversary \|
		421		EMail (preferred) \| EMail (2) \| EMail (3) \| EMail (4) \| Home Address Street \| Home Address Post Office Box \| Home Address City \| Home Address State \|
		422		Home Address Zip Code \| Home Address Country \| Home Address Label \| Business Address Street \| Business Address Post Office Box \| Business Address City \|
		423		Business Address State \| Business Address Zip Code \| Business Address Country \| Business Address Label \| Home Phone \| Business Phone \| Mobile Phone \|
		424		Home Fax \| Business Fax \| Car Phone \| ISDN \| Pager \| Mail Client \| Title \| Role \| Organization \| Note \| Homepage \| Blog Feed \| Profession \| Office \|
		425		Manager \| Assistant \| Spouse</para>
		426
		427		<para>All fields are formatted as character class data. Dates (Birthday and Anniversary, if present) are coded as
		428		yyyy-mm-dd (Year, Month, Day).</para>
		429
		430		<para><link linkend="docbook-reference">Click here to return to the Table of Contents for this Appendix.</link></para>
		431
		432
		433		</sect1>
		434
		435		<sect1 id="view-change-columns">
		436		<title>The Change Number of Columns Function</title>
		437
		438		<para>When you open the <menuchoice><guimenu>View</guimenu></menuchoice> menu, the following screen appears.</para>
		439
		440		<para>
		441		<screenshot id="screenshot-view-menu-appendix">
		442		<screeninfo>A screenshot of &kaddressbook;'s <quote>View</quote> menu.</screeninfo>
		443		<mediaobject>
		444		<imageobject>
		445		<imagedata fileref="addressbook82.png" format="PNG"/>
		446		</imageobject>
		447		<textobject>
		448		<phrase>A screenshot of &kaddressbook;'s <quote>View</quote> menu.</phrase>
		449		</textobject>
		450		<caption>
		451		<para>&kaddressbook;'s <quote>View</quote> menu after choosing the <menuchoice><guimenu>View</guimenu></menuchoice>
		452		menu on the main Menubar.</para>
		453		</caption>
		454		</mediaobject>
		455		</screenshot>
		456		</para>
		457
		458		<para> </para> <!-- add more white space after screenshot @dcb -->
		459
		460		<para>Not happy with the hum-drum three column layout appearing above? Jazz things up a little with this minimalist approach.</para>
		461
		462		<para>
		463		<screenshot id="screenshot-view-menu-appendix-2">
		464		<screeninfo>A screenshot of &kaddressbook;'s single panel layout.</screeninfo>
		465		<mediaobject>
		466		<imageobject>
		467		<imagedata fileref="addressbook110.png" format="PNG"/>
		468		</imageobject>
		469		<textobject>
		470		<phrase>A screenshot of &kaddressbook;'s single panel layout.</phrase>
		471		</textobject>
		472		<caption>
		473		<para>&kaddressbook;'s <quote>Simple (one column)</quote> layout. Only the basic contact
		474		data are visible.</para>
		475		</caption>
		476		</mediaobject>
		477		</screenshot>
		478		</para>
		479
		480		<para> </para> <!-- add more white space after screenshot @dcb -->
		481
		482		<para>Notice that the information about which address books exist and are in use is not visible when this <quote>Simple</quote>
		483		layout is in effect. Only the contacts from the address books that were selected before choosing this view are displayed.</para>
		484
		485		<para> </para> <!-- add more white space @dcb -->
		486
		487		<para>If the <quote>Simple</quote> layout does not appeal to you, you may want to try the <quote>Two columns</quote> style.</para>
		488
		489		<para>
		490		<screenshot id="screenshot-view-menu-appendix-3">
		491		<screeninfo>A screenshot of &kaddressbook;'s double panel layout.</screeninfo>
		492		<mediaobject>
		493		<imageobject>
		494		<imagedata fileref="addressbook111.png" format="PNG"/>
		495		</imageobject>
		496		<textobject>
		497		<phrase>A screenshot of &kaddressbook;'s double panel layout.</phrase>
		498		</textobject>
		499		<caption>
		500		<para>&kaddressbook;'s <quote>Two columns</quote> layout. The list of address books is
		501		stacked on top of the alphabetized contact list.</para>
		502		</caption>
		503		</mediaobject>
		504		</screenshot>
		505		</para>
		506
		507		<para> </para> <!-- add more white space after screenshot @dcb -->
		508
		509		<para> At &kde;, our motto is "Be Free!" We aim to give you maximum flexibility when it comes to tailoring
		510		and configuring our software to suit your tastes. We toyed with the idea of adding even more views to
		511		&kaddressbook; (Four columns! Five!), but eventually concluded that enough is enough.</para>
		512
		513		<para> </para> <!-- add more white space @dcb -->
		514
		515		<para><link linkend="docbook-reference">Click here to return to the Table of Contents for this Appendix.</link></para>
		516
		517		</sect1>
		518
		519		<sect1 id="settings-configure-shortcuts">
		520		<title>The Configure Shortcuts Option</title>
		521
		522		<para>When you first select the <menuchoice><guimenu>Settings</guimenu><guisubmenu><inlinemediaobject><imageobject>
		523		<imagedata fileref="input-keyboard.png" format="PNG"/></imageobject></inlinemediaobject>Configure Shortcuts...</guisubmenu>
		524		</menuchoice> option, this is what you will see.</para>
		525
		526		<para>
		527		<screenshot id="screenshot-config-shortcut1">
		528		<screeninfo>A screenshot of &kaddressbook;'s <quote>Configure Shortcuts</quote> dialog.</screeninfo>
		529		<mediaobject>
		530		<imageobject>
		531		<imagedata fileref="addressbook112.png" format="PNG"/>
		532		</imageobject>
		533		<textobject>
		534		<phrase>A screenshot of &kaddressbook;'s <quote>Configure Shortcuts</quote> dialog.</phrase>
		535		</textobject>
		536		<caption>
		537		<para>&kaddressbook;'s <quote>Configure Shortcuts</quote> dialog. Use the <quote>Search</quote> field, or the
		538		vertical scrollbar, to locate the action for which a new keyboard shortcut is to be defined.</para>
		539		</caption>
		540		</mediaobject>
		541		</screenshot>
		542		</para>
		543
		544		<para> </para> <!-- add more white space after screenshot @dcb -->
		545
		546		<para>The &kaddressbook; actions for which keyboard shortcuts have already been defined are clearly marked in the
		547		<quote>Shortcut</quote> column. You may either assign additional shortcuts via the <quote>Alternate</quote>,
		548		<quote>Global</quote>, and <quote>Global Alternate</quote> columns in this table, or assign a new shortcut to
		549		an action for which no keyboard shortcut has as yet been defined. Select the action to be configured by clicking
		550		its name, as illustrated above. </para>
		551
		552		<para> </para> <!-- add more white space @dcb -->
		553
		554		<para>When you left-click the <guibutton><inlinemediaobject><imageobject><imagedata fileref="configure.png" format="PNG"/>
		555		</imageobject></inlinemediaobject>None</guibutton> button, its name will change to <quote>Input...</quote>; you can then
		556		record the combination of keystrokes you wish to assign to the selected action. (Hover the cursor over the <guibutton>
		557		<inlinemediaobject><imageobject><imagedata fileref="configure.png" format="PNG"/></imageobject></inlinemediaobject>None</guibutton>
		558		button to view a handy hint about this procedure.) The program will note which keys you have pressed, and record the new
		559		keyboard shortcut, as illustrated below. If you choose a combination that conflicts with an existing shortcut assignment,
		560		you will see an error message, and you will be prompted to make a different selection. You may use the <guibutton><inlinemediaobject>
		561		<imageobject><imagedata fileref="edit-clear.png" format="PNG"/></imageobject></inlinemediaobject></guibutton> button to
		562		erase your selection.</para>
		563
		564		<para>
		565		<screenshot id="screenshot-config-shortcut2">
		566		<screeninfo>A second screenshot of &kaddressbook;'s <quote>Configure Shortcuts</quote> dialog.</screeninfo>
		567		<mediaobject>
		568		<imageobject>
		569		<imagedata fileref="addressbook113.png" format="PNG"/>
		570		</imageobject>
		571		<textobject>
		572		<phrase>A second screenshot of &kaddressbook;'s <quote>Configure Shortcuts</quote> dialog.</phrase>
		573		</textobject>
		574		<caption>
		575		<para>&kaddressbook;'s <quote>Configure Shortcuts</quote> dialog after a new keyboard shortcut has
		576		been entered, but before the new configuration has been saved.</para>
		577		</caption>
		578		</mediaobject>
		579		</screenshot>
		580		</para>
		581
		582		<para> </para> <!-- add more white space after screenshot @dcb -->
		583
		584		<para>Click the <guibutton> ✔ OK </guibutton> button to save your changes. Click on
		585		<guibutton> ⦸ Cancel </guibutton> to exit without saving your changes. Click
		586		<guibutton><inlinemediaobject><imageobject><imagedata fileref="document-revert.png" format="PNG"/>
		587		</imageobject></inlinemediaobject>Defaults</guibutton> to restore &kaddressbook;'s default set of
		588		keyboard shortcuts. Choose <guibutton> Manage Schemes >> </guibutton> to integrate
		589		your custom assignments into a larger scheme of shortcut assignments; see the <quote>Customizing KDE
		590		Software</quote> chapter in the <quote>Fundamentals</quote> handbook for more details.</para>
		591
		592		<para>You may select the <guibutton><inlinemediaobject><imageobject><imagedata fileref="document-print.png"
		593		format="PNG"/></imageobject></inlinemediaobject>Print</guibutton> button to produce a hard-copy version
		594		of the keyboard shortcut assignments. Here is a sample from the printed table.</para>
		595
		596		<para>
		597		<screenshot id="screenshot-config-shortcut3">
		598		<screeninfo>A screenshot of &kaddressbook;'s <quote>Print</quote> output.</screeninfo>
		599		<mediaobject>
		600		<imageobject>
		601		<imagedata fileref="addressbook114.png" format="PNG"/>
		602		</imageobject>
		603		<textobject>
		604		<phrase>A screenshot of &kaddressbook;'s <quote>Print</quote> output.</phrase>
		605		</textobject>
		606		<caption>
		607		<para>An excerpt from &kaddressbook;'s printed list of keyboard shortcuts.</para>
		608		</caption>
		609		</mediaobject>
		610		</screenshot>
		611		</para>
		612
		613		<para> </para> <!-- add more white space after screenshot @dcb -->
		614
		615		<para><link linkend="docbook-reference">Click here to return to the Table of Contents for this Appendix.</link></para>
		616
		617		</sect1>
		618
		619		<sect1 id="settings-configure-toolbars">
		620		<title>The Configure Toolbars Option</title>
		621
		622		<para>Here is a picture of the screen that appears when you click on the <menuchoice><guimenu>Settings</guimenu>
		623		<guisubmenu><inlinemediaobject><imageobject><imagedata fileref="configure.png" format="PNG"/></imageobject>
		624		</inlinemediaobject>Configure Toolbars...</guisubmenu></menuchoice> menu item.</para>
		625
		626		<para>
		627		<screenshot id="screenshot-config-toolbars">
		628		<screeninfo>A screenshot of &kaddressbook;'s <quote>Configure Toolbars</quote> dialog.</screeninfo>
		629		<mediaobject>
		630		<imageobject>
		631		<imagedata fileref="addressbook130.png" format="PNG"/>
		632		</imageobject>
		633		<textobject>
		634		<phrase>A screenshot of &kaddressbook;'s <quote>Configure Toolbars</quote> dialog.</phrase>
		635		</textobject>
		636		<caption>
		637		<para>&kaddressbook;'s <quote>Configure Toolbars</quote> dialog. Actions that are already displayed
		638		on the Toolbar appear in the large window on the right. Actions in the left-hand window may be
		639		added to the Toolbar, as explained below.</para>
		640		</caption>
		641		</mediaobject>
		642		</screenshot>
		643		</para>
		644
		645		<para> </para> <!-- add more white space after screenshot @dcb -->
		646
		647		<para>Use either one of the <quote>Filter</quote> fields to restrict the range of choices displayed in the corresponding
		648		window. Select an action in the left-hand window (as shown above) if you wish to add it to the Toolbar. Left click the
		649		<guibutton><inlinemediaobject><imageobject><imagedata fileref="go-next.png" format="PNG"/></imageobject></inlinemediaobject>
		650		</guibutton> button to add the item to the list in the right-hand window (and thence to &kaddressbook;'s Toolbar). If you
		651		want to delete an item from the Toolbar simply reverse the procedure: highlight the item to be deleted from the right-hand
		652		window and click the <guibutton><inlinemediaobject><imageobject><imagedata fileref="go-previous.png" format="PNG"/></imageobject>
		653		</inlinemediaobject></guibutton> button. The selected item will be removed from the Toolbar.</para>
		654
		655		<para>You may tailor the order in which selected items appear on the Toolbar by using drag and drop within the right-hand
		656		window. The order of items on the Toolbar, left to right, corresponds with the order in the window, top to bottom. You may
		657		make additional changes to the appearance of the Toolbar by using the <guibutton><inlinemediaobject><imageobject><imagedata
		658		fileref="change-icon.png" format="PNG"/></imageobject></inlinemediaobject>Change Icon...</guibutton> button to alter the icon
		659		associated with a particular action. Similarly, you may change the description of each item on the Toolbar by clicking the
		660		<guibutton><inlinemediaobject><imageobject><imagedata fileref="document-edit.png" format="PNG"/></imageobject>
		661		</inlinemediaobject>Change Text...</guibutton> button.</para>
		662
		663		<para>Use the <guibutton><inlinemediaobject><imageobject><imagedata fileref="document-revert.png" format="PNG"/></imageobject>
		664		</inlinemediaobject>Defaults</guibutton> button to restore the default Toolbar settings. Choose <quote>OK</quote> to
		665		save your changes and exit the dialog, <quote>Apply</quote> to apply your changes while keeping the dialog open, or
		666		<quote>Cancel</quote> to exit the dialog without saving your changes. (See the <quote>Customizing KDE Software</quote>
		667		chapter in the <quote>Fundamentals</quote> handbook for a more detailed explanation of this procedure.)</para>
		668
		669		<para> </para> <!-- add more white space @dcb -->
		670
		671		<para><link linkend="docbook-reference">Click here to return to the Table of Contents for this Appendix.</link></para>
		672
		673		</sect1>
		674
		675		<sect1 id="settings-configure-kaddressbook">
		676		<title>The Configure &kaddressbook; Option</title>
		677
		678		<para>When the <menuchoice><guimenu>Settings</guimenu><guisubmenu><inlinemediaobject><imageobject><imagedata fileref="configure.png"
		679		format="PNG"/></imageobject></inlinemediaobject>Configure &kaddressbook;...</guisubmenu></menuchoice> option is selected, this
		680		screen will appear.</para>
		681
		682		<para>
		683		<screenshot id="screenshot-config-general">
		684		<screeninfo>A screenshot of &kaddressbook;'s <quote>Configure &kaddressbook;</quote> dialog.</screeninfo>
		685		<mediaobject>
		686		<imageobject>
		687		<imagedata fileref="addressbook133.png" format="PNG"/>
		688		</imageobject>
		689		<textobject>
		690		<phrase>A screenshot of &kaddressbook;'s <quote>Configure &kaddressbook;</quote> dialog.</phrase>
		691		</textobject>
		692		<caption>
		693		<para>&kaddressbook;'s <quote>Configure Contact Actions</quote> dialog. These features are still
		694		experimental, and not yet entirely operational.</para>
		695		</caption>
		696		</mediaobject>
		697		</screenshot>
		698		</para>
		699
		700		<para> </para> <!-- add more white space after screenshot @dcb -->
		701
		702		<para>The first dialog that appears supports experimental features that have not yet been completely implemented.
		703		You may select from several different options under the headings <quote>Show Address</quote>, <quote>Dial Phone
		704		Number</quote>, or <quote>Send SMS</quote>, but there isn't yet any software to do anything with the options you
		705		choose.</para>
		706
		707		<para> </para> <!-- add more white space @dcb -->
		708
		709		<para>The next option, <quote>LDAP Server Settings</quote>, is the same dialog that is documented in the preceding
		710		section entitled <link linkend="configure-ldap-server"><quote>The Configure LDAP Dialog</quote></link>.</para>
		711
		712		<para>
		713		<screenshot id="screenshot-config-ldap">
		714		<screeninfo>A second screenshot of &kaddressbook;'s <quote>Configure &kaddressbook;</quote> dialog.</screeninfo>
		715		<mediaobject>
		716		<imageobject>
		717		<imagedata fileref="addressbook134.png" format="PNG"/>
		718		</imageobject>
		719		<textobject>
		720		<phrase>A second screenshot of &kaddressbook;'s <quote>Configure &kaddressbook;</quote> dialog.</phrase>
		721		</textobject>
		722		<caption>
		723		<para>&kaddressbook;'s <quote>LDAP Server Settings</quote> dialog. This dialog, and its child, are documented
		724		in <link linkend="configure-ldap-server">a preceding section</link> of this appendix.</para>
		725		</caption>
		726		</mediaobject>
		727		</screenshot>
		728		</para>
		729
		730		<para> </para> <!-- add more white space after screenshot @dcb -->
		731
		732		<para>The final set of options for configuring &kaddressbook; appears when you select <quote>Plugins</quote>.</para>
		733
		734		<para>
		735		<screenshot id="screenshot-config-plugins">
		736		<screeninfo>A third screenshot of &kaddressbook;'s <quote>Configure &kaddressbook;</quote> dialog.</screeninfo>
		737		<mediaobject>
		738		<imageobject>
		739		<imagedata fileref="addressbook135.png" format="PNG"/>
		740		</imageobject>
		741		<textobject>
		742		<phrase>A third screenshot of &kaddressbook;'s <quote>Configure &kaddressbook;</quote> dialog.</phrase>
		743		</textobject>
		744		<caption>
		745		<para>&kaddressbook;'s <quote>Plugins</quote> dialog. There are ten plugins all together. Seven of them
		746		have been activated by default, as shown above.</para>
		747		</caption>
		748		</mediaobject>
		749		</screenshot>
		750		</para>
		751
		752		<para> </para> <!-- add more white space after screenshot @dcb -->
		753
		754		<para>The actions supported by the seven default <quote>Plugins</quote> are documented in preceding sections of this
		755		manual. The <quote>Import Export <glossterm linkend="gloss-gmx"><acronym>GMX</acronym></glossterm></quote> and
		756		<quote>Import/Export <glossterm linkend="gloss-ldif"><acronym>LDIF</acronym></glossterm></quote> actions will appear
		757		as part of the <menuchoice><guimenu>File</guimenu></menuchoice> menu when activated. The <quote>Check <glossterm
		758		linkend="gloss-gravatar">Gravatar</glossterm></quote> item will appear in the <menuchoice><guimenu>Tools</guimenu>
		759		</menuchoice> menu when it is activated. Notice that &kaddressbook; must be stopped and restarted before any changes
		760		to the <quote>Plugins</quote> will take effect. </para>
		761
		762		<para> </para> <!-- add more white space @dcb -->
		763
		764		<para><link linkend="docbook-reference">Click here to return to the Table of Contents for this Appendix.</link></para>
		765
		766		</sect1>
		767
		768		<sect1 id="credits-and-licenses">
		769		<title>Credits and Licenses</title>
		770
		771		<para>
		772		&kaddressbook;
		773		</para>
		774
		775		<para>
		776		Copyright © 2007–2019 KAddressBook authors <email>montel@kde.org</email>
		777		</para>
		778
		779		<para>
		780		Documentation Copyright © 2019 David C. Bryant <email>davidbryant@gvtc.com</email>
		781		</para>
		782
		783		<!-- TRANS:CREDIT_FOR_TRANSLATORS -->
		784
		785		<!-- License for new documents after 2017-07-27 (or relicensed) -->
		786
		787		&underCCBYSA4; <!-- CC BY-SA 4.0: do not remove -->
		788
		789		<para><link linkend="docbook-reference">Click here to return to the Table of Contents for this Appendix.</link></para>
		790
		791		</sect1>
		792
		793		</appendix>