# Het handboek van &krecipes;

## Inleiding

&krecipes; is een toepassing die u in staat stelt om uw recepten te beheren, boodschappenlijstjes kan maken, een recept kan kiezen op basis van beschikbare ingrediënten en uw menu/dieet vooruit kan plannen.

## &krecipes; gebruiken

### Er vertrouwd mee raken

Wanneer &krecipes; start zal het venster de volgende componenten tonen —

- Een menubalk met selecties voor Bestand, Bewerken, Beeld, Hulpmiddelen, Instellingen en Help

- Een werkbalk met pictogrammen voor Nieuw, Opslaan en Afdrukken

- Een linker paneel met pictogrammen die de verschillende componenten van &krecipes; weergeven en de knoppen voor toegang

- Een rechter paneel, wat het hoofdvenster van &krecipes; is, dat standaard een lijst met categorieën van recepten bevat

Hier is een schermafdruk van het hoofdvenster van &krecipes;. Schermafdruk

Het hoofdscherm van &krecipes;

### Zoeken en bewerken van recepten

&krecipes; begint standaard met de component Zoeken/bewerken van recepten geselecteerd in het linker paneel van het venster.

Deze sectie beschrijft de methode voor het vinden van recepten in de component Zoek/bewerk recepten. Voor meer specifieke details over Bewerken van recepten, zie de sectie Bewerken van opgeslagen recepten

Met de knop voor de component Zoek/bewerk recepten geselecteerd, toont het hoofdvenster van &krecipes; het volgende —

- Een titel met de naam van de geselecteerde component

- De tabbladen Basis (de standaard) en Geavanceerd

- Een tekstvak om `zoektermen in te voeren`

  Een mooie functie hier is dat &krecipes; zoekt naar recepten op het moment dat u tekst in het vakje Zoeken: intypt. U wilt bijvoorbeeld een recept vinden met het woord appel, het recept dat getoond wordt in de weergave van recepten zal alleen die recepten tonen die die tekenreeks bevatten en zal verder gefilterd worden met elke verder ingetypte letter.

- Een lijst met alle categorieën van recepten

- Knoppen voor tonen, bewerken en verwijderen van de geselecteerde recepten.

U zult het pictogram rechtsonder in het paneel met de lijst met componenten opmerken. Dit pictogram verschijnt in alle componenten van &krecipes; en wanneer er op wordt geklikt, opent dit de overeenkomstige sectie van dit handboek als op een willekeurig moment extra hulp nodig hebt.

With the Basic tab active and the list of recipe categories displayed, a category can be expanded by clicking on the + button beside the category name. The category will automatically expand to show your recipes and/or subcategories, if there are any. From this list, you may select a recipe to open, edit or delete (see the section Editing Saved Recipes for more information). Additionally, if you select just one recipe, the status bar will show the date that it was created, modified and last accessed .

Omgekeerd zal klikken op de knop - naast de naam van de categorie deze invouwen.

#### Het menu Rechts klikken

&krecipes; allows a multitude of ways to perform various actions on your recipes. These actions are described in their corresponding sections in this Handbook. However, in addition to the various key combinations and/or menu selections, right-clicking on a recipe in the Basic search pane will bring up a menu from which the following actions can be selected —

- Recept(en) tonen – toont de geselecteerde recepten.

- Recept(en) bewerken – opent het geselecteerde recept voor bewerken.

- Exporteren... – exporteert het geselecteerde recept. Zie de sectie Exporteren van recepten naar andere formaten voor een complete beschrijving van dezes functie.

- Aan boodschappenlijst toevoegen – voegt het geselecteerde recept toe aan uw boodschappenlijst. Zie de sectie De boodschappenlijst voor informatie over het gebruik van de boodschappenlijst.

- Copy to Clipboard – Makes a copy of the recipe and places in on the clipboard so that it can be pasted into another application for example, an email. The format of the copy is dependent on what is selected as a preference. For a complete description of the Copy to Clipboard functionality, see the section Copying to the Clipboard.

- Categorize – This option applies only when there are recipes listed as Uncategorized. Allows you to select one or more recipes that appear in the Uncategorized group and place them in the appropriate category by selecting the it from a pop-up instead of having to edit the recipe(s).

- Remove From Category – Removes the recipe from its current category. If the recipe is not included in any other category, places it in the Uncategorized group. From the Uncategorized group, the recipe can be selected for editing to re-categorize it. See the section Editing Saved Recipes for more information.

- Verwijderen – verwijdert de geselecteerde recepten uit de database.

Sommige van de bovenstaande uitgelegde acties kunnen toegepast worden op meerdere recepten. U kunt verschillende recepten aldus selecteren: hou de &Ctrl;-toets ingedrukt en selecteer de gewenste recepten door op ze te klikken.

#### Het tabblad Geavanceerd

Het doel van het tabblad Geavanceerd is het leveren van geavanceerde zoekopdrachten. Zoekopdrachten naar recepten kunnen gemaakt worden op basis van negen zoekcriteria, alleen of in combinatie —

- Titel

- Ingrediënten

- Categorieën

- Auteurs

- Opbrengst

- Bereidingstijd

- Instructies

- Metadata

- Waarderingen

Hier is een schermafdruk van de beschikbare componenten in het tabblad Geavanceerd zoeken van &krecipes;. Schermafdruk

De component Geavanceerd zoeken van &krecipes;

When the Advanced tab is selected, the components will be collapsed and show >> beside the label of the component. To expand a section, simply click on the label of the component. Conversely, with the component expanded, << will show beside the label and clicking on the label will collapse the section.

A section can be collapsed simply to get it out of the way when it is not needed for a search. However, if you enter search criteria in any one of the search components, you can close the component and the search criteria will still be considered in the search.

For all search components in the Advanced tab, click the Search button to initiate the search once all desired search criteria have been selected. Clicking the Clear button will clear the search selections and the search results.

Only recipes meeting ALL criteria will display! No matter which parameters are used for the recipe search, should no recipes meeting the specified criteria be found, the message — No matching recipes found — will display in the recipe list area.

De verschillende componenten worden als volgt gebruikt —

##### Het zoeken in de Titel

Enter words that appear as part of the recipe title, for example, Chicken Rice. Using these words, recipes that contain the words Chicken, or Rice, or both in the title will appear in your results. However, if you click the tickbox beside the Require All Words label, only those recipes that have both Chicken AND Rice in the title will be found.

##### Het zoeken in Ingrediënten

In the Ingredients component of the Advanced tab, single or multi-word ingredients can be searched for. Single word ingredients are entered in the text box with a space between each ingredient. Multi-word ingredients are enclosed in quotes, for example, ice cream.

Searches may also be done using wild cards – * to replace any number of characters, or ? to replace a single character. For an explanation on the use of wildcards, see the section Using Wildcards in Searches.

Although the ingredient that you are searching for might appear in the title of the recipe listed in the search results, it is the ingredient that has caused a particular recipe to show in the list, NOT the fact that the ingredient name might appear in the title.

Recepten kunnen opgezocht worden op basis van verschillende criteria —

- Uses all: – If the search terms are entered in this text box, it is being stated that the recipe(s) MUST contain all ingredients listed and therefore, only those recipes that contain ALL ingredients will be returned as results of the search.

- Uses any of: – If the search terms are entered in this text box, it is being stated that the recipe(s) MAY contain any of the ingredients specified. The search results will return recipes that contain ANY OR ALL of the ingredients.

- Without: – If the search terms are entered in this text box, it is being specified that the recipes returned as results of the search MUST NOT contain ANY of the listed ingredients.

##### Het zoeken in Categorieën

As in the Ingredients component of the Advanced tab, search parameters in the Categories component are entered with a space between each parameter, or enclosed in quotes for multi-word parameters. You can also use wildcards for searching categories. See the section, Using Wildcards in Searches for an explanation on the use of wildcards.

Searching for recipes in Categories is done by specifying the criteria on which you wish to base the search as follows —

- In all: – indicates that the recipes returned in the search should be in all the categories listed. This search might be used if you are looking for a recipe that appears in the Dessert category and also, in the Cakes category.

- In any of: – is specifying that recipes returned in the search may be from ANY of the categories, but a recipe may not necessarily be found in all categories listed.

- Not in: – is indicating that the recipes returned in the search MUST NOT be from the categories listed.

het gebruik van zoeken met Categorieën is het meest nuttig gecombineerd met andere zoekparameters.

In de volgende schermafdruk is gespecificeerd dat recepten gezocht moeten worden in de categorieën Desserts en Hoofdgerechten.

Hier is een schermafdruk van een uitgevoerde zoekopdracht in &krecipes; met slechts één gespecificeerde categorie. Schermafdruk

Geavanceerd zoeken – alleen categorie gespecificeerd

In de volgende schermafdruk wordt nog steeds naar recepten gezocht in de categorieën Dessert en Hoofdmaaltijd. Recepten echter die een bepaalde vorm van het woord appel bevatten (let op het gebruik van het jokerteken) worden uitgesloten.

Hier is een schermafdruk van een uitgevoerde zoekopdracht in &krecipes; met een categorie en extra criteria. Schermafdruk

Geavanceerd zoeken – ingrediënt en categorie gespecificeerd

##### Het zoeken in Auteurs

Bent u op zoek naar een recept dat u is gegeven door een bepaalde persoon of in &krecipes; is gekomen uit een specifiek tijdschrift? De component Auteurs van het tabblad Geavanceerd biedt u de mogelijkheid om dat recept te vinden!

As with the searches previously described, you can search using wildcards. For a description of using wildcards, see the section Using Wildcards in Searches. Names are entered with a space between if, for instance, you are searching for a recipe by only a first name. Whole names, or for situations where you have entered a magazine name as the recipe source (Author), the name is entered enclosed in quotes, for example, Jason Kivlighn, or Vegetarian Times.

Zoekopdrachten kunnen op de volgende manieren wordt uitgevoerd —

- By any of: – This search would be used if the recipes desired are by ANY of the authors listed in the text box.

- By all: – This search would be used in situations where recipes have co-authors. An example of this would be: Canadian Living Cooks Elizabeth Baird. This would return only recipes where Canadian Living Cooks and Elizabeth Baird are both listed as the recipe source/author.

- Not by: – This search would be used when you want to exclude certain authors from your search.

##### Het zoeken op Opbrengst

The Yield component in the Advanced tab is slightly different from the searches described thus far in that it must be Enabled in order to have it utilized in the search criteria.

To enable Yield as a criteria for your search, click the tick box beside the Enabled label. Once you have designated this to be part of your search, you can define the yield by selecting from the drop-down menu as follows —

- Yields at least: – This would be specified if you want the recipe(s) to be able to provide a minimum number of portions. The recipe(s) returned COULD yield MORE than this number, but cannot yield less.

- Yields at most: – This would be specified if you want recipe(s) that are returned in the search to yield NO MORE THAN a specified number of portions.

- Yields about: – This would be used to approximate the number of portions you want in the recipe(s). The recipes(s) returned could yield SLIGHTLY MORE or SLIGHTLY LESS than a specified number of portions.

After defining the type of search that is desired, the spinbox next to the drop-down menu is used to increment (or decrement) the actual yield amount that goes along with the defined parameters.

When inputting recipes, a yield type, for example, servings or dozen is allowed. Keep in mind that when including Yield as a search parameter, using a yield of 2 in a search will return results for 2 dozen, 2 servings, 2 loaves, but will NOT return results for 24 cookies, 24 squares, etc., even though these are technically 2 dozen.

##### Het zoeken op Bereidingstijd

The Preparation Time component in the Advanced tab is used in the same manner as the Yield component. It must be Enabled in order to have it utilized in the search criteria.

To enable Preparation Time as a criteria for your search, click the tick box beside the Enabled label. Once you have designated this to be part of your search, you can define the time criteria by selecting from the drop-down menu as follows —

- Ready in at most: – This would be utilized if you want the recipe(s) to be ready within a specified time frame. The recipe(s) returned COULD be ready in LESS THAN or EXACTLY the time specified, but cannot be ready in greater than the time chosen for preparation.

- Ready in about: – This choice allows some flexibility and would be used to approximate the time needed to prepare the recipe. The recipe(s) that are returned in the search can be ready in SLIGHTLY MORE, EXACTLY, or SLIGHTLY LESS than the time specified for preparation.

After defining the type of search that is desired, the spinbox next to the drop-down menu is used to increment (or decrement) the actual time parameter. Select the digits before the : symbol to increment the hour portion of the time and then select the digits after the : symbol to increment the minute portion of the time. The hour and minute parameters can be used alone or in combination.

##### Het zoeken in Instructies

Are you interested in finding a recipe that contains certain instructions or is prepared a certain way? The Instructions component in the Advanced tab allows you to search the recipe instructions for specific terms that might include a preparation method, such as Bake at 350, or a suggested garnish. However, these are just examples of how this component might be used. Any term(s) that might appear in the Instructions of a recipe can be used.

To utilize the Instructions search, simply type the keyword or keywords in the text box beside the Keywords: label. Enter keywords separated by spaces, or multi-word instructions enclosed in quotes. Wild cards can also be used. For instructions on the use of wildcards, see the section Using Wildcards in Searches.

Should you require that the search contain all the keywords listed, click the tick box beside the Require All Words label.

##### Het zoeken in Metagegevens

By definition, Meta Data is data about data, or expressed another way, is information that describes another set of data. The Meta Data component in the Advanced tab allows you to search your recipes based on information about them, as follows —

- Aangemaakt: – dit is de datum waarop het recept is aangemaakt.

- Gewijzigd: – dit is de datum waarop de laatste wijziging is aangebracht in het recept.

- Laatst geopend: – dit is de datum waarop het recept het laatst is geopend of gebruikt.

For each of the Meta Data descriptions, the date may be entered as an exact date if this is known or desired, or as a date range. Dates are interpreted in the format that has been set within the &kde; environment. For example, if the date format has been set to display as DD-MM-YYYY, you may enter the date directly into the text box in the format of DD-MM-YYYY. When entering the date, the two initial digits of the year may be entered, but are not absolutely necessary. However, it is imperative that you use the exact separator i.e. the dash (–), in the example, as set in the date format in &kde;. You may also use the drop-down arrow beside the box in which you want to enter the date to reveal a calendar.

If you choose to enter the date directly into the text box and are using a date range as opposed to an exact date, ensure that the dates for the start and end of the range are entered in the same format. For example, if you enter the starting date for the range in the format of DD-MM-YY and the ending date for the range in the format of "DD/MM/YY", either no recipes will be found or the results returned will include only those recipes that fit the criteria for the starting date, if this date agrees with the format as set in &kde;.

###### Het Interface van de kalender

De kalender stelt u in staat om gemakkelijk door maanden en jaren te lopen om een datum te selecteren.

