home *** CD-ROM | disk | FTP | other *** search
/ Monster Media 1993 #2 / Image.iso / health / mmconv11.zip / MMCONV.DOC < prev    next >
Text File  |  1993-07-03  |  13KB  |  300 lines
  1.     MMCONV  version 1.10
  2.  
  3.     ver 1.1     - add TEAS to abbreviate
  4.                 - add OUNCES to abbreviate
  5.                 - translate ½ and ¼ (Stan Hall) to 1/2 and 1/4
  6.                 - activate -L & -R options to supply own footer
  7.                 - -T option suppresses display of Titles
  8.                         (opposite of MMCRDTnn functioning)
  9.                 - -C option to change ingredient line number of chars.
  10.                 - add SERVING detection
  11.                 - caseblind CompuChef & QUIKBOOK header/footer detect
  12.                 - CompuChef checks for "**********" & next line "**"
  13.                 - handle continuation in non-MM recipes
  14.                 - title: cap first char of words - lower the rest
  15.                 - no MM count display if it is zero
  16.                 - skip FAT GRAMS, CHOLESTEROL & INGREDIENT lines from
  17.                   COMPU-CHEF
  18.  
  19.  
  20.     MMCONV is designed to be used by those of us who frequent recipe
  21. conferences on BBSes and use MealMaster.  Often people enter intriguing
  22. recipes that are not in MM format.  This program avoids some of the
  23. drudgery of typing such recipes in by hand or manually reformatting them.
  24.  
  25.     MMCONV is designed to convert free-form recipes or recipes formatted
  26. for other recipe databases to MealMaster format with minimal manual
  27. effort.  The MM format is:
  28.  
  29.                units     measure        ingredients
  30.    Col 1:       1-7        9-10           13-39
  31.    Col 2:      42-48      50-51           54-81
  32.  
  33.     MMCONV knows the standard MealMaster measurement abbreviations and uses
  34. them.  I did not know small, large, and pinch had standard abbreviations,
  35. but they do.
  36.  
  37.     MMCONV detects the start and end of recipes in three different ways:
  38.  
  39.         Start of recipe:
  40.  
  41.                 --MM
  42.  
  43.                 **********                       (QUIKBOOK)
  44.                   (next line must have ** in it)
  45.  
  46.                 Recipe Via Compu-Chef
  47.  
  48.         End of recipe:
  49.  
  50.                  ---
  51.  
  52.                  -End Recipe Export-
  53.  
  54.                  Recipe Via Compu-Chef
  55.  
  56.     The program itself provides a brief help screen if run without an input
  57. file:
  58.  
  59.    version n.nn Meal-Master recipe formatter by Rodney Grantham
  60.  
  61.  Usage: MMCONVnn infile [outfile]
  62.  
  63.     infile - contains recipes not in Meal-Master format
  64.     outfile - where to write Meal-Master format recipes
  65.               by default:  MMmmdd
  66.    (Recipes already in MM format are placed in output file)
  67.  
  68.  Some manual pre-processing may be required:
  69.     QUIKBOOK & COMPU-CHEF headings & footers are handled.
  70.      Mark other recipes with --MM at start
  71.            and ---  at end of the recipe.
  72.     Categories are picked up if headed Categories:, Keywords:
  73.       or Cat: (the last is for adding your own category info).
  74.     If none of above is found, Category: Main dish is put in.
  75.     Servings: 1 is always put in the recipe.
  76.     A line of more than 45 characters with no 3 space break
  77.       in it is assumed to be the first direction line.
  78.      -l      - add own footer for left side,e.g., -lFrom mm002.zip
  79.      -r      - add own footer for right side,e.g., -rFound 4/5/93
  80.      -t      - no title display as recipes are found
  81.      -c      - override the default 45 character ingredient line,e.g. -c55
  82.  
  83.     If the program is renamed, the new name will display in the help
  84. message.
  85.  
  86.     Please note:
  87.  
  88.     A line of more than 45 characters with no 3 space break
  89.      -c      - override the default 45 character ingredient line,e.g. -c55
  90.  
  91.     In order to avoid manually marking direction sections, some convention
  92. must be used.  Most recipes don't have more than 45 characters in a line
  93. (unless they are double columns which is handled) in my experience.  If you
  94. frequently have longer lines, you can use the -C option to change the
  95. default.  BUT you may find that you then have directions treated as
  96. ingredients.
  97.  
  98.     If a recipe does not have a QUIKBOOK, COMPU-CHEF, or MealMaster header
  99. and footer, it must be manually marked.  Put --MM at the top and at least
  100. 3 dashes (---) at the bottom.  Both of these must be aligned with the left
  101. margin.  DO NOT add a MealMaster format header to a non-MM recipe.  This
  102. recipes are copied as is.  A QUIKBOOK (don't forget ** on Title line) or
  103. COMPU-CHEF header could be used to mark a recipe, but the --MM and --- are
  104. fewer characters.
  105.  
  106.     The '-l' or '-L' and '-r' or '-R' parameters are ways to label a zip
  107. file or add a comment on the line after the author and date information if
  108. you run an prior MMCREDIT output file through again.  Up to 38 characters
  109. will be used for either.  Some flexibility is supported here.  As long as
  110. the total characters for both is under 76, the program will combine the
  111. input into a credit line.  If the length exceeds 76, the input will be
  112. adjusted to fit the 76 space limit and a message showing the resulting
  113. credit line will be displayed.
  114.  
  115.  To enter just type, for example:
  116.  
  117.  MMCONVnn mmrecipe -lFrom the ZIP file: MM00.zip -rOff    PC101 BBS
  118.  
  119.  This will add the following CREDIT line at the bottom of recipes:
  120.  
  121.   From the ZIP file: MM00.zip            Off PC101 BBS
  122.  
  123.  If you add quotes to the -r parameter, the extra spaces will be preserved
  124. so this input:
  125.  
  126.  MMCONVnn mmrecipe -lFrom the ZIP file: MM00.zip -r"Off    PC101 BBS"
  127.  
  128. produces this CREDIT line:
  129.  
  130.  From the ZIP file: MM00.zip             Off    PC101 BBS
  131.  
  132.  
  133.     MMCONV will handle a missing footer.  It will be stopped by the next
  134. header.  However, this may cause the inclusion of extra stuff such as
  135. taglines and message header information in some cases.  In Meal-Master
  136. format recipes, a flag message about "Unexpected End of Recipe" is placed
  137. at the end of the recipe to alert you to check for a problem.
  138.  
  139.     The MMCONV program will split lines that are too long for the basic MM
  140. format.  If these lines are in column 2, there will be a '-' inserted in
  141. column 1 if it would otherwise be blank.  This is required to force MM to
  142. treat the 2nd column as a separate column.  Without this, MM thinks it has
  143. a single line of input which is too long.
  144.  
  145.     Occasionally recipes have commentary between the title and the
  146. ingredients.  You must manually move these into the direction section of
  147. the recipe or delete them for MMCONV to process the recipe correctly.
  148.  
  149.     MMCONV will recognize categories headed with all the following in any
  150. combination of upper or lower case and format them for MM:
  151.  
  152.          Category:
  153.          Categories:
  154.          Keywords:
  155.          Cat:
  156.  
  157.     Servings will default to 1.  Serving information in the recipe will be
  158. picked up if recognized.  The program looks for these characters
  159. (case-blind) to occur on first non-blank line after the title and expects a
  160. colon or space to follow them:
  161.  
  162.     SERV  (serves or servings or serving detected)
  163.     MAKE  (make or makes)
  164.  
  165. If these are found and the servings is 0, it will be set to one.  If
  166. non-numeric serving is found, default of one will be used.  A message
  167. showing the problem line will print out so you can fix the servings:
  168.  
  169. TOMATO-CILANTRO BREAD
  170.  Problem with servings:
  171.          Makes one 9x5 loaf
  172.  
  173.     A line of more than 45 characters with no space at least 3 blanks wide
  174. (normally occurs between columns or numbers and measurements and
  175. ingredients) are treated as the first direction line.  All subsequent lines
  176. are treated as directions.  This 45 character default can be adjusted with
  177. the -C parameter.
  178.  
  179.     If your first direction is short, e.g., Preheat oven 350, it will be
  180. treated as an ingredient.  You can either reformat the recipe to make the
  181. line longer (add on the subsequent line, for example) or manually adjust
  182. this.
  183.  
  184.     I like to know who originated the recipe.  Typing this information on
  185. each recipe by hand is tedious.  This program will scan through a file and
  186. add a credit line at the end of each recipe based on the From:  and Date:
  187. information in the header.  If the recipes are read from QWK or BlueWave
  188. messages, the From:  and Date:  info is placed at the end of the recipe:
  189.  
  190.   From: NANCY GOLDEN                    Date: 09-21-92
  191.  
  192. If there are no message headers detected, the following is used instead:
  193.  
  194. Converted by MMCONV vers. n.nn
  195.  
  196.     It can also be used to label recipes in a ZIP file or otherwise
  197. extracted MM format recipe file that does not have qwk headers.  In this
  198. case, the new -l and -r parameters are used to specify what you want stated
  199. at the bottom of the recipe.  Every recipe in this case would have the same
  200. comment on it.
  201.  
  202.     If there is a mixture of headed messages and recipes, the message
  203. header information will affect more recipes than the one associated with
  204. it.  Basically, the credit information from it will carry on till the next
  205. header is found.
  206.  
  207.     My approach to using MMCONV is to mark the recipes and then format the
  208. input file with MMCONV.  I then examine the output recipes.  Any recipes
  209. that were not correctly processed, I tweak in the input file and then
  210. reprocess the input file .  This process repeats until the recipes look
  211. right to me.  Or until a few manual changes are all that is required.
  212. Typically, only two passes have been required.  You may take several until
  213. you get a handle on what the program expects.
  214.  
  215.     The following is a sample of what the program output looks like:
  216.  
  217. MMCONV rec.tst
  218.  
  219.  AL'S CHOCOLATE TO THE MAX
  220.  DATE BALLS
  221.  FLOURLESS CHOCOLATE CAKE
  222.  RASPBERRY SAUCE
  223.  RASPBERRY FOOL
  224.  RED LOBSTER GARLIC CHEESE ROLLS
  225.  M&M PIZZAS
  226.  CRUNCHY ALMOND STICKS
  227.  PINATA COOKIES
  228.  ST LOUIS' PEANUT BUTTER COOKIES
  229.  ST LOUIS' RUM BALLS
  230.  
  231.  MM0612.1:
  232.  Recipes saved: 11  (already MM: 2)
  233.     Lines read: 276
  234.  Lines written: 302
  235.  
  236.     The recipe titles display as they are extracted.  This is followed by
  237. the output file name and the number of recipes.  The parenthetical count is
  238. the number of these recipes that were found to already be in MM format.
  239. The lines read and written print out at the end.
  240.  
  241.     Like with MMCRDTxx, the default output file name is MMmmdd.n
  242. (current month and day followed by a file number).  If you provide your own
  243. output file name, the file numbering convention is used similarly to avoid
  244. overwriting existing files.  It is supposed to go up to 999 versions, so
  245. there should be little problem with running out.  I have had up to 30+
  246. versions in testing my programs.
  247.  
  248.     An example of the output produced by MMCONVnn functionality when
  249. encountering an MM recipe:
  250.  
  251. ---------- Recipe via Meal-Master (tm) v7.04
  252.  
  253.       Title: Mexican Fudge
  254.  Categories: Appetizers, Cheese/eggs
  255.    Servings:  1
  256.  
  257.       1 lb Monterey Jack cheese with           1 cn Evaporated milk (13 oz.)
  258.            Jalapeno pepper                     2    Eggs
  259.       1 lb Cheddar cheese                      3 tb Flour
  260.  
  261.           Grate cheese and lay in greased 9" x 13" pan.  Beat milk, eggs, and
  262.   flour together, pour over cheeses.  Bake 40 minutes at 350 degrees F. Cut
  263.   into squares or diamonds, serve hot or cold.
  264.  
  265.  
  266.   From: JOHN BLACKWELL              Date: 03-02-93
  267. -----
  268.  
  269.     I find manually entering recipes a nuisance.  I also found trying to
  270. squeeze odd recipes into MM format very time consuming.  This program took
  271. a while to write.  But I expect to get some value from the time it saves
  272. me.
  273.  
  274.     I expect you will find that it saves you time as well.  If it does, I
  275. would like payment for the program.  I cannot imagine that it does not save
  276. you $5 worth of time if used a few times.
  277.  
  278.     If you want to register and be notified of upgrades, send your name
  279. and address and the BBS name and phone number where you got the program
  280. with $5 to:
  281.  
  282.               Rodney Grantham
  283.               770 Cranberry Tr.
  284.               Roswell, GA 30076
  285.  
  286.     Please include the version number which displays when MMCONV is run
  287. without any parameters.  If there is a newer version, you will be notified.
  288.  
  289.     If you have suggestions send them to the same address.  I can also be
  290. contacted via RIME or I-LINK CUISINE conferences.
  291.  
  292.     If you use the program and don't register, drop me a postcard anyway.
  293. Include any comments and your name and address and BBS name and phone
  294. number where you got the program.  I won't nag you about the money.  I
  295. realize that sometimes people cannot afford $5.  I'd like to track the
  296. spread and usage just out of curiousity.  At least splurge enough to blow
  297. a quarter.  That's real close to freeware.
  298.  
  299.  
  300.