Ostatnia aktualizacja: 2026-11-09
Pytanie, jak napisać przepis, który da się ugotować wprost z kartki, ma jedną odpowiedź u podstaw: każda taka receptura dzieli tę samą strukturę. Tytuł, który mówi, co to za danie i ile go wychodzi; lista składników, w której każda linijka niesie ilość, jednostkę i sam składnik; potem uporządkowane kroki, po jednej czynności na raz, z czasami tam, gdzie czas ma znaczenie. To jest standardowy format, i jednocześnie kształt, którego oczekują aplikacje do przepisów, parsery i wyszukiwarki. Ten przewodnik przechodzi przez format linijka po linijce, daje szkielet do skopiowania i pokazuje, co parser czyta z tego, co napisałeś, tak że przepis napisany dla człowieka staje się danymi ustrukturyzowanymi bez przepisywania czegokolwiek.
Skopiuj ten szkielet i wypełnij nawiasy. Wszystko, czego potrzebuje dobry przepis, to opisana linijka:
<Nazwa dania> — dla <liczby> porcji
Składniki
- <ilość> <jednostka> <składnik>, <przygotowanie, np. posiekany>
- <ilość> <jednostka> <składnik>
Przygotowanie
1. <jedna czynność>, <czas, jeśli krok go ma>
2. <kolejna czynność>, nawiązująca do poprzedniej
...
Uwagi
- <to, co powiedziałbyś przyjacielowi: zamienniki, przechowywanie,
ostrzeżenia>
Trzy konwencje robią największą część pracy. Ilości i jednostki stoją na początku linijki składnika, oddzielone od samego składnika, więc „2 szklanki mąki" bije „mąka, 2 szklanki", a obie biją „trochę mąki". Kucharz czyta listę od ilości, więc liczba na starcie pozwala sięgnąć po garnek i wagę, zanim doczytasz koniec linijki. Przygotowanie trafia za składnik, po przecinku: „1 cebula, drobno posiekana". I kroki pozostają pojedyncze: jedna czynność na numerowany krok, bo krok, który mówi „posiekaj cebulę, a potem zacznij sos", rozpada się na kartce na dwa i gubi każdego, kto dołącza w połowie gotowania.
Te same konwencje, które pomagają człowiekowi, pomagają parserowi. Parser czyta przepis w poszukiwaniu ilości, jednostek, nazw składników i czasów, a im czystsze one stoją, tym więcej trafia przy pierwszym przebiegu. Oto, w co zamieniają się typowe linijki:
| Napisałeś | Parser czyta | Powstaje |
|---|---|---|
| 2 szklanki mąki | ilość 2, jednostka szklanki, składnik mąka | linijka składnika z ustrukturyzowaną ilością |
| Sól do smaku | składnik sól, bez stałej ilości | linijka składnika, ilość pozostaje otwarta |
| 1 cebula, drobno posiekana | składnik cebula, przygotowanie posiekana | linijka składnika z notatką o przygotowaniu |
| Duś przez 20 minut | czynność plus czas trwania | krok z dołączonym minutnikiem na 20 minut |
| Piecz w 180°C do złocistego koloru | czynność, temperatura, sygnał gotowości | krok z temperaturą pozostawioną na miejscu |
| Akapit o twojej babci | proza, nie linijka przepisu | zignorowany albo źle przypisany — trzymaj historie poza treścią przepisu |
Ostatni wiersz to najczęstsze potknięcie. Historie należą do notatki albo do osobnego wpisu; wewnątrz listy składników czy kroków nie dają parserowi ani kucharzowi niczego, na czym można się oprzeć.
Jeśli przepis jest już napisany, w dowolnym formacie, nie musisz go przepisywać, żeby dostać strukturę. momoChef importuje przepis z adresu URL, z wpisu społecznościowego, ze zdjęcia albo z tekstu wklejonego ręcznie i rozbiera go na pola z góry: składniki z ilościami, kroki z czasami, wartości odżywcze tam, gdzie ma je źródło. Przy imporcie z adresu URL momoChef zostawia źródło zapisane razem z przepisem, więc zawsze wiadomo, skąd przepis pochodzi. Jeśli przepis mieszka na stronie internetowej, rozszerzenie przeglądarki zapisze go bez kopiowania i wklejania. Podgląd po parsowaniu jest edytowalny, zanim cokolwiek zostanie zapisane, i właśnie tam poprawiasz linijki, które się liczą; przepis pozostaje edytowalny też po zapisaniu, więc import to pierwszy szkic, a nie wyrok. Jest też publiczne demo na momochef.com/try, które parsuje tekst na żywo w przeglądarce, bez konta — przydatne, gdy chcesz zobaczyć, jak jeden z twoich własnych przepisów rozpada się na części, zanim gdziekolwiek go zaimportujesz.
Przepisy odręczne importuje się jako zdjęcia. Import ze zdjęcia jest częścią Premium, $0.99 miesięcznie albo $9.99 rocznie, i czyta kartkę tak samo: tekst na wyjściu, ustrukturyzowany przepis na wejściu, edytowalny podgląd przed zapisaniem. Pismo odręczne bywa różne, więc czytaj podgląd obok kartki, zwłaszcza przy ilościach, bo rozmazane „1" i „7" różnią się jednym uderzeniem pióra. W razie wątpliwości przepisz niepewne liczby do podglądu ręcznie — podgląd jest edytowalny dokładnie po to. Kartka sama zostaje tam, gdzie mieszka; sens importu polega na tym, że przepis przestaje zależeć od papieru, a wydrukowana kopia może wrócić na lodówkę na jej miejsce.
Czy ten format działa dla każdego rodzaju przepisu? Tak, z dozą zdrowego rozsądku. Zupa chce uporządkowanych kroków z czasami; schemat ciastek może chcieć kroków pogrupowanych według części (ciasto, nadzienie, składanie). Zachowaj szkielet i zegnij środek: części to tytuł, wydajność, linijki składników, uporządkowane kroki, uwagi.
Czy parser wymaga dokładnej gramatyki, żeby działał? Nie. Parsery radzą sobie z luźnym sformułowaniem; potrzebują ilości, jednostki i składnika blisko siebie na linijce składnika oraz kroków w kolejności. „2 szklanki mąki" i „mąka, 2 szklanki" parsują się oba; „trochę" nie niesie żadnej ilości.
A co z miarami metrycznymi? Każdy system, zapisany tak samo: najpierw ilość, potem jednostka, na końcu składnik. Trzymaj się jednego systemu na przepis, bo mieszane jednostki na jednej liście to problem dla kucharzy, zanim staną się problemem dla parserów.
Dlaczego moje parsowanie coś pominęło? Parsery czytają wzorce, a niektóre przepisy się im opierają: ilości zakopane w sposobie przygotowania, nietypowe jednostki, kroki, które zlewają się w jedno. Popraw to w edytowalnym podglądzie, a poprawka wraca do parsera — dlatego importy z czasem radzą sobie coraz lepiej właśnie z twoimi przepisami.
Czy importowanie cudzego przepisu jest w porządku? Import zapisuje przepis w twojej własnej bibliotece, żebyś mógł z niego gotować, z zachowanym źródłem, więc od razu widać, skąd przepis pochodzi. Opublikowanie czy przedstawienie cudzego przepisu jako własnego to zupełnie inna sprawa — i coś, czego import nie robi.
Zacznij od małego: weź przepis, który napisałeś, albo kartkę, którą ktoś ci dał, wklej go do demo na momochef.com/try i patrz, jak rozpada się na składniki i kroki. momoChef jest darmowy na start i działa w aplikacji webowej albo w aplikacji na iOS.