When the calendar is revealed, the current month is shown and the current day is highlighted. Below the calendar is a text box, which shows the date and beside this a drop-down menu that displays the specific week of the year.

One way to select a date would be to use the drop-down menu to select a particular week in the year, for example Week 26. Doing this will change the date in the text box and will also position the highlighted date in the calendar to the beginning of Week 26. Note that Monday is used as the starting day for the week. To use a date from this week either, click the highlighted date in the calendar, or select another date from the week and the date will be transferred to the Meta Data text box where the calendar was utilized.

Below the text box that is displaying the date at the beginning of the chosen week of the year (or the current week if no choice has been made), there is a list of additional choices for date selection. Specifically, these are: – Today, Tomorrow, Next Week, and Next Month. Clicking on one of these selections, will result in this date being shown in the Meta Data text box being used. It should be noted here that each of the choices is relevant to today's date. For instance, if today's date is the 15th, clicking the Today would place today's date in the Meta Data text box being used. Clicking Tomorrow would, of course, place tomorrow's date in the box. Next Week would place the date that is one week forward today in the box. Next Month would place next month's date that corresponds to today's date in the box, in the example from above, the 15th of the previous month.

Additionally, the calendar itself can be utilized to navigate to a specific date. When the arrow beside the text box in which you want to display the date is clicked, thus revealing the calendar, there are a number of ways to select a date —

- Klik op de getoonde maand – Dit zal een lijst tonen waaruit u een gewenste maand kunt selecteren.

- Klik op het getoonde jaar – dit toont een tekstvak dat het huidige jaar toont, maar waarin een ander jaar ingevoerd kan worden.

To the left and right of the month and year heading on the calendar, there are arrows that can be used to navigate through various months and years. Clicking on the icon will reveal the previous month's calendar. Conversely, clicking the icon will advance the calendar to the next month.

Navigating between years is done in the same manner, but the is used to navigate to previous years and the is used to navigate to following years. In each case, once a date is selected, it will be transferred to the text box at the point where the calendar was selected.

##### Het zoeken op Waardering

Wanneer zoeken op waardering is geselecteerd, kan het op twee manieren gedaan worden —

1. Op gemiddelde:

2. Op criteria:

###### Zoeken op gemiddelde waardering

If you choose to search by average rating, select the Radio Button beside the By average: label. Then, enter a numerical value in the text box that precedes the label stars. This value is the average of the number of stars assigned to each parameter under which the recipe was rated and can be a fixed value or a range, for example 3-4 stars. Fractional amounts are also permitted, for example, 3.5.

Once you have entered your search parameters, click the Search button and the recipes that meet the search criteria will display under the Title label on the right. Should no recipes meet the criteria, --- No matching recipes found --- will display.

###### Zoeken op criteria voor waardering

To search by rating criteria, select the Radio Button beside the By criteria: label. First, select the criteria that you want to use for your rating from the drop-down menu. In the text box next to this, enter the value of the number of stars for which you want recipes displayed, for example, 4. Entry is permitted in the following formats —

- gehele getallen, ⪚ 3

- getallen die fracties bevatten, ⪚ 3,5

- reeksen met gehele getallen, ⪚ 3-4

- reeksen met fracties, ⪚ 3,5-4

Note that, if you enter a fractional amount, for instance, 3.5, it will display in the format that you have chosen for your preferences when transferred to the listbox – i.e.3.5 will display as 3.5 if you have chosen numbers to display in decimal format, or 3½ if you have chosen numbers to display as fractions. See the section Customizing Formatting for an explanation of setting formatting preferences.

Additionally, if no range is specified, the search will find recipes that have an assigned star rating in a range of ±½ of the value entered, 3½ to 4½ stars in the example.

Once you have chosen the parameters by which you want to search, click the beside the text box in which you entered the number of stars to have the criteria added to the list. More than one criteria may be utilized in the search. Once you have entered your search parameters, click the Search button and the recipes that meet the search criteria will display under the Title label on the right. Should no recipes meet the criteria, --- No matching recipes found --- will display.

Voor de Engelse taal is het decimale scheidingsteken . (punt), als u echter in &kde; een andere taal hebt ingesteld, dan kan het decimale scheidingsteken verschillen (in het Nederlands een komma). Merk op dat als u een ongeldig getal intikt, de tekst rood wordt om u te waarschuwen.

#### Jokertekens gebruiken in zoekopdrachten

Wildcards are a single character used to replace either multiple or single characters in a text string. Wildcards supported in &krecipes; are the * and ? characters. The * character is used to replace any number of characters in a string, while the ? is used to replace a single character. Both can be used to replace any alpha-numeric character, including a space.

Voorbeelden van zoekopdrachten met jokertekens

Zoeken met jokertekens | Mogelijk teruggegeven resultaten
rund* | runderbouillon rundvlees runderhaas
can*cherries | canned cherries candied red cherries candied green cherries
egg? | egg eggs

### Invoeren en bewerken van recepten

#### Een nieuw recept toevoegen

Om een nieuw recept toe te voegen, klik op het pictogram dat verschijnt in de eerste positie op de werkbalk &krecipes;. Het scherm Recept bewerken zal verschijnen.

Het scherm Recept bewerken heeft vier tabbladen. Elk biedt de invoer van een verschillend aspect van het recept. Deze tabbladen zijn —

- Recept

- Ingrediënten

- Instructies

- Waarderingen

Hier is een schermafdruk van het invoerscherm van een recept met de 4 tabbladen. Schermafdruk

De interface voor invoer het het recept

It should also be noted that in the left-hand pane of the window, a button shows at the bottom of the component list that initially displays Write the recipe title here. This will change to the name of the recipe once it has been entered.

#### De beschrijving van het recept

##### De naam van het recept toevoegen

De titel van het recept wordt ingevoerd in het tekstvak met de prompt Schrijf de titel van het recept hier.

##### De auteur/herkomst van het recept toevoegen

Om een auteur van het recept toe te voegen, klik op het pictogram dat verschijnt rechts van het vakje Auteurs.

A window will appear where the author or contributor of the recipe can be selected from the drop-down menu. Once selected, transfer the name to the list box below by clicking on the button that appears to the right of the drop-down menu.

- An author's name can be typed directly into the text box and transferred to the list box as described above. As you start entering characters, if there are authors that match the text string typed, the menu will display a list of existing choices from which you can choose to transfer the author's name to the list box, as described above.

  However, in the situation where the author does not exist in your list, no choices will be listed as you type and when you click the button to transfer the author to the listbox, the author will automatically be added to your list of authors as well. Also see The Authors Component. for information on adding an author to the list.

- Een auteur kan ook uit de lijst verwijderd worden door te klikken op de knop .

Klik op de knop OK om te accepteren. Het venster zal zich sluiten en de naam van de geselecteerde auteur zal onder de kop verschijnen.

Om de selectie van een auteur te annuleren, klik op de knop Annuleren.

##### De categorie van een recept selecteren

Vervolgens wordt de categorie van het recept geselecteerd door te klikken op het pictogram naast het vakje categorie.

Om een categorie te selecteren, klik op het keuzevakje naast de naam van de categorie en klik op de knop OK om de selectie te accepteren of op de knop Annuleren om de selectie te annuleren. Op beide manieren zal het venster sluiten.

It is also possible to add a category here. Simply click on the New Category... button. Add a new category in the same manner as described in the section entitled The Categories Component.

##### De opbrengst en het type instellen

Setting the amount that the recipe will yield is performed by entering a value in the text box beneath the Amount label. It is possible to enter a numerical range for this number, for example, 3-4. When entering a range, if an incorrect value or format is entered, the entry will turn red indicating that a correction is necessary.

The second part of entering a yield is to enter the type. This is done by entering text in the text box beneath the Type label. The text entered can be anything you choose that is appropriate for the recipe yield type, for example, servings, dozen, or squares. As you begin to type the yield type, &krecipes; will match it to any previously entered yield types and if any are found, they will appear in a list from which you can select the appropriate one.

##### Bereidingstijd specificeren

De tijd die het neemt om een recept te bereiden wordt aangeven met gebruik van een numeriek keuzeveld.

De tijd moet echter worden opgegeven in twee stappen —

1. Selecteer de cijfers voor het symbool : die de uren specificeren en verhoog de tijd totdat het gewenste aantal is bereikt.

2. Selecteer de cijfers na het symbool : die de minuten specificeren en verhoog de tijd totdat het gewenste aantal is bereikt.

##### De standaard foto wijzigen

In the Recipe tab, the displayed photo can also be changed by clicking on the ... button and selecting a photo for insertion. Alternatively, a photo may be inserted by dragging a graphic from any other application, for example a web page, and dropping it onto the photo in the Recipe tab while in edit mode.

De wijziging in de foto wordt alleen op het huidige recept toegepast.

- To revert to the original, &krecipes; graphic, click on the button. This can be done before the recipe is saved or after saving it.

- To display NO photo in the recipe, refer to the section Selecting Items to Display for further instructions.

Here's a screenshot of a completed recipe description in the Recipe tab of the &krecipes; recipe entry interface. Schermafdruk

New Recipe Entry – The Completed Recipe Tab

#### Entering Recipe Ingredients

To enter the recipe ingredients, click on the Ingredients tab. By default, the radio button beside the label Ingredient: is selected. However, &krecipes; also allows the entry of a Header: by selecting the radio button beside this label.

Ideally, the header should be created first, for example Cake or Frosting. To do this, ensure that the Header: radio button is selected. Enter the desired name for the header in the text box then, press the &Enter; key, or click the Add ingredient button located at the top right-hand side of the ingredient list. Once this is done, the radio button will automatically revert to the Ingredient: selection. Then, ingredients can be entered. You will note that as you enter each ingredient, it will appear below the header indented in a file tree type of format.

Although it is ideal to enter the header first and then the ingredients associated with that header, you can also enter the header after entering the ingredients. Enter the header as described above, then move the ingredient into the header by utilizing the or button to position the ingredient until it appears indented below the appropriate header.

Ingredients are entered by filling in the appropriate text box under the headings —

- Ingredient: – the ingredient is entered here, for example, Sugar

  - Type in the first few letters of the ingredient. If it exists in the ingredient list, it will appear in the text box grayed-out. To select the gray-out ingredient, tab to the next text box.

  - The Ingredient can also be selected from the drop-down menu.

- Amount: – the amount of the ingredient required, for example, ½ or 1-2 --> note that &krecipes; will allow the entry of ranges for ingredients

- Unit: – the unit of measurement, for example, teaspoon

  When you enter a unit, if it does not exist in your Units list, it will automatically be added and a dialog box will appear prompting for the entry of a plural for the unit. Enter the plural in the text box beside the label Plural:. Additionally, you can add an abbreviation for both the singular and plural forms of the unit as shown in the following diagram.

  A drop-down menu is also available for selecting a Type: for the new unit. Choices for this are:

  - Mass, for those units that are based on weight, for example, pound

  - Volume, for those units that are based on a volume measure, for example teaspoon, fluid ounce, or cup

  - Other, for those units that are neither a neither mass, nor volume or where a weight might be dependent on the size of the unit, for example bag

  Specifying the unit type is important for the purpose of your unit conversions which, in combination with nutrient weights, help determine the nutrient values in your recipes. For a more detailed explanation of adding and maintaining units of measure, see The Units Component. For more information about ingredient weights, see The Ingredients Component.

- Preparation Method: – the method of preparing the ingredient, for example, chopped

  The Preparation Method can also be selected from a drop-down menu.

  &krecipes; will accept multiple preparation methods in a comma-separated list, for example, peeled,chopped

&krecipes; also permits the entry of alternate ingredients. To enter an alternate ingredient, simply click on the tick box that appears between the Preparation Method: text box and the OR label. A row identical to the one that you have just finished will appear for completing the alternative choice.

To add the ingredient(s) to the ingredient list, simply press the &Enter; key.

Alternatively, click on the Add Ingredient button on the right-hand side of the ingredient list.

- If a particular field is not required to describe an ingredient it can be left blank!

- An ingredient may be removed from the list by clicking on the button to the right of the ingredient list.

- An ingredient may also be repositioned in the list by clicking on the or the button that appear on the right of the ingredient list.

- Once an ingredient has been transferred to the ingredient list, the Amount, Units and Preparation Method fields may be edited by double-clicking on the particular component that needs to be changed.

Here's a screenshot of the completed Ingredients tab in the &krecipes; recipe entry interface. Schermafdruk

Entering Ingredients – Ranges for the Amount and Alternate Ingredients are permitted

##### Looking After Nutrients

Directly beneath the ingredients list, there is a visible means to obtain the status of your recipe nutrients. Beside the label Property Status:, text and an LED style indicator are used to depict this information.

A green status indicator means that your nutrient information is complete. However, you will note from the above graphic, that the nutrient information for this recipe is Incomplete and the indicator shows as red. To find out exactly what is needed to complete the nutrient information, click the Details button. A window will appear explaining what the problems are, for example: —

This dialog is telling you that, for the ingredient apples, there are two possible reasons for the property or nutrient information being incomplete: —

1. An ingredient weight or nutrient information has not been provided.

   Ingredient weights and nutrient information are set in the Ingredients component. Note that you can also click the links to show a dialog to input the property information for the corresponding ingredient. See The Ingredients Component for instructions on all aspects of setting ingredient details.

   of,

2. Conversion information is lacking.

   For this example, you are being told that a conversion from No unit to cup and cup to grams cannot be done. Conversion factors for your units are set in the Units component. For more information on Units and their conversions see The Units Component.

An entirely different message would result on clicking the Details button had the unit in the above screenshot been supplied with no preparation method specified.

The message in the above graphic also indicates that an approximation will be made for the ingredient butter because &krecipes; cannot find weight information that is specific to the preparation method melted when associated with this ingredient.

We can use the following table to assist in making a correction for apples.

Maat | Diameter | Equivalent 1 | Equivalent 2 | Equivalent 3 | Equivalent 4
1 large apple | 3 3/4" (9,5 cm) | 2 cups, sliced or chopped | 1 1/2 cups, finely chopped | 1 1/4 cups, grated | 3/4 cups, sauce
1 medium apple | 2 3/4" (7 cm) | 1 1/3 cups, sliced or chopped | 1 cup, finely chopped | 3/4 cup, grated | 1/2 cup, sauce
1 small apple | 2 1/4" (5,7 cm) | 3/4 cup, sliced or chopped | 3/4 cup, finely chopped | 1/2 cup, grated | 1/3 cup, sauce
1 pound apples |  | 2 large apples | 3 medium apples | 4 small apples |

Information for the compilation of the above table can be found at .

