# Configuration

The Configuration Dialog contains all the options for changing some of the default behaviour of &appname;.

Clicking the Apply button causes the changes to take effect immediately without closing the dialog, while OK applies the changes and closes the dialog. Cancel closes the dialog, but any changes already made and applied will remain. The Default button reverts the options on the current page of the dialog to their default values, while Help opens the &khelpcenter; to the relative section of the &appname; manual.

Some minor settings can only be changed by editing the configuration file itself. See Hidden Options.

## General Options

The General Options Dialog
The General Options Dialog

The General Options Dialog

The General Options control the general behavior. When &appname; is started, it can automatically reopen the last data file that was open. The Tip of the Day dialog contains helpful hints on using &appname; and appears at program startup. You may want to read through some of the hints and then disable the dialog. Finally, in the &group-view;, the number of entries in each group may be added to the group name.

The Formatting Options control the level of automatic formatting that &appname; does. For examples, see the Field Formatting section. Capitalization and formatting are distinct options, since a field may be capitalized without having the order of the words changed, and vice-versa. The automatic formatting includes grammatical articles in titles, along with prefixes and suffixes for personal names. The values are case-insensitive, and should be separated by a semi-colon.

The formatting rules follow general English usage, which may not work for other languages. Articles are appended to the end of the title, with a comma. Personal names are formatted to have the last name first, followed by a comma, then the first name. Personal suffixes, such as Jr., are kept with the last name. Prefixes, such as von, are kept with the last name, but are ignored when the values are being sorted.

John Q. von Public, III would become von Public, III, John Q. and Public would be used as the sort key.

Only single word prefixes are supported. If a name includes van der, for example, both van and der should be included in the surname prefix list. Articles ending with an apostrophe are supported for sorting order, as well.

The actual values in the collection are not changed, only the visible text used for the interface. So the formatting options can be changed back and forth without affecting any of the data in the collection.

## Printing Options

&appname; uses an &xslt; template for creating &html; and then passes that to the &kde; printing service. Only the fields visible in the &detailed-view; are printed. Furthermore, if the collection is being filtered, only the visible entries will be printed. Initially, a warning message is shown if filtering is active.

The Print Options Dialog
The Print Options Dialog

The Print Options Dialog

The Printing Options allow you to change some formatting when printing a collection. If Format titles and names is checked, then the fields are auto-formatted when they are printed. Otherwise, they are printed exactly as they were entered.

The default printing stylesheet prints the collection with the field values in columns. Print field headers controls whether the field title is printed at the top of the column.

In the printout, the entries will be sorted as they are in the &detailed-view;. However, they may be grouped as they are in the &group-view; instead, which can be changed using the Group the entries option.

Finally, when image fields are included in the printout, the images may be resized, while maintaining their aspect ratio. The maximum image width and height define the largest possible size of the image, though it will never be increased.

## Template Options

The &entry-view; uses templates to show the field values. You can specify a different template for each collection type. Some templates, such as the Album or Video templates are for a specific collection type, and a short error message will appear in the &entry-view; when they are used for other types.

Additional templates may be installed in `$`KDEHOME`/share/apps/tellico/entry-templates/`.

The Template Options Dialog
The Template Options Dialog

The Template Options Dialog

## Data Sources Options

&appname; can use various sources for importing data, which can be configured in the Data Sources Dialog. Currently, there are three available types of sources: Amazon.com Web Services, the Internet Movie Database, and z39.50 servers.

The Data Sources Options Dialog
The Data Sources Options Dialog

The Data Sources Options Dialog

New sources may be added by clicking the New... button, while existing ones may be modified or deleted, using the Modify... or Remove buttons.

### Amazon.com

Using the Amazon Web Services, &appname; can search six different international sites operated by Amazon.com for information: United States, United Kingdom, Germany, Japan, France, and Canada.

Configuring each Amazon.com source involves three settings: the server location, image size, and associate's ID. Some information from Amazon.com included an image, such as a book or video cover. That image may be downloaded in three different sizes, depending on the item. Because too many images slow the application, medium or large images are not recommended. The associate's ID must be used to access the Amazon.com Web Services, and is included in the links back to the item, as dictated by the license agreement for the use of the Amazon.com Web Services.

### Internet Movie Database

The Internet Movie Database provides information about movies and videos. When a search is conducted for a Person, if more than one possible result is returned, a dialog box is opened to allow you to select the correct person. The two configuration options include setting the web server address and whether images are grabbed or not.

Obviously, more than one Amazon.com provider from the same country, or more than one IMDb provider is superfluous.

### z39.50 Servers

The z39.50 protocol is used to access libraries and bibliographic information providers around the world. Lists of public z39.50 servers are available from indexdata.dk, among others. &appname; is able to access any z39.50 server that provides data in the MARC, MARC21, or USMARC format, using the yaz library.

The default port for z39.50 access is 210, but some servers may use a different one. &appname; assumes the server uses the Marc-8 character encoding, unless configured otherwise. If an incorrect character encoding is used, an error message may appear on the program output, or possibly no entries are retrieved.

Some servers require a username and password for access. &appname; can use and save that password, but be aware that is written to the &appname; configuration file in plain text and is not secure. For most public servers, the username and password fields may be left empty.