8 ms·

Cooklang – Managing Recipes in Git

119 points by bribri 5y ago

philips 5y ago
I would use this on my website if it had Jekyll integration. Relatedly https://grimgrains.com https://grimgrains.com is an open source recipe website that uses C for its “markup”. https://github.com/hundredrabbits/Grimgrains/blob/master/src/recipes.c https://github.com/hundredrabbits/Grimgrains/blob/master/src...
- bribri 5y ago
  It was pretty straightforward to make it work with eleventy. Just had to import the cooklang parser. https://github.com/briansunter/site/blob/master/eleventy.config.js#L130 https://github.com/briansunter/site/blob/master/eleventy.con...
omaranto 5y ago
I'd remove the % sign from the syntax for ingredients.
- arjvik 5y ago
  Agreed, splitting on " " isn't that difficult
- est 5y ago
  And how does the ingredients scale? Surely cooking for 1 person vs 4 person requires different amount of ingredients.
  - omaranto 5y ago
    The % in this syntax is not to indicate information about scaling, it is just a meaningless separator: "3%tsp". I'd say both "3tsp" or "3 tsp" look better.
    - mkdirp 5y ago
      The author didn't go with a space because[0] some things have spaces in them, which would be harder to figure out. [0] https://news.ycombinator.com/item?id=28999634 https://news.ycombinator.com/item?id=28999634
      - omaranto 5y ago
        That is highly unconvincing! Isn't the quantity a number? Have the syntax be @<ingredient>{<number> <units>}, where the units may contain spaces but not braces. You can even make the space between quantity and units optional.
peterfield 5y ago
I followed the recipe to the letter. I've flipped the steak a few times already and I'm still waiting for it to brown. The butter is not melted either. Not really surprising considering the pan is cold :( Even with a hot pan, I would have put the butter first, not after the steak.
- newman314 5y ago
  You want to wait until the skillet is ripping hot before you drop the steak in. I usually wait until I'm ready to finish cooking before dropping the butter in. Butter burns quickly so you do not want the butter in there for a long period of time.
  - peterfield 5y ago
    THX mate - my comment was just a attempt at a funny critic LOL. I actually grew up in a restaurant in France :)
  - picardythird 5y ago
    One thing I heard and have had great results with is pre-melting the butter and skimming off the solids
    - bribri 5y ago
      I’ve been using ghee which works really well for high heat searing
    - peterfield 5y ago
      Yep. It also boils out the 15-20% water content of butter to make it closer to 100% fat. Once you remove these (water + proteins and other impurities) the smoke point is much higher and it is much healthier for hot cooking. It is called "ghee" when done at medium high temp, which gives it a slightly darker colour and nuttier taste (Indian way I think), and just called "clarified butter" when done at low temp. Other advantage when done properly -> it does not go "off" anymore and does not need to be kept in the fridge, so you have this much easier/softer substance that you can spoon out of a jar. You can even use it for deep frying - honestly the best fat for it.
JonathanBuchh 5y ago
I just wanted to shout out Cooking For Engineers even though it’s only moderately related. Its format for recipes is so quick to read. I would love to see CookLang integrate this style of recipe viewing. http://www.cookingforengineers.com/recipe/108/Banana-Nut-Bread/trn http://www.cookingforengineers.com/recipe/108/Banana-Nut-Bre...
- bribri 5y ago
  It would be great to generate diagrams. Seems like cooklang would need something extra to define dependent/parallel steps.
- CSMastermind 5y ago
  I prefer the Modernist Cuisine Format: http://modernistcuisine.com/wp-content/uploads/2014/06/Colonels-Fried-Chicken-recipe.jpg http://modernistcuisine.com/wp-content/uploads/2014/06/Colon... It's the best I've seen for being able to easily follow along. I also really appreciate their diligence with scaling factors since that tends to be a huge pain point for me with other recipes.
  - bribri 5y ago
    It definitely seems like it would be possible to generate something like this in cooklang, as long as you specified everything in grams.
  - teruakohatu 5y ago
    But specifying everything in grams looks like a practical nightmare for normal home cooks. 0.1g of a spice? Verses 1/4 teaspoon?
    - 2muchcoffeeman 5y ago
      You're always free to take an accurate recipe and make it less accurate. You can't go the other way round.
    - Mikeb85 5y ago