Using the above table and assuming that the size of the apples is medium, you might add a weigh entry for medium apples in your ingredient weight table. See The Ingredients Component for explicit instructions on doing this.

The above table indicates that 1 pound of apples is equivalent to 3 medium apples. However, the weight table in the Ingredients Component requires that the weight be in grams. If we know that 1 pound equals 454 grams, and that 3 medium apples weigh 454 grams, then 1 apple will equal 151.3 grams. We will assume that this conversion has been added correctly to your weight table. Also, if the equivalent has been added to the weight table with no preparation method specified, you will have to remove the preparation method sliced in order to completely update the status indicator for apples.

After adding the weight for apples in the Ingredients Component, if you return to your recipe and the LED status indicator hasn't changed, you can click on it to cause an update.

To assist you with your conversions, &krecipes; has a nifty tool that can be found by selecting Tools and Measurement Converter. This helper will be more fully discussed in Using the Measurement Converter.

After making the adjustment for apples, the LED status indicator will turn yellow because nutrient information is complete, but an approximation has been made for the ingredient butter. The Property Status: of your recipe will show as Complete, but approximations made. Here, you can choose to do one of the following: —

1. Choose to enter a weight for melted butter in your weight table

2. Accept the approximation, in which case, your status LED will remain yellow

3. Remove the preparation method from butter, if it will not adversely affect the preparation of your recipe.

Choosing 1 or 3 above will allow &krecipes; to obtain accurate weight information for the ingredient and your status indicator LED will turn green and the Property Status: will show as Complete.

The Help button will connect you to this section of the &krecipes; Handbook.

##### Copying Recipes from Other Sources

Do you need an easy method of getting recipe ingredients into &krecipes;? You can do that with the Copy/Paste functionality!

Find the recipe that you wish to enter into &krecipes;. Start the interface for entering a new recipe and enter the appropriate parameters in the Recipe tab. Move to the Ingredients tab. Copy the recipe ingredients from your chosen source and initiate the Copy/Paste interface by clicking the which appears as the last item in the group of icons to the right of the ingredient list. The recipe ingredients will appear in the upper portion of the Ingredient Parser window.

Make any edits that you wish in this portion of the screen. For example, if the recipe lists an ingredient as sugar and you know that the corresponding item in your ingredient list is granulated sugar, you may want to change this. For any ingredient or unit that you do not alter in this portion of the screen, the ingredient and/or unit will be added to your ingredient and/or units list if it does not exist.

Once your ingredients are formatted to your liking, click the Parse Text button. The ingredient list will be transferred to the lower portion of the window beneath the label Ingredients as understood by &krecipes;:. From this portion of the screen, you can set any Headers by clicking on the Set Header button to the right.

Click the OK button that appears in the top right-hand corner of window to transfer your ingredients to your recipe. You can also choose not to proceed with the addition of the ingredients by clicking on the Cancel button which will close the window.

Once the ingredients have been transferred into the ingredient list for your new recipe, they can be moved or removed as describe in the section Entering Recipe Ingredients above. In addition the amount, unit or preparation methods can be edited, also as described above.

You can now proceed to enter the recipe instructions as described below. The method for preparing your recipe can be copied from the source that you are using and pasted into the Instructions tab.

Here's a screenshot of the edited ingredients in the &krecipes; Parser interface. Schermafdruk

The Completed Ingredient Parser

#### Invoeren van de instructies voor het recept

Om de instructies voor het recept in te voeren klik op het tabblad Instructies.

Invoeren van de instructies van het recept is gemakkelijk – in de witte geboden ruimte, typ eenvoudig de noodzakelijke stappen in om de bereiding van het recept.

To make absolutely sure that typing is done in the correct area, the prompt `Write the recipe instructions here` is displayed!

A VERY COOL part of entering the recipe instructions is the Auto Completion feature! This is a real-time and effort saver if your instructions refer to many of the ingredients in your ingredient list, and/or if your ingredient names are lengthy. This is how it works —

In the Apple Crisp recipe shown in the screenshot, we have the ingredient brown sugar. As you begin typing brown sugar in your recipe instructions, &krecipes; will match typed characters with ingredients in your recipe ingredient list and automatically complete the remaining characters.

For example, if you type b, the characters brown sugar are the ones that will be auto-completed and inserted into the instructions. The auto-completed characters will appear highlighted and you can choose to accept the suggested ingredient by pressing the &Enter; key.

However, suppose that in your instructions, you simply wanted to refer to brown sugar as sugar and you enter the character s. &krecipes; will search the ingredients in your recipe and match the first ingredient beginning with s that it finds, if there is one. If there is no ingredient in your recipe ingredient list beginning with s, nothing will happen – you will just continue typing the word sugar.

If there is another ingredient beginning with s in your recipe ingredient list, for instance, salt, the remaining characters, i.e. the alt, will be auto-completed and highlighted. Simply press the Delete key on the keyboard to remove the unwanted characters and continue typing. Alternatively, you can just continue typing the entire word and your instructions will remain as typed.

Hier is een schermafdruk van het voltooide tabblad voor Instructies in het interface voor invoer voor het recept in &krecipes;. Schermafdruk

Nieuw recept-item – het voltooide tabblad Instructies

#### Waardering van recepten toevoegen

&krecipes; allows you to rate your recipes! Ratings by multiple people are allowed, so each of your recipe tasters can provide their own input. Additionally, each rating can include multiple rating parameters. The default parameters against which you can rate your recipe are —

- Smaak

- Uiterlijk

- Bereidingsgemak

- Originaliteit

- Geheel

Initially, in the Ratings tab, there is only a blank screen with the Add Rating... button at the bottom. Clicking this button will start the interface for entering ratings.

The Ratings interface is comprised of the following elements —

- Rater: – this is the name of the person providing their opinion of the recipe

  To complete this element `enter the rater's name` in the text box that appears beside the label Rater:.

- Criteria: – this is the criteria on which the recipe is rated

  Select the criteria against which you want to rate the recipe from the drop-down menu that appears beside the Criteria: label. Five default choices exist for rating criteria, as listed above, but if you have another against which you want to rate your recipe, it can be typed directly into the text box and will automatically be added to your rating criteria list.

- Stars: – this is the number of stars that you wish to assign to the particular criteria that you are rating on

  Star ratings are completed by clicking on a star. Clicking on the left-hand side of any star will provide a ½ star rating. Clicking on the right-hand side of the star will provide a full star rating.

  It is unnecessary to click on each star individually. For instance, if you are rating the recipe on the Taste criteria and you want to assign this a 4½ star rating, click on the left hand side of the 5th star.

  Once you have completed the star rating for the recipe, click the Add button to add the rating to the rating list. At this point, you can continue to rate the recipe against other criteria in the same manner.

  From within the rating list, both the rating criteria and the star rating can be edited by double clicking on either item. The rating criteria is edited the same way any text edit is done. To edit the star rating, double click the stars and then type the numerical value for the number of stars that you wish to assign to the rating. Once you press the &Enter; key, the rating will show the graphical stars.

  Should you change your mind and wish to remove any of the rating criteria, select it in your rating list and click the Delete button.

- Comments: – this is any added information that you wish to note for the recipe, for example, an enhancement to improve the recipe, or a serving suggestion such as Great served with ice cream

  To enter a comment, simply position your cursor in the white space beneath the Comments: label and begin typing.

Once you are satisfied with your ratings, click the OK button to complete the addition. The smiley graphic that appears to the left of the rating list is indicative of the overall rating of the recipe, from poor to excellent. This graphic will not appear in your recipe when it is viewed.

Any rating can be removed from the screen by clicking the Remove button beneath the rating that you wish to remove. Additionally, you can use the &Alt;M key combination. A rating can be edited by clicking on the Edit... button. When you choose to edit a rating, the same interface that was used to originally enter the rating is opened. Each rating has its own Delete and Edit... buttons.

Here's a screenshot of the completed Ratings tab in the &krecipes; recipe entry interface. Schermafdruk

New Recipe Entry – The Completed Ratings Tab

#### Recipe Actions

OK! Now that the recipe has been input, what needs to be done?

The following options can be selected —

- Spellingcontrole – wordt gedaan door Spellingcontrole te selecteren uit het contextmenu van het invoergebied in het tabblad Instructies

- Opslaan – klik op de knop Recept opslaan onderaan het scherm

  The Save recipe button can be used to save the recipe at any point during the input. As with any other application, when editing, it is always a good idea to save frequently!

- Show recipe – click on the Show recipe button to view the recipe

  To view a recipe, it must be saved. If the recipe has NOT been saved at the time that the Show recipe button is clicked, the following alert will appear —

  Voordat u een recept kunt weergeven dient u het op te slaan. Wilt u dat nu doen?

  Click the Yes button to save the recipe, or the No button to close the dialog and return to the recipe entry interface.

  If the Show recipe button is pressed, the recipe will display. To return to the Edit Recipe interface in the event that the recipe has not been completely entered, click on the Recipe Name button that appears at the bottom of the component list in the left-hand pane of the window. Alternatively, Edit Edit Recipe can be chosen from the &krecipes; menu, or select the &Ctrl;E key combination.

- Close – click the Close button

  Again, if the recipe has not been saved an alert will appear stating —

  This recipe contains unsaved changes. Would you like to save it before closing?

  The course of action can be selected by clicking the Yes button to save, the No button to close the recipe without saving, or the Cancel button to close the dialog and return to the recipe entry interface.

- Resize – click the Resize recipe button to resize the recipe

  The recipe can be resized by either of two methods —

  1. Scale by yield —

     To scale by yield, select the Radio Button beside the Scale by yield label. Below this and beside the Current yield: label, the current yield of your recipe is shown. Beside the New yield:, there is a text box in which to `enter the new yield amount desired`.

     If you have entered a range for your yield amount, Scale by yield will not be available because &krecipes; cannot determine which portion of the range it is scaling.

  2. Scale by factor —

     To scale by factor, click the Radio Button beside the Scale by factor label. Enter `the desired scaling factor` in the text box beside the Factor (i.e. 1/2 to half; 3 to triple): label.

  In either of these scenarios, click the OK button to continue. Your recipe will be reproportioned appropriately. Alternatively, click the Cancel button to close the window and return to the previous screen.

#### Editing Saved Recipes

The feature for editing recipes can be accessed in a number of ways. With the Find/Edit Recipes component selected,

1. Select the recipe to be edited from the recipe list in the main portion of the &krecipes; window. Click on the Open Recipe(s) button. From the Edit menu, select Edit Recipe, or the &Ctrl;E key combination can be pressed.

2. Select the recipe to be edited from the recipe list in the main portion of the &krecipes; window. Click the Edit Recipe button.

Be sure that you have selected the recipe that you want to edit. If a recipe is not selected, an alert box will appear displaying the message No recipe selected!

Either way, the identical screen that appeared when entering a new recipe displays. For a complete description of this screen, refer to the section Adding a New Recipe.

Alle aspecten van het recept kunnen nu bewerkt worden —

- the Recipe Name, Authors, Categories, Yield Amount, Yield Type, Preparation Time and/or graphic from the Recipe tab

- the Amount, Units, and/or Preparation method for each of the listed ingredients in the Ingredients tab

  Ook in dit tabbladen kan een ingrediënt worden toegevoegd door te klikken op de knop Nieuw ingrediënt die rechtsboven op de lijst met ingrediënten verschijnt of verwijderen door te klikken op de knop

- de bereidingswijze uit het tabblad Instructies

As with entering a new recipe, the buttons Save Recipe, Show Recipe, Close and Resize Recipe are available from each of the tabs

While editing the recipe, if the Show Recipe button is selected, the Unsaved changes - krecipes dialog box appears stating This recipe has changes that will not be displayed unless the recipe is saved. Would you like to save it now?. The Yes, No or Cancel buttons are available for selection.

The important detail to note is that in order to continue editing the recipe, the Edit Recipe interface must be accessed. This can be done in a variety of ways —

- Selecteer Bewerken en dan Recept bewerken uit het menu &krecipes;

- Druk op toetscombinatie &Ctrl;E

- Click on the Recipe Name button that appears at the bottom of the component list in the left-hand pane of the window – this button appears once the recipe to be edited has been loaded and a change has been initiated

With the Find/Edit Recipes component selected and the list of recipes showing on the right-hand side of the screen, an entire recipe may be deleted by selecting it from the list and clicking the Delete button.

### Pagina-instellingen

Om toegang te krijgen tot Pagina-instellingen, selecteer Instellingen en Pagina-instellingen... uit de menubalk van &krecipes;.

Hier is een schermafdruk van de dialoog Pagina-instellingen Schermafdruk

Pagina-instellingen

#### Een overzicht van Pagina-instellingen

In het venster Pagina-instellingen toont de werkbalk de pictogrammen voor Openen, Opslaan, Opslaan als en Teruggaan en een afrolvak Items tonen.

With regard to Revert, a word of caution is in order. Clicking on Revert after changes have been made in the Page Setup window, will reload the currently active layout file, erasing all changes unless they have been saved. This represents the prime function for Revert. Should you wish to revert to your previous settings while still in Page Setup, clicking Revert will allow you to do this provided that you have not saved any changes.

Beneath the toolbar, the label Usage: Select a template along the left, and right-click any element to edit the look of that element. clearly states the Page Setup method of use. All attribute changes are dynamic and do not necessitate reloading while in Page Setup. See the section Changing Attributes for details on changing the appearance of your recipe elements.

When the Page Setup window first appears, you will probably need to resize it in order to view all the recipe elements. When the window is resized, all recipe elements will be scaled fit within the confines of the window.

#### Te tonen items selecteren

Het afrolvak in de werkbalk stelt u in staat om een lijst met items in het recept, die beschikbaar zijn, te tonen. Deze omvatten —

- Auteurs – de auteurs van of bijdragers aan het recept

- Categorieën – de categorie waarin het recept behoort

- Ingrediënten – de lijst met ingrediënten in het recept

- Instructies – de stappen voor de bereiding van het recept

- Foto – om een foto in het recept te tonen

- Eigenschappen – de lijst met voedingselementen in het recept

- Preparation Time – The time for preparation

- Ratings – The ratings given to the recipe

- Title – The title of the recipe

- Yield – The yield amount expected from the recipe

By default, all items are displayed. To prevent display in the recipe, deselect the item by clicking on the check box beside it.

All sections chosen to display in the recipe will also print. It may be desirable to have a section display, but not print. In this case, you can define a new print layout. See the section Print Setup for instructions.

#### Changing Attributes

Characteristics of each section can be changed individually.

Right-click on any section in the Page Setup window. A menu will display with the title of the section appearing at the top. From this menu, you can —

- Change the Background color...

- Change the Text color...

- Change the Font...

- Choose whether or not to display the section by selecting or deselecting the check box beside Show

