home *** CD-ROM | disk | FTP | other *** search
/ Colossal Cookbook / ColossalCookbook.cdr / mm631 / import.doc < prev    next >
Text File  |  1991-11-20  |  4KB  |  82 lines
  1.  
  2.  
  3.  
  4.  
  5.                        MEAL-MASTER IMPORT FILE SPECIFICATIONS
  6.  
  7.  
  8.        The Meal-Master import function was only designed to import recipes
  9.        previously exported from the program.  However, the export format is a
  10.        simple text file that can be created by most text editor programs.
  11.        Many people have found that recipes from other sources can be edited to
  12.        look like a MM export file, allowing them to be imported to MM with
  13.        little or no retyping.  All it takes is some patience, some practice,
  14.        and an understanding of exactly what the import process is expecting.
  15.        This file won't help with the first two, but here is a description of
  16.        what the program expects to see in an importable file:
  17.  
  18.        FIXED FORMAT (LINES 1 THROUGH 6)
  19.  
  20.          Line 1  The first line of a valid recipe is a "recipe header" line.
  21.                  This line must begin with at least 5 hyphens ('-----'), and
  22.                  must contain the words "Meal-Master" somewhere on the line.
  23.                  Any lines found prior to this "recipe header" line will be
  24.                  ignored by Meal-Master.
  25.  
  26.          Line 2  Must be blank.
  27.  
  28.          Line 3  The word "Title:" must begin the line, in any position, and
  29.                  followed by one blank space.  The recipe title must start
  30.                  after the blank space, and may be a maximum of 60 characters
  31.                  in length.
  32.  
  33.          Line 4  The word "Categories:" must begin the line, in any position,
  34.                  and followed by one blank space.  A maximum of 5 category
  35.                  names may be entered, beginning after the blank space.  Each
  36.                  category MUST start with a capital letter, and all remaining
  37.                  letters must be lower case.  The names must be separated by
  38.                  one, and only one, space.
  39.  
  40.          Line 5  The word "Servings:" should start the line, but is not
  41.                  required.  A numeric quantity between 1 and 9999 must appear
  42.                  somewhere on this line.
  43.  
  44.          Line 6  Must be blank.
  45.  
  46.        VARIABLE FORMAT - LINES 7 AND GREATER
  47.  
  48.          Beginning with line 7, Meal-Master will attempt to identify each line
  49.          as being an ingredient line, direction line, or the "end of recipe"
  50.          trailer line.
  51.  
  52.          If a line is found that starts with 5 hyphens, and contains no
  53.          characters other than hyphens and spaces, the program considers this
  54.          the "end of recipe" trailer line.  It will store the current recipe
  55.          and begin searching for another "recipe header" as described in "line
  56.          1" above.
  57.  
  58.          If all the following are true, the line will be interpreted as an
  59.          ingredient and loaded into Meal-Master:
  60.  
  61.             1) Positions 9-10 contain one of the valid Meal-Master unit of
  62.                measure codes.  (see list in program or user's manual)
  63.  
  64.  
  65.  
  66.             2) Positions 1-7 contain a valid numeric quantity, either
  67.                expressed as a whole number, decimal fraction, or common
  68.                fraction.
  69.  
  70.             3) Positions 12-39 contain text for an ingredient name.
  71.  
  72.          If the line does not qualify as an ingredient line or end of recipe
  73.          line, as specified above, data in positions 3-77 (or 1-75 if
  74.          positions 1-2 are non-blank) will be imported as a direction line.
  75.  
  76.        Files can contain multiple recipes, so long as each begins with a
  77.        "header line" and ends with a "trailer line".  Any text in the file
  78.        that is not between the header and trailer lines is ignored.
  79.  
  80.        NOTE:  THIS SPECIFICATION IS ONLY VALID FOR MEAL-MASTER VERSION 6.21
  81.               AND HIGHER, AND WILL NOT WORK PROPERLY WITH EARLIER VERSIONS.
  82.               PLEASE OBTAIN VERSION 6.21 OR GREATER FOR PROPER RESULTS!