recipe

From IndieWeb


A recipe is special kind of post, that typically has a name, like an articles, a list of ingredients, and a list of instructions for making something, usually food or drink.

Why

Consider posting recipes for food or drink that you personally enjoy making & consuming, especially recipes you come up, so others may also enjoy making & consuming said food or drink.

How

How to publish

In your recipe, provide a short summary description, and then a clear minimal list of ingredients and brief list of instructions, for easy reference for someone following the recipe.

Additionally, consider describing variants youโ€™ve tried or made, and how you personally relate to the recipe.

How to mark up

Mark up your recipe posts with h-recipe.

  • If your recipe has a name use "p-name" for it.

Consider marking up your recipe also with the classic hRecipe since a few consuming applications (like Paprika) and services (like Google Recipe Search) still use it.

DO NOT enclose it in an h-entry - there is no need to do so.

If you want to separately post a note about creating or using the recipe on a particular day, then that makes sense as a separate h-entry post that would/could then link to the recipe on its own permalink.

IndieWeb Examples

Marked up as h-recipe.

Shane Becker

Shane Becker had posted at least one recipe on his site as an article, since 2005-03-30.

Eli Duke

Eli Duke has been publishing recipes marked up as h-recipe since 2014-04-22 (git repo for the previous code base of his site, new code base is in a private repo).

Details:

  • h-recipe markup only (no enclosing h-entry)

Aaron Parecki

Aaron Parecki had been informally posting recipes as notes since 2014-01-27 but none of them included any explicit h-recipe markup. As of 2017-01-22 they have been converted to h-recipe markup!

Details:

gRegor Morrill

gRegor Morrill has posted recipes as of 2017-04-14

Details:

  • h-recipe markup only (no enclosing h-entry)

Jonathan LaCour

Jonathan LaCour has been publishing recipes on his site since 2015-08-14, marked up with mf2 as h-recipe. Jonathan created the plugin for publishing h-recipes for Known.

Anthony Ciccarello

Anthony Ciccarello Has a section for recipes he's made since 2021-01-12. Currently marked up as both h-recipe and hRecipe due to more widespread support, especially with search engines. Looking at usability improvements like grouping by meal, sorting by time, possibly supporting cooklang for recipe writing.

capjamesg

capjamesg has published coffee recipes marked up with h-recipe microformats on coffeerecipes.co, a coffee recipe site he runs, and on his personal website. Personal website example:

hRecipe Examples

Examples of recipe posts with only classic hRecipe markup.

Chris Aldrich

Chris Aldrich has been publishing recipes marked up with mf1 as hrecipe since 7/4/15 and mf2 as h-recipe since 7-20-16. Incidentally as of July 2016, WordPress (via JetPack) supports a recipe shortcode which automatically adds sparse mf1 markup. Chris hopes to encourage them to additionally add mf2 markup as well. Those who'd like the modified JetPack code can find it here.

Prototype Examples

These are examples of recipes as content being posted as other post types to the IndieWeb, but not marked up as h-recipe or hRecipe.

Kyle Mahan

Kyle Mahan has a secondary personal site where he posts recipes:

Past Examples

  • ...

Silo Examples

Pinterest

Pinterest has supported parsing h-recipe to provide "rich pins" for recipes for quite some time (many years).

Perfect Company

The Perfect Company website publishes their recipes with h-recipe markup. Examples:

@cookbook

Maureen Evans has been posting recipes on twitter at @cookbook in a text picoformat.

Her abbreviations were previously documented in a Google Sheet embedded on a wiki but as of 2023-08-11, the spreadsheet appears to have been deleted. It could not be retrieved from the archived page either. If you have access to these abbreviations, please help update this section as they could be expanded to h-recipe.

Applications

Paprika

The Paprika Recipe Manager application parses classic hRecipe from the web.

Google Search

Google search recognizes hRecipe results, but requires schema.org markup to support "Guided Recipes" with Google Assistant

Issues

Extraneous content

Perhaps the top complaint about online recipes is the presence and length of content or ads on a recipe page that is beyond the ingredients, instructions, and other directly related information for a recipe.

There are quite a few openly posted complaints both about the common and heavy presence of such extraneous content, defense thereof by recipe authors and publishers, and some amount of contentious (social media drama) debate or exchanges of frustration between the two.

To-do:

  • incorporate extraneous content complaints / defense from the See Also section

Brainstorming

Plain text recipe formats

For possible consideration in a plain text recipe in a post.

See Also