- Change the Alignment – This menu item has a sub-menu that allows you to select the alignment

- Define a Border... that will appear around the selected section

  When the Requested Border configuration window appears, there are sections that allow the definition of various elements under the appropriate headings. For example —

  - Under the heading Style, a border style can be selected

  - Under the heading Color, a color can be selected from the color spectrum and this can be fine-tuned, using the color slider

  - Under the heading Width the width of the border, in pixels, can be selected. For a border such as Groove, or Ridge a minimum pixel size of 4 to 6 has been found to work best. The border size can be selected using a spinbox or selecting a numeric value from a list

  Finally, at the bottom is a section that allows the preview of the border as it will appear in the recipe.

- Specify the number of Columns... that will be used to display your list items, such as Ingredients and Properties

  When the Columns... menu item is selected, a dialog box will appear where you can set the number of columns for display using a spinbox or typing the number directly into the text box that appears beneath the label Select the number of columns to use:.

### Printerinstellingen

&krecipes; allows you to define different looks for viewing and printing your recipes. For instance, you might be happy with a unified look for viewing your recipes, but want to color co-ordinate all elements when the recipe is printed.

If you are printing a full page recipe, items selected for printing and the attributes of your various recipe elements are set in the same manner as they were in Page Setup. The trick for having a separate definition for printing is to ensure that you have saved your settings with a new file name.

#### Printing Your Recipe

When you select File and Print from the &krecipes; menu bar, the Print Preview screen appears, as depicted in the following screenshot.

Here's a screenshot of the Print Preview screen. Schermafdruk

The Print Preview Screen

From the screenshot, you will see that there are various buttons to tune the preview, if you're happy with the result click the button, otherwise just close the preview window to cancel the print.

### Importing and Exporting Recipes

&krecipes; allows the import of recipes from a file or from a database. Recipes can also be exported to other formats.

#### Importing from a File

&krecipes; allows the import of recipes from the following formats —

- &krecipes; – files of this format will have extensions of .kre or .kreml

- MasterCook – files of this format will have extensions of .mx2 and originate from MasterCook 5 or 6

- MasterCook Export – files of this format will have extensions of .mxp or .txt and originate from MasterCook 4

- Meal-Master – files of this format will have extensions of .mmf or .txt

- Now You're Cooking Generic Export – files of this format will have extensions of .txt

- RecipeML – files of this format will have extensions of .xml or .recipeml

- Rezkonv – files of this format will have extensions of .rk or .txt

To import a recipe from a file of one of the above formats, select File from the &krecipes; menu bar. From the available choices, select Import from File ...

A window will appear that allows the navigation to the file that you wish to import. Navigation can be done using the point and click method, or the location of the file may be entered directly into the box labeled Location:.

The Filter: box is used to select the format of the recipe being imported from the drop-down menu.

To position the cursor for entry into the Location: box, the key combination &Alt;L can be used. To position the cursor for entry into the Filter: box, the key combination &Alt;F can be used.

Once you have navigated to the location of the recipe file that you want to import and have selected the correct format, all the recipes saved in the selected format will appear in the file list. If import of only one recipe is desired, select the file that you wish to import and its name will appear in the Location: box. Press the OK button to proceed with the import, or the Cancel button to close the file selection window and return to the previous screen.

If you have selected the Ask which recipes to import tickbox in the Configure &krecipes;, Import/Export interface, when you click on the OK button, the &krecipes; Import Recipes window will appear from which you can select the recipes that you want to import. For instructions on how to select this choice see the section Choosing Import/Export Preferences. If this selection is not made, your recipes will be imported silently with no prompt.

Here's a screenshot of the Import Recipes screen. Schermafdruk

The Import Recipes Window – this window will appear when you are importing from a file OR from a Database.

Under the heading Recipes, drop-down lists will appear —

All – This list will be expanded by default and is selected by default whether one recipe or multiple recipes are being imported (the tickbox to the left of the label will contain a check mark). In brackets, to the right of the label, the number of recipes being imported will appear.

Below the All label, all the remaining Categories will be listed and the tickbox to the left of each category label will contain a check mark indicating that the category is selected. These categories will be collapsed by default and in brackets to the right of the category label, the number of recipes in the category will be shown.

Each category can be expanded to reveal the list of recipes in the category by clicking on the + sign that appears to the left of the tickbox. Again, by default, recipes within each category are selected as indicated by the checkmark in the tickbox to the left of the category name. Any recipes that do not have a category attached to them will appear under the Uncategorized group. To deselect any recipes that you do not wish to import, simply clear the tickbox beside the recipe name by clicking on it.

Once you are satisfied with the selection(s) you have made, click the OK button to proceed with the import, or the Cancel button to prevent the import and close the window.

It should be noted that the Cancel button can be pressed after the import starts. In this situation, any recipes that have been imported prior to pressing the Cancel button will remain in the database – &krecipes; does not rollback completed imports on cancellation of the import process.

Any recipes that have been placed in the Uncategorized group can be individually edited to place them in the appropriate existing category. You may also define a new category in which to place them. See the section Editing Saved Recipes and The Categories Component for instruction on how to do this. Once you have edited your recipes to categorize them and the Uncategorized group is empty, it will automatically be removed from the category list.

If the recipe(s) are categorized, &krecipes; will put the recipe(s) into the appropriate category or create a new category if the appropriate one does not exist.

Regardless of whether the recipe being imported is uncategorized or categorized, it may still be appropriate to edit the recipe to define Preparation Time, or otherwise fine-tune the recipe.

The manner in which the recipe imports into &krecipes; is DEPENDENT ON THE WAY IT HAS BEEN INPUT INTO THE ORIGINAL PROGRAM! If the recipe has been input into the original program in a sloppy manner, it will not import neatly into &krecipes;!

#### Importing from a Database

To import a recipe from an existing database, select File from the &krecipes; menu bar. From the available choices, select Import from Database ... The Database Import window will appear. Under the heading Database, you can make one of three selections. Your selection can be made by clicking the radio button beside SQLite, MySQL, or PostgreSQL.

##### Importing from SQLite

Here's a screenshot of the import dialog when importing from an SQLite database. Schermafdruk

Importing from an SQLite Database

If you choose SQLite, beneath the heading Database file:, there is a text box and beside this, the Open File Dialog icon which, when clicked, will open the file dialog window. This window is used to navigate to the location of the database that you want to import. Once you have located the appropriate database file, select it from the file list. The name will appear in the Location: box. Click the OK button to proceed or the Cancel button to close the file dialog window and return to the previous screen.

Once the OK button is pressed, the file dialog window will close. You will be returned to the Database Import window and you should see the name of the database file with its path showing in the text box. Click the OK button to proceed with the import, or the Cancel button to discontinue the import.

At this point, the import becomes common for whatever database you are importing.

##### Importing from MySQL

Here's a screenshot of the import dialog when importing from a MySQL database. Schermafdruk

Importing from a MySQL Database (The same interface would appear if the PostgreSQL radio button was selected.)

If the MySQL radio button is selected in the Database Import window, you will be required to enter the following parameters in the text box beside the appropriate label —

- Server:

- Gebruikersnaam:

- Wachtwoord:

- Poort:

- Databasenaam:

Once this information has been supplied, click the OK button to proceed with the import steps that are common to all. At this point, you may also click the Cancel button to cancel the import and return to the previous screen.

##### Importing from PostgreSQL

If the PostgreSQL radio button is selected in the Database Import window, you will be required to enter the following parameters in the text box beside the appropriate label —

- Server:

- Gebruikersnaam:

- Wachtwoord:

- Poort:

- Databasenaam:

Once this information has been supplied, click the OK button to proceed with the import steps that are common to all. At this point, you may also click the Cancel button to cancel the import and return to the previous screen.

For both MySQL and PostgreSQL, it will be fine to leave the Port: as Default, in most cases. However, if you know that you connect to your database via a specific port number, especially in the situation where you might be connecting remotely, it can be set by either entering the port number in the text box beside the Port: label, or using the spinbox beside the text box to increment the port to the desired number.

##### Steps Common to All Database Imports

Similar to importing recipes from a file, if you have selected the Ask which recipes to import tickbox in the Configure &krecipes;, Import/Export interface, when you click on the OK button, the &krecipes; Import Recipes window will appear from which you can select the recipes that you want to import. For instructions on how to select this choice see the section Choosing Import/Export Preferences. If this selection is not made, your recipes will be imported silently with no prompt.

Again the All label will show and beneath this, the list of all categories being imported. Also like importing from a file, the list items will have tick boxes on the left from which whole categories and/or recipes can be deselected by clicking on the box to remove the check mark. The total number of recipes will show to the right of the All list item and the number of recipes in each category will display to the right of the category item.

Click the OK button to proceed with importing the database, or the Cancel button to stop the import. If you choose to proceed, the categories and recipes that are in the database file being imported will appear in your &krecipes; recipe list.

#### Exporting Recipes to Other Formats

&krecipes; can export your recipes to the following formats —

- Compressed &krecipes; format – files of this format will have extensions of .kre

  This export format will result in a smaller filesize and as a result disk space is saved. The smaller filesize also makes sending over the Internet easier. This format also provides a mean of backup in addition to the backup functionality in &krecipes;. See the section Backing up Your &krecipes; Database for further information.

- &krecipes; – files of this format will have extensions of .kreml

  Using this format exports your recipe in a readable format that makes it easier to edit the recipe &XML;.

  When exporting in either &krecipes; and &krecipes; Compressed format, all information is guaranteed to be preserved. Other formats may support only certain information. If your recipes contain, for example, borders around certain elements, and this is not supported by the export format that you have specified, that information is lost without any warning.

- Plain Text – files of this format will have extensions of .txt

  Using this format exports your recipe information without the photo into plain text format. The idea here is not to be able to import back into &krecipes;, nor import into any other recipe format. The purpose is to be a handy tool for such tasks as email.

- Web Book – files of this format will have extensions of .html

  This option allows you to export multiple recipes, for instance, a category. The cool part about exporting as a Web Book is that you will be allowed to navigate to specific recipes via links that appear under the category name at the top of the page.

  You might want to use this feature to export recipes from a single category. However, you can randomly select recipes from multiple categories to be exported in this format. To do this, select the first recipe by clicking on it and then, hold the &Ctrl; key and select the next and subsequent recipes. If recipes are selected randomly, the export will create a page named index.html in the location that you specify. This file will have links to the various categories of recipes that you have exported.

  For instance, suppose you have selected to export random recipes from Appetizers, Main Dishes, and Desserts. The index.html file would show links for Appetizers, Main Dishes, and Desserts. Clicking any one of those links will open the page for that category and you will then be able to navigate through the recipes within the category by clicking on the recipe name link that appears under the category name at the top of the page.

  Once exported in Web Book format, you are unable to import these recipes back into &krecipes;.

- Web page – files of this format will have extensions of .html

  You might choose to export in this format in order to create a web page that contains your recipes. Similar to exporting as a Web Book, you can export recipes from a single category, entire categories or randomly selected recipes from any number of categories. The difference is that all recipes exported in Web page format will appear on a single web page with no navigational ability other than scrolling through the page using the scrollbar.

  While exporting in Web page format has its purpose, you will obviously note the benefits of exporting as a Web Book if you are exporting many recipes.

  However, it should be noted that once exported in Web page format, you are unable to import these recipes back into &krecipes;.

  Exporting recipes in either Web page or Web Book format will retain all visual settings – i.e. those set in Page Setup, including the graphic.

- Meal-Master – files of this format will have extensions of .mmf and you might want to export in this format to be able to import into the Meal-Master program to share will other Meal-Master users

  This is the most widely-used recipe format. However, you should note that if your choose to export in this format, certain &krecipes; recipe information will be lost.

- RecipeML – files of this format will have extensions of .xml

  This is a standard recipe &XML; format, although not yet widely used by most recipe software. However, you may wish to use this format to have recipes recognized by programs that use it.

- Rezkonv – files of this format will have extensions of .rk

  This is the format for Rezkonv Suite, a popular German recipe program. When recipes are exported in this format, the human-readable and section names (Title, Yield, etc.) will be in German.

To export a single recipe to one of the above formats, first select the recipe that you wish to export. Then, select File from the &krecipes; menu bar. From the available choices, select Export ...

A window will appear that allows you to navigate to location where you wish to save your exported recipe. The location will default to your home folder, but another existing folder can be chosen, or you can create a new folder. The name of the recipe will appear in the box labeled Location: and this will default to the name that was given to the recipe in the &krecipes; database. However, this name can be changed to another at your discretion.

The Filter: box is used to select the format that you wish to use for the exported recipe from the drop-down menu.

You will also note that at the bottom of this window, there is a tickbox that allows you to select or deselect to Automatically select filename extension. The extension of the chosen export format will appear beside the phrase. If you choose to keep the tickbox selected, this extension will automatically be attached to the filename of your exported recipe.

To position the cursor for entry into the Location: box, the key combination &Alt;L can be used. To position the cursor for entry into the Filter: box, the key combination &Alt;F can be used.

Once the name of the exported recipe appears in the Location: box and you have chosen the format you wish to use for your exported recipe, click the Save button to proceed with the export, or the Cancel button to halt the export process and return to the previous screen.

When the Save button is clicked, the recipe will save in the chosen format and you will be able to open it with the program that accepts that file format – for example, if you have chosen to export your recipe in Meal-Master format, you will be able to open it in any program that accepts .mmf format files. You will also notice that the export process has created a folder in which the graphics related to your exported recipe are stored.

You may also export categories of recipes or your whole database in this same manner. However, if you want to export your entire database, you must ensure that no recipe or category is selected in your recipe list.

Whether you are exporting a single recipe, a category of recipes or your entire database, if no recipe or category of recipes is selected, an alert box will appear containing the message No recipes are currently selected. Would you like to export all recipes in the current view? Click the Yes button (or use the &Alt;Y) to proceed with the export of all recipes. You can also cancel the process in order to select recipes for export by clicking the No button (or use the &Alt;N key combination).

If you recall, when &krecipes; starts, by default the Find/Edit Recipes component is active and if you have recipes and categories, they appear in the right pane of the window. At this point nothing is selected, so you could choose to export your entire database. However, if there is something selected and you want to export, simply click on the white area of the category/recipe list. The highlight will disappear from the choice and you can now proceed to export your entire database.

### Backing Up and Restoring Your &krecipes; Database

With &krecipes; it is an easy task to Backup and Restore your database. The Backup tool is extremely important so that you never lose your recipe database in the event of a hard drive failure. It is wise to ensure that you have a backup copy of your database in a location other than your hard drive. The Backup functionality is also useful when you simply want to revert to a previous version of your recipe database.

#### Backing Up Your &krecipes; Database

