CTAN Comprehensive TeX Archive Network

Directory macros/latex/contrib/recipebook

README
%====Copyright info==========================================================%
%% README.txt
%% Copyright 2015 Brad Granger
%
% This work may be distributed and/or modified under the
% conditions of the LaTeX Project Public License, either version 1.3
% of this license or any later version.
% The latest version of this license is in
%   http://www.latex-project.org/lppl.txt
% and version 1.3 or later is part of all distributions of LaTeX
% version 2005/12/01 or later.
%
% This work has the LPPL maintenance status `maintained'.
% 
% The Current Maintainer of this work is Brad Granger
% This work consists of the file RecipeBook.cls
%
%====Abstract================================================================%
This is a LaTeX2e class file for typesetting recipes.  It is designed for
typesetting one or two recipes per page, with dimensions of 5.5'' x 8.5''.
The hyperlinked table of contents (ToC) and page numbers make browsing
recipes convenient, and the pages can be joined together or printed 2 per page
to normal letterpaper easily.  The size was chosen to work in half-page
3-ring binder cover sheets, because un-laminated paper just doesn't last in the
kitchen.

This class requires pdflatex to compile with image transparency.

The half-letter pages can be printed two per page using your printer driver, or
bound together using pdfjam, a shell script free and available for MacOSX and
Linux.  I haven't tested in MacOS, but in Linux the command to bind together
your recipes for printing is
$ pdfjam --nup 2x1 --papersize '{11in,8.5in}' Recipes.pdf
where Recipes.pdf is the compiled version of your recipes.
More info on pdfjam can be found here: http://go.warwick.ac.uk/pdfjam.

%====Installation instructions===============================================%
The simplest method is to place RecipeBook.cls in the same directory as your
LaTeX source file.  

To install system-wide make the folder RecipeBook in your latex
search path and place RecipeBook.cls inside.

On Debian / Ubuntu systems, the preferred location is:
/usr/local/share/texmf/tex/latex/
Navigate to /usr/local/share/texmf, and execute the following bash command
to update the search path.
$ sudo mktexlsr

%====Command and environment overview========================================%
%----Title page and table of contents----------------------------------------%
\titlepage[<Text>]{<image1>}{<image2>}{<image3>}
This command will generate the title page.  The title is given by <Text> with
the default being Recipes, and <imagex> the image files to use.

\section{<section>}
Add a section heading to the ToC with a hyperlink pointing to the next recipe.

\subsection{<subsection>}
Add a subsection heading to the ToC with a hyperlink.  This also controls
clearing / moving to the next page, so each recipe should be preceeded by
its subsection command.

%----Recipe formatting-------------------------------------------------------%
\title[<fontsize>]{<Text>}
Format the recipe title.  Default <fontsize> is 22pt.

\subtitle[<fontsize>]{<Text>}
Format the subtitle.  Default <fontsize> is 18pt.

\recipesection[<fontsize>]{<Text>}
Add a section heading to the recipe, e.g. before the list of ingredients.

\author[<Preamble>{<text>}
Adds a footnote in the SW corner with text <text> preceded by <Preamble>. 
<Preamble> is 'Author: ' by default.

\begin{info} ... \end{info}
This is a tabular environment with two columns for general recipe info like
cooking time and recipe yield.  

\begin{info*} ... \end{info*}
Same and info environment except more compact spacing.

\begin{ingredients}[<bullet>] ... \end{ingredients}
The standard environment for listing ingredients.  This will not wrap pages.
This is a tabular environment with 2 columns.  Ingredients and section
headers can be listed with the following commands.

\item[<bullet>]{<Text>}
The optional argument <bullet> specifies the list bullets, the default is
the \square icon.

\group{<Text>}
Formats a section header between ingredients.  

\begin{ingredients*} ... \end{ingredients*}
Alternative method for formatting ingredients.  This works best when the 
recipe can be divided into parts, and ingredients listed with their
corresponding instructions.  Formats the ingredients with a light background
with blurred edges.  Uses the same commands for the unstarred version for
listing ingredients.

\step{<Number>}{<Text>}
Instruction steps don't need to be placed in an environment like ingredients.
<Number> gives the instruction number, and <Text> the instruction text.
<Number> should be a single digit followed by a period, or it will overflow the
box.

\hlgroup[<color>]{<Text>}
Formats <Text> in italics with a shaded background with blurred edges.  Useful
for separating instruction steps with section information (e.g. 'For the
sauce').

\begin[<size>]{shrink} ... \end{shrink}
You can put an entire recipe within the shrink environment if it doesn't fit
on the page.  Default value of <size> is 1pt, decimals are allowed.
% Grow environment

\begin[<size>]{grow} ... \end{grow}
The complement of the shrink environment, if you would like your text larger.
Default value is 1pt, decimals are allowed.
%----Image commands----------------------------------------------------------%
\pic[<location>]{<image>}
Add a float image with fuzzy edges to your recipe.  <location> can be h for
here, t for top, or b for bottom.  <image> is the image file, e.g. Burgers.jpg.

\leftbgpic[<length>][<opacity>]{<image>}
Add a background image in the left column.  <length> is the vertical distance
from the top of the page, the default is the length \pagetop.  Opacity is a
number between 0 and 1 with a default of 0.4.  <image> is an image file.

\rightbgpic[<length>][<opacity>]{<image>}
Add a background image in the right column.  Default <length> of \pagebottom
places the image at the bottom of the page.  

%====Class specific lengths==================================================%
% The following lengths are used to control various aspects of the class.
\basefontsize			% Info, ingredients, and instructions font size
\basefontskipsize	% Normally about 1.2\basefontsize. Controls line spacing.
\recipetitlefontsize	% Font size for recipe titles, not the title-page title.
\instrnumsize			% Font size for the instruction numbers
\recipeheadfontsize		% Font size for headings using \recipesection{}.

%====Required Latex Packages=================================================%
ragged2e		% Left-aligns document instead of default justified, which leaves
						% large gaps in 2-column mode.
amsmath,amsfonts,amssymb	% Use for \square symbol, etc.
xparse			% Allows for multiple optional arguments in new environments
						% and other convenient class features
wrapfig			% Used for numbering instruction steps
graphicx		% Used to include pictures
eso-pic			% Used for transparent images
anyfontsize	% Provides arbitrary font sizes
scrextend		% Used with anyfontsize
multirow, multicol		% Join cells in tabular (used in \group)
nicefrac		% Nicer fraction format for inline fractions
xcolor			% Colored text
gensymb			% Provides degree symbol with \degree.
booktabs		% Provies a nice table line with \toprule
tabularx		% Required for ingredients and info environments
calc				% Provides \widthof for automatically adjusting width of 
						% the number box in \step{}
picture			% Used for absolute page dimensions with put{}.
parskip			% Custom spacing options
tgtermes		% Default font package
fontenc			% Required for controlling the font, somehow
datetime		% Used to generate the compile date on the title page
fancyhdr		% Used to control header and footer content
tikz				% Used for more complicated image control like fuzzy edges.
tocloft			% Used for more control over the table of contents (ToC).
hypperref		% Used for hyperlinked ToC and page numbers.
geometry		% Sets page geometry.
environ			% Used for more advanced environment definitions
tcolorbox		% Used for faded boxes in ingredients* environment

%====Known bugs / features===================================================%
Images with transparency won't work on the last page of the document.  The
workaround is to place a \clearpage command before \end{document}

\author must be redefined for every page or it will carry over to the following
recipes.

Download the contents of this package in one zip archive (1.6M).

recipebook – Typeset 5.5" x 8" recipes for browsing or printing

This is a class for typesetting recipes. It is designed for typesetting one or two recipes per page, with dimensions of 5.5" x 8.5".

The hyperlinked table of contents (ToC) and page numbers make browsing recipes convenient, and the pages can be joined together or printed two per sheet to normal letterpaper easily.

The size was chosen to work in half-page 3-ring binder cover sheets.

Packagerecipebook
Version 2015-02-13
LicensesThe Project Public License 1.3
MaintainerBrad Granger
Contained inTeX Live as recipebook
MiKTeX as recipebook
TopicsCooking
Class
See alsorecipecard
recipe
...
Guest Book Sitemap Contact Contact Author