# &appname; gebruiken

## Snelstart

Standaard begint &appname; met een lege boekverzameling. Om met een ander type verzameling te werken, maakt u het met het menuitem Bestand Nieuw of de knop op de werkbalk. Verzamelingen worden voorzien van enige van de meer algemene velden, maar u kunt ze naar behoefte toevoegen, wijzigen of verwijderen.

Nieuwe items kunnen toegevoegd worden door het gebruik van de Itembewerker. Het menu-item Verzameling Nieuw item zal de Itembewerker openen met een leeg item gereed voor bewerking. De Itembewerker kan ook geopend worden door het menu-item Instellingen Itembewerker tonen. Nadat u de waarden van het item hebt ingevoerd, kunt u het opslaan in de verzameling door de knop Item opslaan in de dialoog van de Itembewerker te gebruiken, die open blijft in het geval u door wilt gaan met het toevoegen van nieuwe items. Nadat u een item aan de verzameling hebt toegevoegd, kunt u het wijzigen door er op te klikken in het hoofdvenster. Als de Itembewerker niet al open is, kunt u dubbel klikken op een item om de bewerker te openen en te beginnen met de bewerking.

Als u een afbeelding in het item wilt invoegen, dan kunt u de standaard &kde; Bestandsselectie gebruiken door te klikken op de knop Afbeelding selecteren... in de Itembewerker of u kunt een afbeelding vanuit de bestandsbeheeder of webbrowser naar de Itembewerker.

Wanneer u een item selecteert, toont de Itemweergave een geformatteerde weergave van de inhoud van het item. U kunt het gebruikte sjabloon wijzigen voor het weergeven van het item in de Instellingendialoog.

De items in de verzameling worden gegroepeerd wanneer ze dezelfde waarden in bepaalde velden delen, zoals de auteur of dirigent. U kunt het veld dat wordt gebruikt voor groepering wijzigen door het afrolvak in de werkbalk te gebruiken of het menu-item Instellingen Groepsselectie.

U kunt het veld Snelfilter in de werkbalk gebruiken om snel het aantal zichtbare items te beperken tot diegenen die het woord dat u invoerde bevat. Het filter is ook nuttig wanneer u snel een item wilt vinden. U kunt de titel invoeren of een ander uniek woord dat het item identificeert en de Kolomweergave zal alleen de items tonen die overeenkomen met het filter. De statusbalk toont u hoeveel items er in de verzameling zijn en hoeveel er nu worden gefilterd.

## Algemeen gebruik

Het hoofdvenster heeft drie aparte gebieden, die allemaal op een verschillende manier informatie tonen over de verzameling. De primaire weergave is de Kolomweergave in het gebied rechtsboven, waar de waarde van elk veld voor elk item getoond kan worden. Aan de linker kant, bevatten tabbladen de Groepsweergave, die gebruikt kan worden om de items te groeperen in een boomstructuur, de Filterweergave, die wordt gebruikt om items te volgen die aan bepaalde criteria voldoen en de Leningweergave, waar lijst van leningen wordt weergegeven. Tenslotte, de Itemweergave toont een ingedeelde weergave van de gegevens van een enkel item of rechtsonder een pictogramweergave van een groep items.

Het hoofdvenster van &appname; Het hoofdvenster van &appname;

### Kolomweergave

Elk van de velden in de verzamelingen kan getoond worden in de Kolomweergave, hoewel de velden Paragraaf, Afbeelding en Tabel waarschijnlijk niet nuttig zijn. Rechts klikken op de kop van de weergave opent een menu voor de selectie van zichtbare velden. De kolommen kunnen andere afmetingen krijgen en op elke manier gesorteerd worden en de instellingen zullen tussen sessies opgeslagen worden.

### Groepsweergave

The Group View groups the entries in a tree-view by any field which allows grouping. The number of entries in each group is shown next to the group name. Groups may be expanded or collapsed by clicking the arrow sign, or by double-clicking the item. Expanding and contracting all the groups are options in the right-click context menu. The tree may be sorted either by the group name, or by the count, by clicking on the header. A group may also be used as a filter for the Column View, by right-clicking on the group item.

When more than one field in the collection has the Format as a name option turned on, an additional group is added to combine all those fields into one single People pseudo-group.

Als een item geen waarde bevat voor het veld dat gebruikt wordt om de groepen te vormen, dan wordt het geplaatst in de (Lege) groep, die een rode map gebruikt.