To backup your &krecipes; database file, select File and Backup... from the &krecipes; menu bar. However, you might want to consider creating a keyboard shortcut (see the section Creating Shortcuts for more information), or adding an icon to your toolbar (see the section Customizing the Toolbar for instruction on how to do this), since this is an invaluable tool and you will find yourself utilizing it often.

Once you have selected the menu item, shortcut or icon to backup your database, the Save Backup As... -&krecipes; window will appear where you can navigate to the location where you want to store your backup file and provide a name for it. By default, this interface opens to your home folder. You can navigate to another location and then, type the name that you wish to utilize for your backup in the text box beside the label Location:. To position the cursor in the Location: text box, either click in the box or use the keyboard shortcut &Alt;L. If you have previously backed up your database, you can also select it from the drop-down menu beside the Location: text box.

The Filter: text box shows the type of file that you are creating. In the situation where you are backing up your &krecipes; database file, there is only one type of file available – a &krecipes; Backup File (*.krecbk), and that shows as the default selection.

The final item in this window is a tick box beside the label Automatically select filename extension (.krecbk). With this option active, i.e. there is an x in the tick box, you can provide a filename, but do not have to supply an extension. The extension .krecbk will be attached to your filename automatically. However, you do not have to use the extension .krecdb. Simply clear the tick box and then, when you supply the filename for your backup, include the extension that you choose. For example, you might choose to name your database backup file myrecipes.krback.

When you have chosen the name for your backup and the location where you want to store it, click the Save button to complete the backup process, or the Cancel button to close the interface and return to the main &krecipes; window.

#### Restoring Your &krecipes; Database

To restore your &krecipes; database file, select File and Restore... from the &krecipes; menu bar. As previously mentioned, you might want to consider creating a keyboard shortcut (see the section Creating Shortcuts for more information), or adding an icon to your toolbar (see the section Customizing the Toolbar for instruction on how to do this).

Once you have selected the menu item, shortcut or icon to restore your database, the Restore Backup – &krecipes; window will appear where you can navigate to the location where you saved your backup. Once you have located the file and selected it, its name will appear in the text box beside the label Location:.

By default, the Restore Backup – &krecipes; window opens to your home folder. An alternative to navigating to the location of your backup file and selecting it would be to type its name, including the path, directly into the Location: text box. To position the cursor in the Location: text box, either click in the box or use the keyboard shortcut &Alt;L. If you have previously backed up your database, you can also select it from the drop-down menu beside the Location: text box.

As with the backup function, the text box beside the Filter: label shows the type of file as &krecipes; Backup File (*.krecbk).

Once you have selected your backup file, click the Open button to initiate the restore or the Cancel button to close the window and return to the main &krecipes; interface.

If you chose to proceed with the restore, the Warning – &krecipes; window will appear, as shown in the following screenshot:

Here's a screenshot of the warning that appears when restoring the &krecipes; database. Schermafdruk

Restoring Your Database – Erase Warning

You can select the tick box beside the label Do not ask again to prevent this message from showing in the future. However, if you choose to do this, your backup file will be restored silently and you will not be able to change your mind.

If you choose to continue to show the warning, click the Continue button to proceed with restoring your database file, or the Cancel button to stop the restore process and return to the main &krecipes; screen.

If you choose to continue with the restore, a progress dialog window will appear. The number of recipes in your database determines the length of time that this window will show. Finally, a dialog box will appear containing the message Restore Successful. Click the OK button to clear the window. Your restore is now complete!

### Other &krecipes; Components

#### The Shopping List

The Shopping List component appears when the Shopping List button is clicked in the left pane of the &krecipes; window.

Here's a screenshot of the &krecipes; Shopping List component. Schermafdruk

The Shopping List Component

When selected, the component title appears at the top in the right pane of the window.

Below this is a text box to `enter the specific name of a recipe` to search for. Recipes can also be chosen by selecting them from the list. Either way, the selected recipe must by transferred to the right-hand side of the screen under the heading Shopping List by clicking on the button between the two portions of the screen.

Once the desired recipes have been transferred to the shopping list side of the screen, click the OK button.

- Recipe names can also be transferred out of the shopping list side of the screen by clicking on the button.

- The entire list of recipes that has been selected for producing the shopping list can be cleared by clicking the Clear button.

When the OK button is clicked, a window will appear that lists all ingredients contained in the &krecipes; database on the left and the ingredients required for the selected recipe(s) on the right. Above each of these is a Search: text box to `enter the name of an ingredient` to search for within each of the lists.

Ingredients can be transferred to and from either side by clicking on the or button that appears between the lists, as needed.

In the recipe ingredient list on the right, the Amount and the Unit of each ingredient can be edited by double-clicking on the appropriate value. For example, if the recipe requires 4 eggs and a purchase of eggs is required to make the recipe, it is unlikely that you would buy 4 eggs. In this case, the eggs ingredient could be selected, the Amount changed to 1 and the Unit changed to doz. or dozen.

When all desired changes have been made to the ingredients for the recipe(s) selected, click the Done button and the Shopping List will display.

From the Shopping List window, click the Print button to print the shopping list, or click the Close button to close the window.

#### The Diet Helper

The purpose of the Diet Helper component is to help plan menus for days, or weeks, at a time. Because of the ability to select nutrient values in this component, you are also able to plan your meals to adhere to nutrient limits. This makes either restricting or enhancing your diet much easier and more efficient.

Here's a screenshot of the &krecipes; Diet Helper component. Schermafdruk

The Diet Helper Component

The Diet Helper component is accessed by clicking on the Diet Helper button in the left pane of the &krecipes; window. As with other &krecipes; components, the user interface appears in the right pane under the heading Diet Helper.

To start setting up your menus, the first thing your have to do is select the number of days that you are planning for and the number of meals per day.

In the rectangular area under the heading Number of Days, the number of days is set at - 1 -. To increase this value, click and hold the &LMB; and move the slider to the right. The value will increment up to - 6 - and then, change to - 1 week -. After the number of days changes to - 1 week -, increases are in increments of 1 week to a maximum of 4 weeks.

Similarly, in the rectangular area under the heading Meals per Day, the number of meals displays as - 1 -. This value is incremented by clicking and holding the &LMB; and moving the slider to the right until the desired number of meals is displayed, up to a maximum of 10. When the slider is adjusted, a tab will appear for each of the meals.

The next step is to specify the number of dishes per meal. This is done by using the spinbox beside the No. of dishes: label to adjust the number.

Beside the No. of dishes: are the Previous Dish and Next Dish buttons that are used to navigate back and forth between dishes as you specify the type of recipe for each. As you utilize these buttons to move back and forth between dishes, you will note that in the Dish Characteristics area of the screen, the dish label changes as follows —

- Eerste gang

- Tweede gang

- Nagerecht

And for subsequent meals —

- Dish 4, Dish 5, etc.

##### Planning Menus

In the Dish Characteristics area of the screen and beside the dish label, there is a tick box to Enable Category Filtering. Clicking this box enables the feature. It is important that you choose to do this because you may otherwise end up having Cheesecake, or some other unreasonable dish for breakfast!

With category filtering turned on, you can select the category to be used for the dish as specified by the dish label located beside the category selection box. For instance, the dish label might show 1st Course. If you are selecting courses for your dinner meal, you might then select the category Salads from the category list. A scrollbar exists to the right that allows moving up and down within the list.

Continuing with the example of selecting dishes for your dinner meal, you would then click the Next Dish button. When you do this, you will note that the dish label changes to 2nd Course and that again, you must turn category filtering on. Now, you can proceed with the selection of the category for your next dish, for example, Pasta.

Continue selecting the types of dishes for your meals in this same manner. When you have completed selecting the types of dishes, at this point, you can click the Create the diet button.

At this point, you are planning a menu only and not taking any dietary and nutrient constraints into consideration. To plan menus and consider nutrient consumption, see the section Planning Diet-Conscious Menus.

When you click the Create the diet button, the Diet window appears which displays your menus for the number of days that you have selected. In this window, you can click the Create Shopping List button to create the shopping list for your menus. You can also choose to print the menu by clicking the Print button. Clicking the Cancel button closes the Diet window and returns you to the previous screen.

##### Planning Diet-Conscious Menus

All the steps listed in the section Planning Menus also apply here. This section will discuss the incorporation of nutrient values into your menus.

Before you can include nutrients in your menu plan, you must ensure the following —

1. Nutrients or properties must be loaded for the ingredients. See the section Properties in Ingredients for further instructions. If an ingredient does not contain nutrient values, it will be ignored.

2. Units of measure must be associated with the ingredients. Since most nutrients are measured in g/g or mg/g, ensure that g is one of the units associated with each ingredient. See the section Units in Ingredients for additional information.

3. The equivalencies between the units of measure must be completed in the Units component within the Mass Conversions and Volume Conversions tabs. See the section Completing Your Conversion Tables for instructions.

Once you have ensured that all necessary details have been provided for your ingredients, you are ready to consider nutrients in your menu plan. Of course, attending to these details should be done prior to the start of creating your menu/diet, since the consideration of nutrient values is a continuation of planning a basic menu.

In the portion of the screen that lists the nutrients, under the heading Enabled, select the nutrient that you want to consider by clicking on the tick box that appears to the left of the nutrient name. Note that you do not have to select every ingredient, only those that you wish to take into consideration. A scrollbar exists to the right that allows moving up and down within the list.

To the right of the nutrient name, columns labeled Min. Value and Max. Value exist. These are used to set the minimum and maximum values of nutrients so that when the search for appropriate recipes is done, only recipes that have a particular nutrient falling into the specified range will be considered for your menu/diet.

To set the ranges for a nutrient that you want to take into consideration, select it (it will be highlighted). Under the headings for Min. Value and Max. Value, the 0 that was under each heading prior to selecting the nutrient will change to 0.00. A spinbox will show beside each of these values that you can utilize to set the value that you want. Alternatively, you can click on the value, position the cursor to where you want to type using the directional arrows and type a value, or you can double-click on the value to highlight it and type over the entire value that exists. These steps must be completed in each course category for each nutrient that you want to consider.

It should be noted that you may omit providing a minimum value for a nutrient, in which case the minimum value would remain as 0. However, if you provide a minimum value, you must provide a maximum because, obviously, a maximum cannot be less than a minimum.

At any point in the process of planning a menu/diet, you can click the Clear button to clear all entries and begin again.

Once you have completed entering all the nutrient information, click the Create the diet button to create your menu/diet.

When you click the Create the diet button, the Diet window appears which displays your menus for the number of days that you have selected. In this window, you can click the Create Shopping List button to create the shopping list for your menus. You can also choose to print the menu by clicking the Print button. Clicking the Cancel button closes the Diet window and returns you to the previous screen.

#### The Ingredient Matcher

The purpose of the Ingredient Matcher component is to find recipes that you are able to make (or almost make) with ingredients that you have on hand. To access the Ingredient Matcher component, click on the Ingredient Matcher button that is visible in the left frame of the &krecipes; window.

Once the component starts, typical of all &krecipes; components, the name will appear at the top of the window in the right frame. Beneath this, beside the Search: label, there is a text box to `enter the recipe ingredient` that you want to search for.

Here's a screenshot of the &krecipes; Ingredient Matcher component. Schermafdruk

The Ingredient Matcher Component

Below the Search: box, under the heading Ingredient there is a list of all the ingredients that are in the &krecipes; database, both ones provided by default and those that you have entered by either adding them in the Ingredients component or by entering them in a recipe, which automatically adds the ingredient to the database. Elsewhere in this document, further information is provided on the use of the Ingredients Component.

The first step to finding a recipe for which you have the ingredients on hand is to search for one or more ingredients. This can be done by entering an ingredient name in the Search: box above the ingredient list or, by just scrolling through the list using the scrollbar that is on the right of it and selecting ingredients.

It is likely that the ingredients that you want to select will not be adjacent to each other, but this is not a problem. Simply click on the first ingredient that you want to use and then, hold down the &Ctrl; key and click on the next ingredient. This will work even if you are using the Search: box to look for ingredients. Just remember that after finding and selecting the first ingredient and then, using the search box to locate the next (and any subsequent) ingredient, you must hold down the &Ctrl; key before clicking on the ingredient name. &krecipes; dictates that at least one of the selected ingredients be in each of the recipes listed in the search results.

The next step, is to transfer the selected ingredients to the list box that appears to the right of your ingredient list. This is done by clicking on the that appears between the two lists. Ingredients can be transferred one at a time, or in multiples as previously described. Your ingredients will be listed under the heading Ingredient (required?). If you would like to search for recipes that contain a specific ingredient, you can select the check box beside the ingredient name to indicate that it is a required ingredient for any recipes returned in your search. Conversely, ingredients can be transferred out of the right-hand list box by clicking on the button.

Once you have transferred the ingredients to the listbox on the right, you can enter an Amount Available in the column beneath this heading. This is done by double-clicking on the space beside the ingredient for which you want to enter an available amount. The Enter amount - &krecipes; dialog box will appear in which you can `enter an amount` in the text box below the Amount label. Next, you can select the unit of measure for the ingredient from the drop-down menu that appears beside the Amount text box. Click the OK button to accept the amount entered, or the Cancel button to close the dialog box. Of course, you don't have to enter an amount if you know that you have enough of the ingredient for any recipe that might be returned in your search.

If your right-hand ingredient list is fairly lengthy and you are looking for an ingredient for which you might want to enter an Amount Available, a Search: box appears above this list as well. When you enter a search term in this box, it will search only the ingredients that are in the right-hand list box.

Before the recipes containing the selected ingredients will display, you must select the number of missing ingredients permitted in your recipes. This is accomplished by using the spinbox beside the label Missing ingredients allowed:. There will always be certain ingredients that you have on hand, for example, salt or sugar. One of the purposes of allowing missing ingredients is to compensate for those ingredients that are normally in your cupboard. It is for this reason that you might want to set the Missing ingredients allowed: to a reasonably high number. Or, if the number of missing ingredients shows as 0, you can click on the text box beside the Missing ingredients allowed: label to activate it and then, press the ↓ directional arrow which will cause Any to appear in the text box, indicating that any number of missing ingredients are permitted.

Setting the missing ingredients too high will result in a longer list of recipes. Setting the missing ingredients too low will result in either no recipes being found, or cause the search to exclude recipes that you might also be able to make had you allowed for slightly more missing ingredients.

Click the Find matching recipes button to display the search results in the area beneath the phrase Possible recipes with the specified ingredients. The recipe title will appear under the heading Title. The recipe id will appear under the heading Id and the missing ingredients will display under the heading Missing ingredients. The width of the columns that apply to each of these headings can be adjusted for viewing purposes. When your recipes are listed, they are grouped according to the number of missing ingredients and for each group, prior to listing the recipes, the number of missing ingredients is specified.

