By default, Krecipes starts with the Find/Edit Recipes component selected in the left pane of the window.
This section describes the method of finding recipes in the Find/Edit Recipes component. For more specific details on Editing recipes, see the section Editing Saved Recipes
With the component button selected, the main Krecipes window displays the following —
A title showing the name of the component selected
Basic (the default) and Advanced tabs
A text box to
enter search criteria
A cool feature here is that Krecipes will search for recipes as you type a text string in the Search: box. For example, if you wanted to find a recipe containing the word “apple”, the recipes that display in the recipe view would show only those recipes that contain the text string and would be filtered more finely as each subsequent letter is typed.
A list of all recipe categories
Buttons for show, edit and delete the selected recipes.
You will notice the icon in the bottom, right-hand corner of the pane containing the component list. This icon appears in all Krecipes components and when clicked, will open the corresponding section of this Handbook if you need extra help at any time.
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 .
Conversely, clicking the button beside the category name will collapse the category.
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 —
Show recipe(s) – Shows the selected recipes.
Edit recipe – Opens the selected recipe for editing.
Export... – Exports the selected recipe. See the section Exporting Recipes to Other Formats for a complete description of this function.
Add to Shopping List – Adds the selected recipe to your shopping list. See the section The Shopping List for information regarding the use of the Shopping List.
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.
Delete – Deletes the selected recipes from the database.
Some of the actions explained above may be applied to multiple recipes. You can select various recipes thusly: hold the Ctrl key and select the desired recipes by clicking on them.
The purpose of the Advanced tab is to provide advanced search capability. Queries for recipes can be made based on nine search criteria, alone or in combination —
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 button to initiate the search once all desired search criteria have been selected. Clicking the 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.
The various components are used as follows —
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.
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.
Recipes can be searched for based on various 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.
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.
The use of the Categories search is most useful when combined with other search parameters.
In the following screenshot, it is being specified that recipes should be searched for in the Desserts and Main Dishes categories.
In the next screenshot, recipes are still being searched for in the Desserts and Main Dishes categories. However, recipes that contain some form of the word “apple” (note the use of the wildcard) are being excluded.
Are you looking for a recipe given to you by a certain person or input into Krecipes from a specific magazine? The Authors component of the Advanced tab allows you to find that recipe!
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”.
Searches can be performed in the following ways —
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.
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.
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.
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.
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 —
Created: – This is the date that the recipe was created on.
Modified: – This is the date that the last revision was made to the recipe.
Last accessed: – This is the date that the recipe was last opened or “used”.
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.
The calendar allows you to easily navigate though months and years to select any date.
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 . 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 would place today's date in the Meta Data text box being used. Clicking would, of course, place tomorrow's date in the box. would place the date that is one week forward today in the box. 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 —
Click on the month displayed – This will reveal a list from which you can select a desired month.
Click on the year displayed – This is reveal a text box that displays the current year, but in which another year can be entered.
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.
When a Rating search is selected, it can be done in two ways —
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 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.
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 —
whole numbers, e.g. 3
numbers that include fractional amounts, e.g. 3.5
whole number ranges, e.g. 3-4
ranges that include fractional amounts, e.g. 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 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.
For english language, the decimal separator is “.” (period), however if you have configured KDE for other language, the decimal separator may be different. Note that if you are typing an invalid number the text becomes red to warn you.
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.
Examples of Wildcard Searches
|Wildcard Search||Possible Results Returned|