### Filterweergave

Als een een filter is opgeslagen voor de verzameling, dan wordt de Filterweergave actief. Als u items toevoegt of wijzigt, worden ze automatisch gecontroleerd tegen de filters en toegevoegd of verwijderd indien van toepassing. Het filter kan worden gewijzigd door dubbel te klikken op het item om de Dialoog voor geavanceerd filteren te openen. Rechts klikken geeft u de optie om het geheel te verwijderen.

De Filterweergave De Filterweergave

### Uitleenweergave

Once entries are checked-out on loan, the Loan View is added to the window, so those borrowed entries may be tracked. Loans are tracked on a per-entry bases, so right-clicking on an entry item has an option for modifying the loan using the Loan Dialog.

De Uitleenweergave De Uitleenweergave

### Itemweergave

A formatted representation of the entry's values is shown in the Entry View. Templates are used for the layout and any additional graphics. Separate templates for each type of collection may be specified in the Configuration Dialog, along with custom colors and fonts.

All of the default templates honor the color and font selection, but other custom templates might not. The default templates also make &URL; fields active, which will open up with the default &kde; file association. When exporting to &HTML;, the current template is used for exporting the individual entry files.

In addition, when multiple entries are selected, an icon view is shown, using the first Image field in the collection. Entries may be selected as in the Column View. Right-clicking in the icon view will show a menu that changes the sorting criteria for the entries.

### Statusbalk

De statusbalk wordt gebruikt om u te tonen wat &appname; nu aan het doen is. Het bevat ook het totaal aantal items in de verzameling en als er een filter wordt gebruikt, hoeveel er nu zichtbaar zijn.

## Items bewerken

The Entry Editor is used to add and modify entries in the collection. Double-clicking on an entry in either the Group View or the Column View opens the Entry Editor with that entry. New entries may be created using the Collection menu, the toolbar icon, or the button in the Entry Editor itself.

Closing the Entry Editor when changes have been made but not saved will cause a warning message to appear. The fields are grouped by category and appear in the order that they appear in the Collection Fields Dialog. They may also be reordered.

De Itembewerker De Itembewerker

Clicking the field title for a &URL; field will open the link using the default &kde; file association. The &URL; selector button beside the text entry will open the default &kde; File Open Dialog, but the field is not limited to local files.

For Image fields, the Select Image... button opens up the &kde; image file selection dialog. The image is saved in the collection in the original format, and a scaled version is shown in the Entry Editor. The image may be cleared by using the Clear button. Cleared images are removed from the collection.

De Itembewerker voor velden Afbeelding De Itembewerker voor velden Afbeelding

The edit widget also supports drag-and-drop. Dragging an image file from a file-manager or browser window does the same thing as selecting the image in the File Selector. Dragging an image from the edit widget into a &konqueror; file manager window will save the image in that folder.

By default, the images are stored in the collection data file, keeping everything contained in one location. However, too many images will cause &appname; to slow down significantly as well result in a very large data file. Alternatively, &appname; can save the images separately, either in the `$`KDEHOME`/share/apps/tellico/data/` folder or in a folder in the same location as the data file. Loading and saving data files is much faster if images are stored separately, but the data files are no longer portable or archivable. Self-contained data files can always be created by using the File Export Export to Zip... menu item.

Table fields begin with five rows, but moving the cursor to the last row automatically adds another. For multi-column tables, only the first column is used for grouping or formatting.

De Itembewerker voor velden Tabel De Itembewerker voor velden Tabel

### Meerdere items bewerken

Multiple entries may be edited at the same time by selecting more than one in either the Group View or the Column View. If multiple entries are selected, the fields which contain the same value in every entry are enabled. If entries have different values, then the fields are disabled. Check boxes are added to the extreme right for each field entry which control whether the field is enabled or not, as shown in the screenshot below.

Only enabled fields will be modified when the entries are saved, which makes large-scale editing much easier. For example, to set the Medium of all the video entries in the collection, make sure the Medium field is enabled. Change it to DVD, then save the entries. Only the Medium field will be modified, preserving all the other field values for the entries.

De Itembewerker voor meerdere items De Itembewerker voor meerdere items

### Itemgegevens bijwerken

Entries may be automatically updated by querying the data sources available for the current collection type, which is very useful for combining information from multiple sources. For example, you may add a movie to your collection using the Amazon.com Web Services, and then update the entry with additional information from the Internet Movie Database.