If your search does not provide recipes that are of interest, you can adjust the number of missing ingredients and click the Find matching recipes button to display new results based on the ingredients selected. Alternatively, you can press the Clear recipe list button to clear the recipe list to perform a whole new search with different ingredients.

&krecipes; makes it easy for you to find a recipe that you can make with ingredients on hand. However, if you do have to run to the store, once you decide on the recipe that you want to make, you can use the The Shopping List to make your shopping list.

#### The Data Button

The Data button performs one simple function – when clicked, it gives access to additional components.

When the additional components are revealed, click the Up button to return to the previous list.

#### The Ingredients Component

The Ingredients component is accessed by first, clicking on the Data button to reveal the additional &krecipes; components, and then, clicking on the Ingredients button.

When the Ingredients component opens, the component title will be seen at the top. Below the heading Ingredient list, there is a list of ingredients contained in the &krecipes; database is shown. This list includes ingredients that have be provided as defaults in the program and also, ingredients that you have added.

Beside the heading is a text box to `enter an ingredient` to search for in the ingredient list.

To the right of this component is a button, for adding ingredients to the list, and a button, for removing ingredients. See the section on Working with Ingredients for more details.

Below the list there is a button labeled Property Information to edit the property information for the selected ingredient.

Here's a screenshot of the &krecipes; Ingredients component. Schermafdruk

The Ingredients Component

##### Editing the ingredient properties

If you select an ingredient from the list and you click the Property Information a new dialog to edit the properties of the selected ingredient will be shown. A label with the text Property information for ... will be displayed on top, below this text there are 3 lists:

1. USDA ingredient list: Below the Property information for... label, the list of ingredients in the USDA database is shown. Beside the Search: label there is a text box to search in the USDA Database. Below to the list there is a Load button to load the data for the given ingredient from the USDA database to your personal database.

2. Ingredient properties list: This list contains the nutrient values of each ingredient.

   In this list, the name of the nutrient is shown under the heading Property, the amount of the nutrient present in the ingredient is shown under the heading Amount and the measurement value for the nutrient is shown under the heading Units. For example, if the ingredient orange juice has been selected, one of the nutrients displayed will be Vitamin C. Under the Units heading, mg/g will display, which means that there are the number of milligrams shown under the amount (in this case, 0.5) per gram of the ingredient.

   Above this list there is an Add button, for adding ingredient properties to the list, and a Remove, button for removing properties, see the section on Properties in Ingredients for more details.

3. Ingredient weights lists: Below the Load button and beside the ingredient properties list is the ingredient weights list. This list, in combination with your unit conversions, is what helps provide accurate nutrient information for your recipes. See the section, Completing Your Conversion Tables for help with doing your unit conversions.

   In this list, under the heading Weight, the weight of the ingredient is shown. Under the heading Per Amount, the unit to which the weight applies is shown. Using the orange juice example, the ingredient weight table shows that the weight of orange juice is 248 grams per cup of orange juice, or 31 grams per fluid ounce of orange juice.

   As with the ingredient properties list, above the ingredient weights list, an Add button is available for adding ingredient weights and a Remove button is available for removing ingredient weights. See the section Working with Ingredient Weights for more information.

For those ingredients provided by default in the program, the USDA data has been loaded and this is what provides the nutrient values (or Properties) for each ingredient. The associated weights have also been loaded. However, if you have added an ingredient to the list, in order to display the nutrient value and the weight information for the ingredient, the USDA data must be loaded by clicking on the Load button that appears below the USDA ingredient list.

Here's a screenshot of the dialog to edit the ingredient properties. Schermafdruk

The dialog to edit the ingredient properties.

##### Ingredient Headers

When the Ingredients component is accessed, you will also notice a Headers tab. If this tab is accessed, the headers that apply to your recipes may be added, removed or renamed.

Similar to other &krecipes; components, there is a text box beside a Search: label where you can enter the name of the header for which you want to search, should your list be long enough that this would be the best method to access a particular header.

On the right side of the Headers window, there is a button, which when clicked, will bring up a dialog box which will permit the entry of a new header. To add the header, simply type in the name that you desire in the text box that appears beneath the Header label. Click the OK button to proceed with the addition or, the Cancel button to clear the dialog box and return to the main header interface.

To remove a header, select it in the header list and click the button. If this header is utilized in any of your recipes, a dialog box will appear stating Warning: The following will have to be removed also, since currently they use the element you have chosen to be removed.. To remove the header, click the OK button. The header will be removed from the list. Note, however, that in your recipe(s) that contain the particular header that you have chosen to remove, only the header will be absent. The ingredients that were part of the removed header will still be intact. To cancel the removal of the header, click the Cancel button. The dialog box will disappear and you will be returned to your header list. Of course, if the header does not exist in any of your recipes, it will be removed with no prompt.

To rename a header, simply select the header that you want to edit. With the header selected, right clicking will result in the appearance of a menu from which you can select Rename. A box will outline the selected header and a cursor will appear at the beginning of the header name. Using the arrow keys, position the cursor at the point where you wish to make your edit, or if you wish to completely rename the header, simply type the new name. Pressing the &Enter; key will complete the renaming process.

When a header is selected and the menu is access by right-clicking, in addition to a menu item for Rename, there are menu items for Create and Delete. This alternative method can be used to add and remove headers and will react in the same manner as outlined above. Additionally, each of the menu items has a key or key combination that can be used to carry out the desired action while in the Headers tab. These are: —

- &Ctrl;&Alt;N to create a header

- Del to delete a header

- &Ctrl;R to rename a header

##### Working with Ingredients

Ingredients may be added, removed or edited in the &krecipes; Ingredients component.

###### Voegt toe:

To add an ingredient to the list, click on the button that appears beside the ingredient list. A window will be presented where `the name of the new ingredient` can be typed in the text box beneath the heading New Ingredient. Once the name has been added, click the OK button to complete the addition and close the window. The ingredient will now appear in the ingredient list. If you do not wish to add the ingredient to the list, click the Cancel button to close the window and return to the previous screen.

###### Verwijderen:

To remove an ingredient from the list, click on the button that appears beside the ingredient list. The ingredient will be removed provided there are no recipes using that ingredient.

If recipes exist that use the ingredient, a window will display with the prompt The following elements will have to be removed also, since currently they use the element you have chosen to be removed. Below the prompt, under the heading Recipes, a list of recipes that use that ingredient will display. Click the OK button to proceed with the removal of the ingredient AND recipe(s), or the Cancel to close the window and return to the previous screen.

###### Bewerken:

An ingredient may be edited by selecting the ingredient in the list and double-clicking on it. The ingredient will remain highlighted, but if either the ↑ or ↓ directional arrows is pressed, the cursor can be positioned to the point you wish to edit. If you wish to rename the entire ingredient, for example from butter to BUTTER, simply push &Ctrl;R with the ingredient highlighted.

If you choose to rename an ingredient and another ingredient exists with the name chosen, an alert box will appear with the prompt This ingredient already exists. Continuing will merge these two ingredients into one. Are you sure? Click the Continue button to proceed with renaming the ingredient, or the Cancel button to abort.

If you have two ingredients, one named cinnamon and the other named Cinnamon and you would like all recipes to show the ingredient as Cinnamon, first check which of the ingredients lists the properties – i.e. the nutrient values. If the nutrient values show for the ingredient cinnamon, renaming cinnamon to Cinnamon will result in a loss of the properties for that ingredient and they will have to be reloaded.

However, if you rename Cinnamon to cinnamon and then after the two ingredients have been merged, the single ingredient cinnamon to Cinnamon, your nutrient values will be retained.

###### Alternatively:

An alternative method to either add, remove, or edit an ingredient is to first, select the ingredient and then, right-click to display a menu from which you can select Create, Delete, or Rename. Each choice performs as explained in the previous sections.

For quick functionality, the &Ctrl;C key combination can be used to Create a new ingredient. To Delete an ingredient, press the Del key on the keyboard – a prompt will be received if the ingredient is used by a recipe. The key combination &Ctrl;R can be used to Rename an ingredient.

##### Units in Ingredients

This section describes how to work with the units of measure, or Units, that apply to specific ingredients in the &krecipes; Ingredients component. For details on working with ingredients globally, see the section The Units Component.

Within the Ingredients component, select an ingredient. In the Unit list portion of the screen, the units of measure that are associated with that ingredient will display.

Units can be added by clicking on the + button that appears to the right of the Unit list.

For example, one of the pre-loaded ingredients in the ingredients list is apple juice. By default, the units associated with this ingredient are gram and milligram. If apple juice is a required ingredient in a recipe, it is more likely that it will be measured by cup, or portion thereof. Therefore, it may be desired that cup be added to the Unit list. To do this, click on the + button that is beside the Unit list. The Choose Unit window will appear, from which you can select cup, for example, from the list. Then, click the OK button to add the unit, or the Cancel button to close the window and return to the previous screen.

Units can be removed by clicking on the - button that appears to the right of the Unit list. In a manner similar to that described in the Working with Ingredients section under the heading Removing:, if an attempt is made to remove a unit that is associated with an ingredient used by a recipe in the database, a prompt will be displayed that permits confirmation of removal of the unit AND the recipe that is associated with the ingredient unit, or that will allow the cancellation of the action.

##### Properties in Ingredients

As previously stated, for those ingredients that are provided by default in the &krecipes; program, the Properties or nutrient values have been pre-loaded with the USDA values.

However, if a property has been added in the Properties component, a second step must be completed in the Ingredients component to add the Property and its associated value to the list.

###### Adding Ingredient Properties

The first step to adding a new property for an ingredient is to ensure that the appropriate unit is listed in the Unit list in the top right-hand corner of the Ingredients component. If the unit is not listed – i.e. the unit specified when the property was added, for instance gram, it must be added in the manner described in the section Units in Ingredients.

Assuming that the appropriate unit is listed in the Unit list, to add the new property to the Ingredient Properties list, select an ingredient in the Ingredient list then, click the + button that appears to the right of the properties list.

The Choose Property box will appear, from which you can select the property to be added for the ingredient. A drop-down menu shows below the property list, from which the unit associated with the property must be selected. Click the OK button to proceed, or the Cancel button to cancel the addition of the property and close the window.

If you choose to proceed with the addition, the property will be added to the Ingredient Properties list. However, you will note that it has a 0 value. This value must by supplied by you. To add the value, click on the property and increment the value using the spin-box that appears, or manually type the value. Once the value is entered, click the OK button that appears beside the spin-box.

If the USDA data does not show for the ingredient for which the new property has been added, it can be loaded either before adding the new property or after. If the USDA data is added after adding the new property, the new property will still show in the list.

The new property must be added to EACH ingredient separately.

###### Removing Ingredient Properties

To remove a property from the Ingredient Properties list, simply select the property to be removed and click the - that appears to the right of the list. The property will be removed without a prompt. However, this will remove the property within the Ingredients component ONLY. The property will be retained in the list in the Properties component.

##### Working with Ingredient Weights

As with the Ingredient Properties, for those ingredients that were provided by default with the &krecipes; program, the Ingredient Weights will have been loaded. However, if the ingredient weights have not been loaded or, you wish to add an additional weight to one of your ingredients, you can do so.

###### Adding Weights to your Ingredients

To add a weight for your ingredient, you must first select it. Then, click the + button that appears beside the Ingredient Weight list. A dialog box will appear in which you can enter the parameters for the New Ingredient Weight.

First, in the text box beside the label Weight:, you can enter the weight that you want for the ingredient. Remember the table for apples in the Looking After Nutrients section? By utilizing this table, it was calculated that 1 medium apple weighed 151.3 grams. Following through with this example, 151.3 is the value that would be entered in the Weight: text box.

Next, the weight measure must be selected from the drop-down menu. So, using the apple example, we would select gram from this list. Since properties, or nutrient values, are usually specified as a per gram value, it is a good idea to set your weight measure to grams.

In the text box beside the Per Amount: label, you would enter whatever amount the weight applies to. In the apple example, we would enter 1. Then, from the drop-down menu beside this text box, the unit of measure would be selected, in this case medium.

To quickly find the unit of measure, or any value from a drop-down list, press the key on the keyboard that corresponds to the first letter of the item being selected. For medium, press the M key as many times as required until medium is selected. Repeated pressing of the M key will cycle through all choices that begin with the letter m.

Finally, from the drop-down menu that by default shows -No Preparation-, any preparation method associated with the ingredient would be selected. In our example, there is no preparation method, since we are dealing with whole apples.

Now, click the OK button to complete the entry of your ingredient weight, or the Cancel button to abort the addition and close the dialog box.

###### Removing Ingredient Weights

Conceivably, there should be no reason why you would want to remove an ingredient weight. If any change is necessary, all parts of the weight can be edited. See the section Editing Ingredient Weights for assistance with this function.

However, if you do wish to remove a weight, it is possible to do it. With the appropriate ingredient selected, click on the weight that you wish to remove. Then, click the - button that appears to the right of your Ingredient Weights list. An alert will appear stating Recipes may require this information for nutrient analysis. Are you sure you want to delete this entry? Click the Continue button to continue with the deletion of the ingredient weight, or the Cancel button to discontinue the deletion and close the alert window.

You will also notice a tick box beside the label Do not ask again.

If you click on the tickbox, this will prevent the alert from appearing when you attempt to remove an ingredient weight. The ingredient weight will be removed silently and as stated in the alert, this may affect nutrient analysis of your recipe(s). Note the status indicator (the LED) on your recipes. If it has changed in any of them, it could be due to the removal of an ingredient weight.

###### Editing Ingredient Weights

Any portion of the ingredient weight that is listed in the Ingredient Weights list can be edited by double-clicking the part that you want to edit as follows: —

- If you double-click the portion under the Weight heading, a dialog box will appear. Under the heading Weight, the existing weight will show in the text box, but you can delete this and enter a new value. Beside the Weight text box, the drop-down menu for the weight measure displays the current setting. However, this can be changed by selecting another from the menu. Finally, click the OK button to complete the change, or the Cancel button to close the dialog box without changing.

- If you double-click the portion under the Per Amount heading, again, a dialog box will appear. Under the heading Amount, the existing amount will show in the text box, but you can delete this and enter a new value. Beside the Amount text box, the drop-down menu for selecting the unit that the amount applies to displays the current setting. However, this can be changed by selecting another from the menu. Next to the drop-down menu for specifying the unit, another drop-down menu displays from which you can select a preparation method. Again, this will display the current setting, if a preparation method has been used for the ingredient weight. Finally, click the OK button to complete the change, or the Cancel button to close the dialog box without changing.

#### The Properties Component

