No Description

Samuel W. Flint 589a9305b1 Switch to octavo format 3 years ago
texmf 67fbaa8b8a Update \gitrevision command definition 4 years ago
.gitignore 44b5c2cb41 Hopefully get travis working 4 years ago
.latexmkrc 3c69a7e4cb Update latexmk configuration 4 years ago
.travis.yml 44b5c2cb41 Hopefully get travis working 4 years ago
01-basics.tex 84479dce5f Add chapter specific files 4 years ago
02-breads.tex d13a8fea7c Fix title of ch2 4 years ago
03-salads-dressings.tex 228b1f9f48 Add chapter on breads 4 years ago
04-soups.tex 1613b7aea6 Merge branch 'french-onion' 4 years ago
05-appetizers.tex 228b1f9f48 Add chapter on breads 4 years ago
06-mains-and-entrees.tex 6e75340ec5 Fix typo 4 years ago
07-sides.tex 228b1f9f48 Add chapter on breads 4 years ago
08-desserts.tex 228b1f9f48 Add chapter on breads 4 years ago
09-snacks.tex 228b1f9f48 Add chapter on breads 4 years ago
91-groups.tex 84479dce5f Add chapter specific files 4 years ago
92-menus.tex 84479dce5f Add chapter specific files 4 years ago
LICENSE.txt 7f6d622e8a Add License Grant 4 years ago
Makefile 9b4ec0a7bb Build only a single output 4 years ago
README.md 118d243362 Add README 4 years ago
default.nix 238fd71967 Add in xspace requirement 4 years ago
document.tex 589a9305b1 Switch to octavo format 3 years ago
eqpt-glossary.tex 4821e1b988 Update glossary loading 4 years ago
release.nix 86bb146e36 Remove old, unnecessary code 4 years ago
tech-glossary.tex 4821e1b988 Update glossary loading 4 years ago
term-glossary.tex 4821e1b988 Update glossary loading 4 years ago

README.md

OpenSourceCookbook Project

Welcome to the OpenSourceCookbook Project's primary work repository. We welcome contributions, but please note that they must conform to our general style, and you must agree to license your contribution under CC BY-SA 4.0 (see LICENSE.txt).

Technical

When contributing a recipe, please use the following general format:

\begin{recipe}{Name Of Recipe}{Name of Contributor (optional)}{Number of Servings (optional)}
  \begin{ingredients}
    \ingredient{ingredient 1}{amount}
    \ingredient{ingredient 2}{amount}
  \end{ingredients}
  \begin{enumerate}
    \item Step 1
    \item Step 2
    \item \ldots
    \item Final Step
  \end{enumerate}
  \begin{note}
    Note to cook.
  \end{note}
\end{recipe}

Several fraction-specific commands are provided for measurements. If an un-defined fraction is necessary either add it to texmf/recipe.sty or simply use \nicefrac{num}{denom}.

  • \quarter
  • \third
  • \half
  • \twothirds
  • \threequarters

Style

  • Recipes should, in general, include at least an estimated number of servings.
  • Recipes should also be written in a fairly direct style. No extensive backstories.
  • Ingredient listings should avoid capitalizing names, except for placenames (e.g., Worcestershire), and thus should avoid recommending specific brands of products.
  • Acceptable heats for stove-top use are: low, medium-low, medium, medium-high, high.
  • Oven temperatures should be quoted in Farenheit, as opposed to Celsius (at least until a unit-tagging system has been prepared).
  • Except for baking, use US customary measurements. We'll be working on a way to convert between customary and metric at a later time.
  • Remember to index by major ingredient, technique and cuisine, as well as common dietary restrictions to which the recipe easily conforms.
  • Common dietary restrictions include:
    • Kosher/Kashrut
    • Halal
    • Vegetarian
    • Vegan
    • Dairy-free
    • Peanut-free
    • Nut-free
    • Wheat-free

Building the Cookbook

  • The document, as a whole, may be built using nix-build assuming Nix is installed. If it is not, make is likely sufficient, assuming the requisite LaTeX packages are installed.
  • During development, it is recommended that nix-shell --command 'make continuous' is used to ensure that formatting is correct.