Only empty fields are updated unless the setting for that source allows results to overwrite existing information. For external scripts, an update field must be specified in the source options.

The entry updating may be started via the right-click menu for an entry, or by using the Collection Update Entry menu item.

## Editing Fields

The Collection Fields Dialog allows you to add new fields to the collection, to modify the existing ones, or to delete fields altogether.

The &appname; Collection Fields Dialog The &appname; Collection Fields Dialog

### Field List

On the left side of the dialog is the list of the current fields. Modified fields are shown in bold italics. The buttons below the list will add or delete a field, and the arrows can be used to change their order. The order of the fields in the list is important because the Entry Editor uses the order for its layout. For each category, the fields will be laid out from left to right, according to the top-to-bottom order of the fields in the list.

### Veldeigenschappen

A field is defined by its title, type, category, description, and possibly a default value or some allowed values. The title is used everywhere to refer to the field in the user interface. The Entry Editor uses it to prompt for values. The Column View uses it as a column header. The different types of fields are explained in the Field Types section. The description is used as a tooltip in the Entry Editor, perhaps to provide an explanation of the field's contents. In addition, for fields with derived values, a value template is used to format the field's value. The default value is automatically added when creating a new entry. The list of allowed values for Choice fields should be separated by a semi-colon.

New fields may be any type, but changing the type of existing fields is restricted to compatible types, as shown in the table below:

### Allowable Field Type Changes

Current Type | New Type Allowed
Eenvoudige tekst | Simple Text, Paragraph, Number, &URL;, Table
Paragraaf | Simple Text, Paragraph
Keuze | Simple Text, Paragraph, Choice, Number, &URL;, Table
Keuzevakje | Simple Text, Paragraph, Checkbox, Number, &URL;, Table
Cijfers | Simple Text, Paragraph, Number, &URL;, Table
&URL; | Simple Text, Paragraph, Number, &URL;, Table
Datum | Simple Text, Date
Tabel | Simple Text, Paragraph, Table
Afbeelding | Afbeelding
Waardering | Choice, Rating

### Field Formatting

&appname; provides some capability for automatic formatting of field values. The simplest is auto-capitalization, which capitalizes every word except the articles. Title formatting moves certain articles from the beginning to the end of the field, for example, changing "The Return of the King" to "Return of the King, The". The title articles are configurable. Finally, name formatting tries to break up the string so that the last, or family, name of the person is shown first. Name prefixes and suffixes are configurable. Also, the special People group uses all fields with name formatting, even if the global setting is turned off.

All automatic formatting can be disabled by changing the global options in the Configuration Dialog. Globally, capitalization is a distinct option from formatting, so a title can be auto-formatted without being capitalized. Not all field types allow auto-formatting.

### Formatting Examples

Format Type | Field Value | Auto-Capitalized | Auto-Formatted | Auto-Capitalized & Auto-Formatted
Titel | the return of the king | The Return of the King | return of the king, the | Return of the King, The
Naam | tom swift, jr. | Tom Swift, Jr. | swift, jr., tom | Swift, Jr., Tom

### Veld Opties

Fields also have three general options. If auto-completion is enabled, &appname; caches the values for each field, and the Entry Editor offers automatic completion, using the standard &kde; settings. Not all field types allow auto-completion. &appname; also needs to know if a field may have multiple values or may be used to group the entries. A semi-colon is used to separate multiple values when editing an entry.

For efficiency, do not enable auto-completion unless you need it for the fields. The more fields with auto-completion in the collection, the slower it takes &appname; to load the file.

## Filtering Entries

The Advanced Filter Dialog allows you to limit the entries visible in the Column View to those that match one or more filter rules. The filter may be used to find the entries that meet all of the rules in the dialog, or just to find those that meet any of them. The Advanced Filter Dialog is also useful for advanced searching within a collection.

The &appname; Advanced Filter Dialog The &appname; Advanced Filter Dialog

Each row contains a single filter rule. Select the field to match in the first box in the row, then select a matching rule in the center. Rules may match values that contain a certain word, or are exactly equal. A regular expression may also be used to match entries, in which case the Edit... button becomes active for editing the expression, if &kregexpeditor; is installed on your computer. Finally, the word or string to match should be entered in the text box.

Up to eight (8) rules may be used in the filter. The More and Fewer buttons may be used to add or remove rules.