The Properties component is where nutrients are globally added and removed. To access this component, first click on the Data button in the left pane of the &krecipes; window and then, click on the Properties button.

As with other &krecipes; components, the name of the component appears in the right pane of the window at the top. Below this, beneath the heading Property, the list of nutrients is displayed. Beneath the heading Units, the units associated with the properties are shown.

Here's a screenshot of the &krecipes; Properties component. Schermafdruk

The Properties Component

For example, one of the nutrients under the Property heading is iron. If a recipe ingredient contains this nutrient, the amount of iron contained in the ingredient will show as a number of milligrams or mg.

##### Adding Properties

A number of nutrients have been provided by default in the &krecipes; program. By default, all available nutrients are selected to be displayed in your recipes, if you choose to do so. However, you will notice in the screenshot that you can select exactly which nutrients that you want to display. This is a great way to watch your diet for specific nutrient intake.

Although the nutrient list provided by default is quite extensive, if there is a nutrient missing, it is possible to add it to the list. To add a missing nutrient, click the Create... button that appears near the top in the right-hand side of the &krecipes; window. The New Property window will appear. In this window, the `name of the nutrient` can be entered in the text box beside the Property name: label, and the associated `unit of measure` is entered in the text box beside the Units: label. Click the OK button to proceed with the addition, or the Cancel button to close the window and return to the previous screen.

Adding a nutrient, or Property, is a two-step procedure. First, the nutrient and associated unit is added in the Properties component as described above. However, the actual nutrient value – i.e. the number of mg of iron, for example, contained in a particular ingredient must be added within the Ingredients component. This must be done for EACH ingredient. Refer to the section Properties in Ingredients for more information.

##### Deleting Properties

To remove a nutrient from the list, click the Delete button that appears below the Create... button that was used to create a new nutrient.

An alert box will appear asking Are you sure you want to delete this property? Click the Continue button to proceed with the removal of the nutrient, or the Cancel button to cancel the action and close the alert.

###### Another method:

An alternative method to either add, remove, or edit a nutrient is to first, select a nutrient and then, right-click to display a menu from which you can select Create, Delete, or Rename.

For quick functionality, the &Ctrl;C key combination can be used to Create a new nutrient. To Delete a nutrient, press the Del key on the keyboard – a prompt will appear asking Are you sure you want to delete this property? and can be acted on in the same manner as previously explained. The key combination &Ctrl;R can be used to Rename an nutrient.

#### The Units Component

In the Units component, not only can units of measure that are to be used in the &krecipes; program be added and removed, but conversions between the various measures can be set up!

The Units component is accessed by first, clicking on the Data button to reveal the additional &krecipes; components, and then, clicking on the Units button.

Like other &krecipes; components, the Units component appears in the right-hand side of the &krecipes; window with the name of the component appearing at the top. Three tabs exist – one for listing and maintaining the units of measure and two for setting up the conversion tables between the various units of measure.

One of the conversion tables is for mass conversions, for instance, between grams and pounds. The other table is for volume conversion, for example, between fluid ounces and cups. It is these conversion tables, along with the ingredient weights that determine the nutrient values in your recipes. See the section Working with Ingredient Weights for help with ingredient weights. Refer to Completing Your Conversion Tables later in this section for an outline on setting your conversion factors.

In the Units tab, a list of all the units of measure will appear. This list includes the units of measure that have been provided by default and those that you have added, either by entering a new unit while entering a new recipe, or by adding the unit within the Units component.

Here's a screenshot of the Units tab in the &krecipes; Units component. Schermafdruk

Units Component – The Units List

You will also note that each unit allows a singular and plural form of that unit, if one exists. Additionally, abbreviations for both singular and plural forms can be set. A unit type can also be specified for each unit.

##### Adding Units of Measure

To add a unit of measure, click the Create... button that appears to the right of the Unit list. The New Unit dialog box will appear where the name of the new unit can be added. Beneath the heading New Unit, there is a text box to `enter the singular form of the unit` and one to `enter the plural form of the unit`. To the right of each of these text boxes is another pair of text boxes in which to `enter the abbreviation` for both singular and plural forms respectively. However, since both singular and plural abbreviations are most often identical, typing the abbreviation in the singular text box, will result in the plural abbreviation being automatically completed. On the rare occasion that the plural abbreviation is different, you can easily edit the entry.

Finally, the unit type is selected from the drop-down menu that appears beside the label Type:. Choices for unit type are: —

- Overig – dit is de standaard en dus wordt dit getoond in het afrolmenu

  Dit type wordt gebruikt voor elke eenheid die niet kan worden aangeduid als gewicht of volume.

- Gewicht – voor deze eenheden waaraan gewicht kan worden gehangen, bijvoorbeeld, gram of pound

- Volume – voor deze eenheden waaraan volume kan worden gehangen, bijvoorbeeld, cup, quart, liter

Once all entries have been made, click the OK button to complete the addition, or the Cancel button to cancel the addition and close the box. Below, is an example of what the New Unit dialog box will look like once completed.

##### Maateenheden verwijderen

To remove a unit of measure, in the Unit list, select the unit that you wish to remove. Click the Delete button that appears to the right of the list and below the Create... button that is used to add units of measure. A slight delay will occur while the database is searched to ensure that no recipes exist that use that unit of measure and then, the unit of measure will be removed.

If a recipe exists that uses the unit of measure selected to be removed, a window will appear with the alert The following will have to be removed also, since currently they use the element you have chosen to be removed. Beneath the heading Recipes, the list of recipes utilizing that unit will appear. Beneath the heading Ingredient Weights a list of ingredients is shown that utilize the unit of measure in the Ingredient Weights section. Click the OK button to proceed with the removal of the unit of measure AND any or all recipes/ingredients using that unit. Click the Cancel button to cancel the action and close the window.

##### Uw conversietabellen voltooien

Conversions between units are entered in the Mass Conversions tab for those units associated with a weight. For those units associated with a volume, the conversions are set in Volume Conversions tab. Both of these tables are set up in a spreadsheet style format. Down the side of the table, you will note that each row is labeled with a unit name. Similarly, along the top, each column is also labeled with a unit name. The cells in the body of the table are used to set the equivalencies. 1 to 1 equivalencies are provided by default.

Hier is een schermafdruk van het tabblad Gewichtconversies in de eenhedencomponent van &krecipes;. Schermafdruk

Eenhedencomponent – conversies van gewichtseenheden

Hier is een schermafdruk van het tabblad Volumeconversies in de eenhedencomponent van &krecipes;. Schermafdruk

Eenhedencomponent – conversies van volume-eenheden

Both of these conversion tables are completed in the same manner. Using the Volume Conversion, table as an example, down the left side of the spreadsheet, suppose there is a unit of measure labeled cup . Using the horizontal scroll bar at the bottom of the window, if necessary, find the column that has the label fluid ounces at the top. Click on the cell that is beside cup and below fluid ounces. You can now enter 8, which is the equivalent in fluid ounces of 1 cup, in the cell. You can also use the directional arrows to navigate to the correct position for entering the equivalent if another cell is already active.

For large number equivalents, &krecipes; will automatically format the number with a thousands separator. For instance, to enter the milligram equivalent of 1 pound in the Mass Conversion table, you would enter 454000. Once you move off the cell, &krecipes; will display the number as 454,000.

Once the &krecipes; program knows the some of the conversions, it can automatically calculate others. For example, if the program has been informed that there are 8 fluid ounces in a cup, &krecipes; will automatically calculate that 1 fluid ounce is equal to .125 (or 1/8) of a cup.

###### Using the Measurement Converter

The Measurement Converter is accessed by selecting Tools and Measurement Converter from the &krecipes; menu. The interface can also be activated by using the &Ctrl;M key combination.

The Measurement Converter works in conjunction with your Ingredient Weights and/or your conversion tables. If your conversion tables have not been completed, or you have not specified a unit type in the Units tab of the Units component, for example, mass or volume, the Measurement Converter will not be able to do its job. It will also not provide conversions if the Ingredient Weights have not been completed in the Ingredients component.

Here's a screenshot of the Measurement Converter tool. Schermafdruk

The Measurement Converter.

As you will note from the screenshot, when the Measurement Converter starts, beside the label Convert there is a text box in which the enter `the amount you want to convert`. Beside this text box, there is a drop-down menu from which to select the unit of measure that is associated with the amount that you are converting.

Below the amount and unit that you want to convert, there are two drop-down menus from which making a choice is optional. The first menu is labeled --Ingredient (optional)-- and is for choosing an ingredient. The second is labeled -No Preparation- and is for selecting a preparation method, if desired. However, it is these two menus that cause your Ingredient Weights to come into play. For example, suppose one of your recipes calls for 8 cups of apples and you want to know how many pounds of apples you need to buy. The Measurement Converter can help!

Beside the label To is a drop-down menu for selecting the unit that you want to convert to. Below this menu and beside the label Result: the result displays. Of course, before the result will display, you must click the Convert button.

Two other buttons exist at the bottom of the Measurement Converter window – the Close button that will close the window without performing a conversion, or once you have performed a conversion and finished using the information displayed, and the Help button, which opens the &krecipes; Handbook to this section.

As previously stated, the drop-down menus for selecting an ingredient and preparation method are optional unless you are converting ingredient amounts. The Measurement Converter can also be used for straight numeric conversion. For instance, the situation might exist where you have a recipe that lists the ingredients in imperial measure, but you want to convert them to metric measure. The Measurement Converter can also be used to find the equivalent for a multiple, for instance, how many milliliters are there in 4 fluid ounces? You won't want to be without this handy tool!

#### The Preparation Methods Component

To access the Preparation Methods component, first click on the Data button to reveal additional components and then, click the Preparation Methods button. In the right-hand pane of the &krecipes; window, a list of preparation methods will be displayed under the heading Preparation Method. Note that the name of the component also appears at the top of the pane.

Here's a screenshot of the &krecipes; Preparation Methods component. Schermafdruk

The Preparation Methods Component

The preparation methods listed include those installed by default with the program and those that are automatically added when a method is typed into the Preparation Method field while entering a new recipe. See the section Adding a New Recipe.

##### Adding a New Preparation Method

To add a new preparation method, click the Create... button that is seen in the upper right-hand portion of the screen. A dialog box will appear containing a text box that allows entry of the new preparation method under the heading New Preparation Method.

`Enter the name of the new preparation method`, for example, Slightly beaten in the text box provided. Click the OK button to complete the addition, or the Cancel button to cancel the addition and return to the Preparation Method list.

##### Deleting a Preparation Method

To remove a preparation method, first select the method to be removed from the list of preparation methods displayed. Then, click on the Delete button that is displayed in the upper, right-hand portion of the screen beneath the Create... button.

Should the preparation method selected for deletion be used by a recipe, a dialog box will appear stating The following elements will have to be removed also, since currently they use the element you have chosen to be removed. Below this, the list of recipes utilizing the preparation method will show. Click the OK button to proceed – REMINDER: This will delete not only the preparation method, but the recipes utilizing that method as well! To cancel removal of the preparation method, click the Cancel button.

Should no recipe utilize the preparation method selected for deletion, no prompt will be given.

##### Editing Preparation Methods

Preparation methods can also be edited simply by double-clicking on the desired method.

For example, to change the method Slightly beaten to Slightly Beaten, double-click on the method in the list. A box will appear around the method, the method will be highlighted and an insertion point will appear. Use the ← or the → directional arrow keys as required to position the cursor in the appropriate position to change the lowercase b in beaten to uppercase. Press the &Enter; key to complete the change.

#### The Categories Component

When the Categories component is selected, the list of all created categories will appear under the heading Category. Those categories that have sub-categories will be shown with a + (plus) sign beside them, indicating that the category can be expanded. Once expanded, the main category will show a - (dash) beside it and the list of sub-categories will be visible.

Here's a screenshot of the &krecipes; Categories component. Schermafdruk

The Categories Component

##### Adding a New Category

To add a new category, click on the Create... button.

A window will pop up where the name of the new category can be entered in a text box under the label New Category. A subcategory can be selected using the Subcategory of drop-down menu, which lists existing categories. The default for the subcategory is **NONE**.

Once the name of the new category has been entered in the text box, click the OK button to create the category and return to the category list. The list will now show the new category.

To cancel the addition of a new category and clear the window, click on the Cancel button.

##### Removing a Category

To remove a category, select it from the list of categories and click the Delete button.

A prompt will appear asking, Are you sure you want to remove this category and all its subcategories?. Click the Continue button to remove the category, or the Cancel button to cancel the removal.

Before deleting a category, ensure that it contains NO recipes! Despite the warning Are you sure you want to remove this category and all its subcategories?, clicking the Continue button will result in the deletion of the category whether or not it contains recipes!

#### The Authors Component

The Authors component is where the author or contributor of the recipe is maintained.

Within this component, the component title appears at the top and the list of authors appears in the main portion of the window.

##### Adding an Author or Contributor

To add an author/contributor, click on the Create... button on the right-hand side of the screen.

A window will appear that allows entry of the author's name in the text box labeled New Author

Here's a screenshot of the &krecipes; Authors Component showing the addition of a new author. Schermafdruk

Authors Component – Adding an Author

Once a name has been entered, click the OK button to create the entry, or the Cancel button to cancel entry of a new author's name and close the window.

##### Removing an Author/Contributor

To remove an author/contributor from the list, select the author from the list and click the Delete button on the right-hand side of the screen.

When this button has been clicked, an alert will appear with the stating WARNING: The following currently use the element you have chosen to be removed. Beneath the heading Recipes, the list of recipes that have specified this author as the contributor will appear. Click the Continue button to delete the author, or the Cancel button to cancel the deletion.

## Setting Preferences in &krecipes;

&krecipes; is extremely configurable and allows the setting of many preferences besides those defined in the Page Setup section.

### Creating Shortcuts

To access the Shortcut configuration interface, select Settings and Configure Shortcuts... from the &krecipes; menu. The Configure Shortcuts – &krecipes; screen will appear.

Here's a screenshot of the Configure Shortcuts – &krecipes; starting screen. Schermafdruk

Configure Shortcuts – &krecipes; Starting Point

Voor meer informatie lees de sectie over Sneltoetsen gebruiken en aanpassen van de &kde;-fundamentals.

### Customizing the Toolbar

To access the Toolbar configuration interface, select Settings and Configure Toolbars... from the &krecipes; menu. The Configure Toolbars – &krecipes; screen will appear.

Here's a screenshot of the &krecipes; Toolbar configuration screen. Schermafdruk

Configure &krecipes; – Configure Toolbars interface

From the screenshot, you will notice that choices available for addition to the toolbar are on the left under the heading Available actions:. On the right, under the heading Current actions: are the icons that presently appear on the toolbar – note that your toolbar, by default, may appear differently from that displayed in the screenshot.

