# Configuration

The Configuration Dialog contains all the options for changing some of the default behaviour of &bookcase;. 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 this section of the manual.

## General Options

The General Options Dialog
The General Options Dialog

The General Options Dialog

The General Options control the general behavior. When &bookcase; is started, it can automatically reopen the last file that was open. The Tip of the Day dialog contains helpful hints on using &bookcase; and appears at program startup. You may want to read through some of the hints and then disable the dialog. The &group-view; is able to append the number of entries in each group to the group name in the tree view, and that functionality may be enabled or disabled using this option.

The Formatting Options control the level of automatic formatting that &bookcase; 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. 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.

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 collection's data.

## Printing Options

&bookcase; 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 that the image may be, though it will never be scaled to a larger than actual size.

## 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/bookcase/entry-templates/`.

The Template Options Dialog
The Template Options Dialog

The Template Options Dialog

## Bibtex Options

When exporting to Bibtex, the field values may be escaped with braces or quotation marks. &bookcase; is also able to send latex citations to a pipe for use with LyX, Kile, or other LaTeX formatting programs. The location of the LyXpipe should not include the `.in` or `.out` extension. The target application must be running for the pipe to exist.

The Bibtex Options Dialog
The Bibtex Options Dialog

The Bibtex Options Dialog