Filters may be saved, so that all entries which match are grouped together in the Filter View. The view is dynamic, so as entries are added or modified, the group is automatically updated. To save the filter, enter a name in the text box, and click the Save Filter button.

Previously saved filters may be modified by right-clicking on the filter item in the Filter View and selecting Modify Filter. The Advanced Filter Dialog is opened, and changes may be made to the filter's name or rules.

To find the science fiction books you've not read, check the Match all of the following button, set the first rule to Genre contains Science Fiction and the second to Read does not contain true. (For Checkbox fields, the internal value is true).

To find the books by Bujold or Weber, check the Match any of the following button, set the first rule to Author contains Bujold and the second to Author contains Weber.

## Generating Reports

&appname; can generate various reports about your current collection. The Report Dialog checks for all &xslt; templates in the installation path and in `$`KDEHOME`/share/apps/tellico/report-templates/`. So you can create new ones, and they are automatically found and included as options in the Report Dialog. Some complex reports may take a while to generate for large collections.

The templates that are installed with &appname; include a list of titles only, the default column view, a group view, a summary of all of the groups and the most popular values in those groups, a loan report, and a large report with cover images. Select the desired template and click the Generate button. Any report may also be printed or saved to an &HTML; file.

The &appname; Report Dialog The &appname; Report Dialog

The entries included in the report will be limited to the ones in the Column View so if you've got an active filter, the Report Dialog will use it.

## Loan Tracking

&appname; supports tracking loans of any entries in the collection. The Loan Dialog may be opened by using the Check-out menu item, or right-clicking on an entry. Multiple entries may be checked-out at once.

The borrower's name may be directly entered, or pulled from the default &kde; address book by clicking on the button next to the name entry. The check-out date is assumed to be the current date, but may be changed. The due date is optional, and other notes may be added about the loan.

If a due date is entered, and &appname; is compiled with libkcal support, a loan reminder may be added to the default &kde; calendar as a To-Do item. &korganizer; can be used to view those items.

When an entry is checked-out, the Loaned field is set to true. If no loaned field exists in the collection, one is added. Do not modify that field directly! Entries on-loan may be checked-in using the menu item, or right-clicking on an entry in the Loan View.

The &appname; Loan Dialog The &appname; Loan Dialog

## Algemene tips

These are the list of tips contained in the "Tip of the Day" list for &appname;.

If a book has more than one author, you should separate their names by a semi-colon, so that Tellico will know to split them and use them separately. Any other field which allows multiple values should be entered the same way. with a semi-colon (;) separating each value.

You can change which fields are shown in the list view by right-clicking on the column header.

You can add, edit, or modify the fields in the collection using the Collection Fields Dialog. The arrow buttons below the field list can be used to change the position of the field in the list, which affects the placement in the entry editor.

If you want to filter by a Checkbox field, a value of "true" should be used. If you'd like to filter to show only the science fiction books which you've not read, for example, check the Match all of the following button, set the first rule to have "Genre" "contains" "Science Fiction" (no quotes) and the second rule to have "Read" "does not contain" "true" (no quotes).

If a non-word character is used in the Quick Filter, the text is interpreted as a regular expression. To show only books which are by Weber or Bujold, for example, then type "weber|bujold" (no quotes) in the filter box.

U kunt meer dan een item tegelijk bewerken door de &Shift;- of &Ctrl;-toets in te drukken en meerdere items te selecteren.

You can convert an existing book collection to a bibliography, which can then be exported to bibtex or Bibtexml format.

If more than one field is formatted as a name, then an additional group named "People" is added to the collection, allowing authors and editors to be sorted or printed together, for example.

You can modify the appearance of the printed output by modifying the `tellico-printing.xsl` file. The file generates &HTML;, and the &CSS; within the stylesheet governs things like the font, the margins, etc.

Dubbelklikken op een item opent de Itembewerker.

You can add &HTML; tags to any Paragraph field for formatting, such as <b>bold</b> or <i>italic</i>.

In de Kolomweergave kunt u op een letter op het toetsenbord drukken om naar het volgende item te springen dat met die letter begint.

You can use derived values to combine values from multiple fields into a single value. Just check the derived value box and use a value template similar to "`Value: %{fielda}%{fieldb}`" where %{...} gets replaced with the appropriate field value. This is useful to collect multiple values in a single field, ⪚ for better grouping, and to combine fields of different types by respecting proper sorting at the same time. Consider for example a number field followed by a text subfield with entries 3b, 14a.