Zacznij od przepisu widocznego na stronie
Dane uporządkowane typu Recipe opisują przepis, który użytkownik może przeczytać na stronie. Nie zastępują listy składników ani instrukcji gotowania. Zanim dodasz oznaczenie, upewnij się, że treść zawiera nazwę potrawy, potrzebne produkty i zrozumiały sposób przygotowania. Jeśli na podstronie znajduje się kilka pełnych przepisów, nie oznaczaj ich tak, jakby były jednym daniem.
Do wdrożenia często wybiera się JSON-LD, czyli blok danych umieszczany w kodzie strony. Obiekt przepisu otrzymuje wartość Recipe we właściwości @type oraz nazwę we właściwości name. Wartości w danych powinny odpowiadać temu, co widzi czytelnik. Oznaczenie nie jest miejscem na dopisywanie składników, etapów czy czasu, których nie ma w treści. Samo dodanie Recipe nie gwarantuje też określonego wyglądu wyniku wyszukiwania.
Składniki zapisuj jako osobne pozycje
Do listy produktów służy właściwość recipeIngredient. Każdy składnik powinien być osobnym elementem listy, najlepiej z ilością i jednostką, jeśli podano je w przepisie. Dla prostego sosu mogłyby to być na przykład pozycje „2 pomidory”, „1 łyżka oliwy” i „szczypta soli”. Nie łącz całej listy w jeden długi tekst ani nie wpisuj w tym polu czynności takich jak krojenie czy mieszanie.
Zachowaj zgodność z wersją wyświetlaną użytkownikowi. Jeżeli strona podaje „1 łyżka oliwy”, oznaczenie nie powinno podawać „100 ml oliwy”. Gdy serwis pozwala zmieniać liczbę porcji, sprawdź, czy ilości w danych uporządkowanych odpowiadają składnikom wyświetlanym po załadowaniu strony. Rozbieżności łatwo przeoczyć zwłaszcza wtedy, gdy lista składników w kodzie jest aktualizowana niezależnie od treści przepisu.
Czas przygotowania podawaj precyzyjnie
Recipe pozwala rozdzielić czas przygotowania, czas gotowania i czas całkowity. Służą do tego odpowiednio prepTime, cookTime i totalTime. Pierwsze pole opisuje czynności przygotowawcze, takie jak mycie i krojenie; drugie może obejmować obróbkę potrawy, na przykład pieczenie. Czas całkowity powinien być spójny z opisem przepisu. Nie wypełniaj pól szacunkami tylko dlatego, że są dostępne.
Czas zapisuje się w formacie czasu trwania ISO 8601. Przykładowo PT15M oznacza 15 minut, PT1H oznacza godzinę, a PT1H30M — godzinę i 30 minut. Jeśli przepis mówi „przygotowanie: 15 minut, pieczenie: 30 minut”, odpowiednie wartości to prepTime: PT15M i cookTime: PT30M. Wartość totalTime: PT45M będzie miała sens, o ile przepis nie wymaga dodatkowego oczekiwania. Gdy ciasto musi jeszcze chłodzić się przez godzinę, uwzględnij ten etap w opisie i ostrożnie ustal czas całkowity.
Instrukcję podziel na czytelne kroki
Sposób wykonania opisuje właściwość recipeInstructions. Praktycznym rozwiązaniem jest lista kolejnych obiektów HowToStep, z których każdy zawiera tekst jednej czynności lub krótkiego etapu. Przykładowa sekwencja dla sosu to: „Pokrój pomidory”, „Podgrzej oliwę na patelni” oraz „Dodaj pomidory i duś przez 10 minut”. Zachowaj kolejność zgodną z instrukcją na stronie i nie pomijaj etapów potrzebnych do wykonania dania.
Jeśli przepis ma wyraźne części, na przykład przygotowanie ciasta i nadzienia, można rozważyć pogrupowanie kroków w sekcje. Nie komplikuj jednak struktury bez potrzeby: dla krótkiego przepisu prosta lista HowToStep jest łatwiejsza do utrzymania. Wskazówki niezwiązane z wykonaniem, takie jak propozycje podania, można pozostawić w zwykłej treści strony, zamiast sztucznie zamieniać je w obowiązkowe kroki.
Sprawdź zgodność danych z treścią
Po wdrożeniu otwórz stronę tak, jak zrobiłby to czytelnik, i porównaj ją z oznaczeniem Recipe. Skontroluj nazwę potrawy, liczbę i brzmienie składników, czasy oraz kolejność instrukcji. Jeśli na stronie jest zdjęcie dania, sprawdź również, czy użyte w danych pole image wskazuje właściwy obraz. Przydatny jest test obsługi danych uporządkowanych przez wyszukiwarkę oraz walidator składni: pomagają znaleźć błędy zapisu, choć nie zastępują oceny zgodności z treścią.
Krótka lista kontrolna na koniec: czy każda pozycja recipeIngredient odpowiada widocznemu składnikowi; czy prepTime, cookTime i totalTime opisują właściwe etapy; czy kroki recipeInstructions są kompletne i uporządkowane; czy oznaczenie aktualizuje się po zmianie przepisu? W serwisie z wieloma przepisami warto sprawdzić kilka różnych szablonów stron, nie tylko jeden przykład. Dzięki temu łatwiej wykryć błąd, który powtarza się w całej witrynie.