chrysoprace 5y ago
I looked into making a recipe site for my girlfriend from scratch a few years ago (I'm well aware I could've used an off-the-shelf Wordpress plugin or similar, but I wanted to learn) and I was surprised to find that there's no real consensus on recipe formats. I dream of a universal format that would allow you to take any recipe and convert between unit systems, and change the portion sizes at will. I suspect one of the reasons for the lack of adoption of such a standard is that copyright law (at least in Australia), makes this impractical. Cooklang looks interesting, but it has the same problem as a physical lined cookbook - I have to rewrite the recipes myself instead of being able to simply copy and convert.
- nobodywasishere 5y ago
  There is a recipe schema[1] that the Nextcloud app Cookbook[2] uses for adding recipes just by pasting a URL. Not every website supports this though. [1]: https://schema.org/Recipe https://schema.org/Recipe [2]: https://github.com/nextcloud/cookbook/ https://github.com/nextcloud/cookbook/
dcchambers 5y ago
This is my first time encountering Cooklang and the concept is really neat, but wow the language syntax is...interesting. My first thought was how this would be useful for easily including recipe scaling up/down on a website, and it appears that Cooklang has support for that...(or it's still a WIP: https://cooklang.org/docs/roadmap/ https://cooklang.org/docs/roadmap/)
PradeetPatel 5y ago
Sorry if this comes off as a noob question, I'm not a technical person but came from a marketing background. Generally what is the monetisation model for founders developing languages like Cooklang? Would they sell support for the language, or create an ecosystem around it?
- neetle 5y ago
  Not everything needs a financial incentive
  - yuroFlash 5y ago
    Fireship: The Dark Side of Open Source / What really happened to Faker.js? https://youtu.be/R6S-b_k-ZKY https://youtu.be/R6S-b_k-ZKY
    - seanw444 5y ago
      Some people have hobby projects they really don't want anything other than donations for. Sometimes they don't even want donations. Money brings responsibility, and responsibility kills the fun. Donations will begin to feel like you owe the donators your time, even though you do not. But it's hard to break out of that mindset. Especially once you start getting negative remarks for not implementing enough features, despite the donations.
    - neetle 5y ago
      This feels like a non sequitur. Their project being open source or not doesn't protect their mental health spiralling. This could have happened to a paid lib, and you'd be out of luck due to vendor lock rather than just picking a fork.
- bribri 5y ago
  The author does offer a paid app which lets you build shopping lists and view recipes, so there are some options for monetization.
- roel_v 5y ago
woile 5y ago
I started working on a website to store cooklang recipes, what I miss is the possibility to link other recipes as ingredients, I wonder if it would be possible
est 5y ago
> Ingredients @ingredient{quantity%unit} for example @butter{30%g} > and preheat the skillet until it reaches 450 degrees. 450 °C or °F ? Or should we write {450%°C} ? This looks weird.
- briansbum 5y ago
  In my recipes I write `%C` or `%F`, the `°` isn't really necessary I find.
Kiala 5y ago
This reminds me of my university prof who wrote some recipes in Haskell [1]. [1]: https://github.com/djoerd/fokkingcook/blob/master/SalmonPasta.hs https://github.com/djoerd/fokkingcook/blob/master/SalmonPast...
livinglist 5y ago
I was having similar idea just couple of days ago! this is awesome, hopefully have a good community based apps in the future built around this like Anki
helpfulmandrill 5y ago
I love the idea. But its so difficult to know if its worth investing in using the format or if it will end up languishing.
andrewshadura 5y ago
An alternative to this is Chowdown and YAML: https://github.com/clarklab/chowdown https://github.com/clarklab/chowdown Or GoChowdown and YAML: https://github.com/seanlane/gochowdown https://github.com/seanlane/gochowdown
TabTwo 5y ago
Remember when we shared recipes on the Usenet with the Meal-Master format?
asmega 5y ago
Shameless plug for my recipes side project I re-released a few days ago https://www.recilution.com https://www.recilution.com on fly.io. Still lots to do. I actually looked at this along with git backed recipes as repositories. I can see it useful for personal sites or exchanging with people if there is client involved as it's quite portable. You could do versions, diffs, timelines all sorts. However it's rather esoteric (I guess everything on Hacker News is!?) and don't think it applies to the masses. Despite recipes being very simple as a list of ingredients and things to do there is actually lot things you can slice things to try to make things easier whether thats viewing the recipe or editing. For me the challenge I find is finding recipes and then refining them in such a way they are turn out the way I want them without having to read pages of introductory text you find in most recipe blog sites
almog 5y ago
Seems to me that it's about Cooklang, not about git. Nevertheless it looks neat! For bread and baking in general, it might be useful to have it support Baker Percentage[1], either explicitly or by using specific tags for scaling dry and wet ingredients. [1] https://en.wikipedia.org/wiki/Baker_percentage https://en.wikipedia.org/wiki/Baker_percentage
isitmadeofglass 5y ago
> Recipe sites have gotten so bloated that you need to read someone's entire life story to get the ingredients and steps. This is a hellish IP “hack”. They can’t copyright the recipe, but adding a story about how your cat always meuws when your cooking pasta turns it into a copyrightable story. That’s why they do it. It’s horrible and I hate it.

119 points by bribri 5y ago

I would use this on my website if it had Jekyll integration. Relatedly https://grimgrains.com https://grimgrains.com is an open source recipe website that uses C for its “markup”. https://github.com/hundredrabbits/Grimgrains/blob/master/src/recipes.c https://github.com/hundredrabbits/Grimgrains/blob/master/src...

bribri 5y ago
It was pretty straightforward to make it work with eleventy. Just had to import the cooklang parser. https://github.com/briansunter/site/blob/master/eleventy.config.js#L130 https://github.com/briansunter/site/blob/master/eleventy.con...

omaranto 5y ago

I'd remove the % sign from the syntax for ingredients.

arjvik 5y ago
Agreed, splitting on " " isn't that difficult
est 5y ago
And how does the ingredients scale? Surely cooking for 1 person vs 4 person requires different amount of ingredients.
- omaranto 5y ago
  The % in this syntax is not to indicate information about scaling, it is just a meaningless separator: "3%tsp". I'd say both "3tsp" or "3 tsp" look better.
  - mkdirp 5y ago
    The author didn't go with a space because[0] some things have spaces in them, which would be harder to figure out. [0] https://news.ycombinator.com/item?id=28999634 https://news.ycombinator.com/item?id=28999634
    - omaranto 5y ago
      That is highly unconvincing! Isn't the quantity a number? Have the syntax be @<ingredient>{<number> <units>}, where the units may contain spaces but not braces. You can even make the space between quantity and units optional.

peterfield 5y ago

I followed the recipe to the letter. I've flipped the steak a few times already and I'm still waiting for it to brown. The butter is not melted either. Not really surprising considering the pan is cold :( Even with a hot pan, I would have put the butter first, not after the steak.

newman314 5y ago
You want to wait until the skillet is ripping hot before you drop the steak in. I usually wait until I'm ready to finish cooking before dropping the butter in. Butter burns quickly so you do not want the butter in there for a long period of time.
- peterfield 5y ago
  THX mate - my comment was just a attempt at a funny critic LOL. I actually grew up in a restaurant in France :)
- picardythird 5y ago
  One thing I heard and have had great results with is pre-melting the butter and skimming off the solids
  - bribri 5y ago
    I’ve been using ghee which works really well for high heat searing
  - peterfield 5y ago
    Yep. It also boils out the 15-20% water content of butter to make it closer to 100% fat. Once you remove these (water + proteins and other impurities) the smoke point is much higher and it is much healthier for hot cooking. It is called "ghee" when done at medium high temp, which gives it a slightly darker colour and nuttier taste (Indian way I think), and just called "clarified butter" when done at low temp. Other advantage when done properly -> it does not go "off" anymore and does not need to be kept in the fridge, so you have this much easier/softer substance that you can spoon out of a jar. You can even use it for deep frying - honestly the best fat for it.

JonathanBuchh 5y ago

I just wanted to shout out Cooking For Engineers even though it’s only moderately related. Its format for recipes is so quick to read. I would love to see CookLang integrate this style of recipe viewing. http://www.cookingforengineers.com/recipe/108/Banana-Nut-Bread/trn http://www.cookingforengineers.com/recipe/108/Banana-Nut-Bre...

bribri 5y ago
It would be great to generate diagrams. Seems like cooklang would need something extra to define dependent/parallel steps.
CSMastermind 5y ago
I prefer the Modernist Cuisine Format: http://modernistcuisine.com/wp-content/uploads/2014/06/Colonels-Fried-Chicken-recipe.jpg http://modernistcuisine.com/wp-content/uploads/2014/06/Colon... It's the best I've seen for being able to easily follow along. I also really appreciate their diligence with scaling factors since that tends to be a huge pain point for me with other recipes.
- bribri 5y ago
  It definitely seems like it would be possible to generate something like this in cooklang, as long as you specified everything in grams.
- teruakohatu 5y ago
  But specifying everything in grams looks like a practical nightmare for normal home cooks. 0.1g of a spice? Verses 1/4 teaspoon?
  - 2muchcoffeeman 5y ago
    You're always free to take an accurate recipe and make it less accurate. You can't go the other way round.
  - Mikeb85 5y ago

chrysoprace 5y ago

I looked into making a recipe site for my girlfriend from scratch a few years ago (I'm well aware I could've used an off-the-shelf Wordpress plugin or similar, but I wanted to learn) and I was surprised to find that there's no real consensus on recipe formats. I dream of a universal format that would allow you to take any recipe and convert between unit systems, and change the portion sizes at will. I suspect one of the reasons for the lack of adoption of such a standard is that copyright law (at least in Australia), makes this impractical. Cooklang looks interesting, but it has the same problem as a physical lined cookbook - I have to rewrite the recipes myself instead of being able to simply copy and convert.

nobodywasishere 5y ago
There is a recipe schema[1] that the Nextcloud app Cookbook[2] uses for adding recipes just by pasting a URL. Not every website supports this though. [1]: https://schema.org/Recipe https://schema.org/Recipe [2]: https://github.com/nextcloud/cookbook/ https://github.com/nextcloud/cookbook/

dcchambers 5y ago

This is my first time encountering Cooklang and the concept is really neat, but wow the language syntax is...interesting. My first thought was how this would be useful for easily including recipe scaling up/down on a website, and it appears that Cooklang has support for that...(or it's still a WIP: https://cooklang.org/docs/roadmap/ https://cooklang.org/docs/roadmap/)

PradeetPatel 5y ago

Sorry if this comes off as a noob question, I'm not a technical person but came from a marketing background. Generally what is the monetisation model for founders developing languages like Cooklang? Would they sell support for the language, or create an ecosystem around it?

neetle 5y ago
Not everything needs a financial incentive
- yuroFlash 5y ago
  Fireship: The Dark Side of Open Source / What really happened to Faker.js? https://youtu.be/R6S-b_k-ZKY https://youtu.be/R6S-b_k-ZKY
  - seanw444 5y ago
    Some people have hobby projects they really don't want anything other than donations for. Sometimes they don't even want donations. Money brings responsibility, and responsibility kills the fun. Donations will begin to feel like you owe the donators your time, even though you do not. But it's hard to break out of that mindset. Especially once you start getting negative remarks for not implementing enough features, despite the donations.
  - neetle 5y ago
    This feels like a non sequitur. Their project being open source or not doesn't protect their mental health spiralling. This could have happened to a paid lib, and you'd be out of luck due to vendor lock rather than just picking a fork.
bribri 5y ago
The author does offer a paid app which lets you build shopping lists and view recipes, so there are some options for monetization.
roel_v 5y ago

woile 5y ago

I started working on a website to store cooklang recipes, what I miss is the possibility to link other recipes as ingredients, I wonder if it would be possible

est 5y ago

> Ingredients @ingredient{quantity%unit} for example @butter{30%g} > and preheat the skillet until it reaches 450 degrees. 450 °C or °F ? Or should we write {450%°C} ? This looks weird.

briansbum 5y ago
In my recipes I write `%C` or `%F`, the `°` isn't really necessary I find.

Kiala 5y ago

This reminds me of my university prof who wrote some recipes in Haskell [1]. [1]: https://github.com/djoerd/fokkingcook/blob/master/SalmonPasta.hs https://github.com/djoerd/fokkingcook/blob/master/SalmonPast...

livinglist 5y ago

I was having similar idea just couple of days ago! this is awesome, hopefully have a good community based apps in the future built around this like Anki

helpfulmandrill 5y ago

I love the idea. But its so difficult to know if its worth investing in using the format or if it will end up languishing.

andrewshadura 5y ago

An alternative to this is Chowdown and YAML: https://github.com/clarklab/chowdown https://github.com/clarklab/chowdown Or GoChowdown and YAML: https://github.com/seanlane/gochowdown https://github.com/seanlane/gochowdown

TabTwo 5y ago

Remember when we shared recipes on the Usenet with the Meal-Master format?

asmega 5y ago

Shameless plug for my recipes side project I re-released a few days ago https://www.recilution.com https://www.recilution.com on fly.io. Still lots to do. I actually looked at this along with git backed recipes as repositories. I can see it useful for personal sites or exchanging with people if there is client involved as it's quite portable. You could do versions, diffs, timelines all sorts. However it's rather esoteric (I guess everything on Hacker News is!?) and don't think it applies to the masses. Despite recipes being very simple as a list of ingredients and things to do there is actually lot things you can slice things to try to make things easier whether thats viewing the recipe or editing. For me the challenge I find is finding recipes and then refining them in such a way they are turn out the way I want them without having to read pages of introductory text you find in most recipe blog sites

almog 5y ago

Seems to me that it's about Cooklang, not about git. Nevertheless it looks neat! For bread and baking in general, it might be useful to have it support Baker Percentage[1], either explicitly or by using specific tags for scaling dry and wet ingredients. [1] https://en.wikipedia.org/wiki/Baker_percentage https://en.wikipedia.org/wiki/Baker_percentage

isitmadeofglass 5y ago

> Recipe sites have gotten so bloated that you need to read someone's entire life story to get the ingredients and steps. This is a hellish IP “hack”. They can’t copyright the recipe, but adding a story about how your cat always meuws when your cooking pasta turns it into a copyrightable story. That’s why they do it. It’s horrible and I hate it.