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.

Tip

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.


Screenshot

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.

Warning

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


Screenshot

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


Screenshot

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:

  • Username:

  • Password:

  • Port:

  • Database name:

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:

  • Username:

  • Password:

  • Port:

  • Database name:

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.

Note

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.

    Note

    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.

    Note

    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.

    Note

    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.

Tip

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.

Note

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.