Between the two lists are four arrows, which allow for directional movement between the lists, or up and down in the list. When an item is selected from either list, the directional arrow(s) that are functional are colored, while the non-functional arrow(s) are grayed. Movement is accomplished by clicking on the appropriate directional arrow, as necessary, to move the selection into the desired position.

The icon for your selection can be changed by clicking the Change Icon... button. This will bring up a window from which you can select the icon that you want to use. Once selected, click the OK button that appears on the icon selection screen to close the window and attach the icon to the toolbar selection.

In order to apply your changes, you must click the Apply button that appears at the bottom of the Configure Toolbars – &krecipes; screen. This will apply your changes, but leave the window open in order to make other changes, if desired. To apply your changes and exit the interface, click the OK button. Clicking the Cancel will cancel any changes made since the last time the Apply button was clicked.

### Configuring &krecipes;

When you choose Settings and Configure &krecipes; from the &krecipes; menu, the &krecipes; Preferences - &krecipes; window appears. From this window, you can choose one of five pages to configure various aspects of &krecipes;.

#### Serverinstellingen

The first preference that you can configure is the Database Server Options. You will notice from the following screenshot that this label shows that an SQLite database has been selected. However, if the database selected is either MySQL or PostgreSQL the label would show the name of the appropriate database format. The Database file: label shows the complete path to the database file.

Here's a screenshot of the &krecipes; Server Settings configuration window. Schermafdruk

Configure &krecipes; – Server Settings interface

If you wanted to choose another database file, you would click on the File icon and in the window that appears, navigate to the location of the database file that you want to use. This change would be reflected in the Database file: text box.

The second preference available for configuration in the Server Settings screen is for the Backup operation. It is required that the path to your database program be known for the Backup operation to work properly. Therefore, beside the label that is shown in the screenshot as Path to 'sqlite3':, there is a text box which shows the name of the database program. The text in this box can be changed by directly editing it, or by clicking the File icon, which will activate the screen that allows you to navigate to the location of your database program executable file.

You might want to do this if you have chosen to install your database program to a location that is different from the default. Also note that, in the screenshot, the database program shows as sqlite3. However, if you use another database program, for instance MySQL or PostgreSQL, the appropriate database would be shown.

This setting is for the purpose of setting the location of the database file. For specific information on backing up your database, see the section Backing Up Your &krecipes; Database.

Also exclusive to the Server Settings screen, is the Re-run wizard on next startup tickbox that can be selected to reload the database with the recipes and USDA data that come as defaults with the &krecipes; program.

Buttons that appear at the bottom of the Server Settings screen are common to each of the preference screens and function as follows —

- OK – sets any changes made and closes the &krecipes; Preferences - &krecipes; window

- Cancel – cancels changes, if any have been made, and closes the &krecipes; Preferences - &krecipes; window

- Help opens the &krecipes; Handbook to the associated section

#### Customizing Formatting

Here's a screenshot of the &krecipes; Formatting configuration window. Schermafdruk

Configure &krecipes; – Formatting interface

From this window, there are two formatting preferences that can be customized —

1. Number Format – either Fraction or Decimal can be selected by clicking on the appropriate radio button and this choice controls how the units of measure will display in your recipes

2. Use abbreviations – this feature is turned on by clicking on the tickbox beside the label

   If the abbreviations have been completed for your units, the result of selecting to Use abbreviations is that your units of measure will be displayed in their abbreviated form when you are viewing or printing your recipe, and in the printable version of your Shopping List.

#### Choosing Import/Export Preferences

Here's a screenshot of the &krecipes; Import/Export configuration window. Schermafdruk

Configure &krecipes; – Import/Export interface

On this screen under the heading Import, two options exist —

The first is Overwrite recipes with same title and this feature can be turned on by clicking the tickbox beside the label. This might be a good idea if you are re-importing a currently loaded database.

Should you choose NOT to overwrite existing recipes and you have a recipe titled Chocolate Cheesecake, for example, in your recipe list, if you import another Chocolate Cheesecake recipe, the listing will appear as —

Chocolate Cheesecake

Chocolate Cheesecake (2)

The second option is Ask which recipes to import and again, this feature can be turned on by selecting the text box. If this feature is not turned on, your recipes will be imported silently with no prompt. See the section Importing and Exporting Recipes for a screenshot that will show the result of this option being selected.

##### Copying to the Clipboard

Under the heading Export, a drop-down menu exists from which you can select the Copy to Clipboard format you wish to use.

Essentially, copying to the clipboard is the same as exporting a recipe. The difference lies in the end result of the export. The traditional export function creates a file (see the section Exporting Recipes to Other Formats for a complete description of this). The Copy to Clipboard function creates a copy of the recipe in the specified format and places the copy on the clipboard. This provides the ability to paste that copy into an email, for example. The usefulness of this might be in the situation where an attachment to an email might be scrubbed.

The available choices for Copy to Clipboard are —

- Plain Text (*.txt) – If copied to the clipboard in this format, the result will be a plain text copy of the recipe.

- &krecipes; (*.kreml) – If copied to the clipboard in this format, the result will contain all the associated markup tags that allow formatting which is associated with &krecipes;.

- Meal-Master (*.mmf) – If copied to the clipboard in this format, the result will be a format that is recognized by the Meal-Master program.

- Rezkonv (*.rk) – If copied to the clipboard in this format, the result will be a format that is recognized by the Rezkonv program.

- RecipeML (*.xml) – If copied to the clipboard in this format, the result will contain all the associated markup tags that allow formatting associated with RecipeML.

As previously stated, once the recipe is copied to the clipboard in the desired format, it can be pasted into an email. It can also be pasted into a text editor for the purpose of saving the document. When a recipe is copied to the clipboard in a plain text format and then pasted into an email or another document, it is not intended to be imported back into &krecipes; or any other recipe program. However, suppose another format has been selected for Copy to Clipboard. What do you do then and how do you get it back into a related recipe program?

If the recipe has been copied into an email and sent, the recipient could just copy the section associated with the recipe and then, paste it into a text editor and save it to a file with the extension associated with the format – .kreml for &krecipes; format, .mmf for Meal-Master format, .rk for Rezkonv format, or .xml for RecipeML format. Once saved, this file could then be imported back into the associated recipe program.

If the contents of the clipboard have been pasted directly into a text editor, the file can then be saved with the appropriate extension as previously listed and imported back into the associated recipe program.

#### Enhancing Performance

Here's a screenshot of the &krecipes; Performance configuration window. Schermafdruk

Configure &krecipes; – Performance interface

In this interface, you are customizing two settings. For a reason that you might want to do this, see the section Reasons for Configuring Performance Settings. These settings can be used individually or together or not at all.

The first is to set the number of categories that appear in the list when the Find/Edit Recipes component is selected. By default, this number is set to Unlimited, which means that all categories will be displayed. To change this setting, adjust the slider that appears below the label Number of categories to display at once: until the desired number appears, or use the spinbox to set the number.

The second setting that you might wish to change is for the number of items that are displayed in lists, for example, the Ingredients list or Properties list. Again, by default this is set to Unlimited and to change the setting you would adjust the slider that appears below the label Number of elements to display at once:, or use the spinbox until the desired number appears.

It should be noted that for the Number of elements to display at once: setting, the adjustment is done in increments of 1000 when using the spinbox. Should you wish to set smaller numbers, you can do this by highlighting the word Unlimited or whatever numeric entry appears in the box and type the number that you wish to use. However, this feature is ideally used when you have a very large database of recipes.

##### Reasons for Configuring Performance Settings

In most instances, the settings to adjust the Number of categories to display at once: and/or the Number of elements to display at once: will not have to be changed. The ultimate reason that you might want to do so occurs when you have a very large database of recipes. Adjusting these settings so that your Categories or list items are loaded in groups will greatly improve the speed of loading for these items.

## Reporting Problems

In the event that &krecipes; program does something unexpected and you think this might be a bug, you can submit a bug report to the program maintainer. Even if you do not encounter any problems and you have an idea to improve &krecipes;, you can submit this request as well. By submitting a report in either of these situations, it will help us to continually improve &krecipes;.

### Reporting Bugs/Requesting Feature Enhancements

To submit a bug report, select Help and Report Bug from the &krecipes; menu bar. The Submit Bug Report – &krecipes; window appears as in the screenshot below:

Here's a screenshot of the &krecipes; interface for submitting bugs or feature requests. Schermafdruk

Submitting Bug Reports and Feature Requests

This is the actual interface used to submit the bug report or feature enhancement in a web browser window on bugs.kde.org.

## Overzicht van de opdrachten

### The main &krecipes; window

#### Het menu Bestand

&Ctrl;N Bestand Nieuw recept

- Een nieuw recept maken - zie Invoeren en bewerken van recepten voor details.

&Ctrl;S Bestand Opslaan

- Slaat het recept op.

&Ctrl;P Bestand Afdrukken

- Drukt het huidige recept af – zie de sectie Uw recept afdrukken voor instructies.

&Ctrl;I File Import from File...

- Recepten importeren uit een bestand – zie de sectie Uit een bestand importeren voor instructies.

Bestand Uit een database importeren...

- Recepten importeren uit één van drie databases

  See the corresponding sections on importing from a Database – SQLite, MySQL, or PostgreSQL.

&Ctrl;O File Export...

- Exports either a single recipe or all recipes to a file – Exporting Recipes to Other Formats.

Bestand Reservekopie maken

- Backs up your &krecipes; database file refer to the section Backing Up Your &krecipes; Database.

File Restore

- Restores your &krecipes; database file refer to the section Restoring Your &krecipes; Database.

&Ctrl;Q Bestand Afsluiten

- Quits &krecipes;.

#### Het menu Bewerken

&Ctrl;E Edit Edit Recipe

- Accesses the &krecipes; Edit mode - see Entering and Editing Recipes for details.

&Ctrl;C Edit Copy to Clipboard

- Will make a text copy of a selected recipe and place it on the Clipboard in order to paste into another application, for example an email.

#### Het menu Beeld

F5 Beeld Herladen

- Reloads the currently active recipe.

&Ctrl;L Beeld Recept(en) tonen

- Displays the currently active recipe.

#### Het menu Hulpmiddelen

&Ctrl;M Tools Measurement Converter

- Accesses the &krecipes; Measurement Converter tool - see the Using the Measurement Converter section for instruction.

#### Het menu Instellingen

Settings Page Setup...

- Accesses the &krecipes; Page Setup interface for defining the page layout – see the section on Page Setup for further details.

Settings Print Setup...

- Accesses the &krecipes; Print Setup interface – this interface is identical to the Page Setup, but is used to define a setup that can be different and separate from the page layout for viewing your recipes.

  See the section on Print Setup for further details.

Instellingen Statusbalk tonen

- Turns display of Statusbar on and off.

Instellingen Sneltoetsen instellen...

- Opens the Configure Shortcuts - &krecipes; window from which Shortcuts can be defined.

  For complete instructions on configuring shortcuts, see the section Creating Shortcuts.

Instellingen Werkbalken instellen...

- Opent het venster Werkbalken instellen - &krecipes; waaruit Werkbalken ingesteld kunnen worden.

  Zie de sectie De werkbalk aanpassen voor details.

Instellingen &krecipes; instellen...

- Opent het venster Instellen - &krecipes; waarin een aantal voorkeuren gedefinieerd kunnen worden.

  Zie de sectie &krecipes; instellen voor specifieke instructies voor instellingen.

#### Het menu Help

&krecipes; heeft een aantal van de algemene &kde; items in het menu Help, voor meer informatie lees de sectie hierover in het Menu Help van de basisinformatie van &kde;.

## Vragen en antwoorden

&reporting.bugs; &updating.documentation;

Ik heb heel veel recepten in &krecipes; gestopt en nu draait en laadt het erg langzaam. Is er iets waarmee ik het kan versnellen?

&krecipes; kan prima werken met duizenden recepten, zelfs op een middelmatige machine, het wordt nu getest met meer dan 50.000 recepten.

Dit is wat u kunt doen:

- Selecteer de MySQL of PostgreSQL backends. Ze bieden een betere overall prestatie dan SQLite, speciaal voor een zeer grote hoeveelheid recepten.

- In de dialoog &krecipes; instellen, regel af de Opties voor prestaties.

- Rubriceer uw recepten in categorieën. &krecipes; zullen veel sneller laden als alle recepten zich in categorieën bevinden.

De ingrediëntenovereenkomst komt nooit overeen met een recept. Wat doe ik fout?

The purpose of the Ingredient Matcher is to find recipes that you are able to make (or almost make) with ingredients that you select. That means you have to select every single ingredient used in a recipe (or all but a few, depending on how many ingredients can be missing) to match that recipe. See the Ingredient Matcher section for details.

Als u wilt zien welke recepten bepaalde ingrediënten gebruiken, dan kunt u het Zoeken op ingrediënten gebruiken.

Waar zijn alle recepten?

Bij het uitvoeren van de assistent van &krecipes; zult in staat gesteld worden om voorbeeld recepten te kiezen om te installeren, de primaire functie van het programma is om u in staat te stellen uw verzameling recepten op te slaan en te beheren.

Als u opzoek bent om uw persoonlijke verzameling recepten aan te vullen, er zijn sites op het internet die duizenden recepten bevatten die vrij beschikbaar zijn. Waaronder: —

Alles wat er nodig is is het downloaden van het recept en het daarna importeren in uw database. Zie de sectie Importeren uit een bestand voor hulp bij deze functie.

## Dankbetuigingen en licentie

&krecipes; programma copyright 2003-2010 bij de ontwikkelaars van &krecipes;

## De ontwikkelaars van &krecipes;:

Unai Garro ugarro@gmail.com

- Initiator & voormalig kernontwikkelaar

Jason Kivlighn jkivlighn@gmail.com

- Voormalig onderhouder van het project & voormalig hoofdontwikkelaar

Cyril Bosselut bosselut@b1project.com

- Voormalig kernontwikkelaar

Daniel Sauvé megametres@gmail.com

- Overzetten naar het platform &kde; 4

Laurent Montel montel@kde.org

- Overzetten naar het platform &kde; 4

José Manuel Santamaría Lema panfaust@gmail.com

- Overzetten naar het platform &kde; 4 & onderhouder van project

Martin Engelmann murphi.oss@googlemail.com

- Overzetten naar het platform &kde; 4 & hoofdontwikkelaar

Documentatie copyright 2004-2010 Colleen Beamer colleen.beamer@gmail.com, Jason Kivlighn jkivlighn@gmail.com en José Manuel Santamaría Lema panfaust@gmail.com

&meld.fouten;&vertaling.freek; &underFDL; &underGPL;
&documentation.index;