Recipe
import YoastSchemaExample from '../../../../src/components/YoastSchemaExample';
描述一个 Recipe（菜谱），它包含一系列步骤说明、食材和可选字段。
触发条件
当页面内容描述一个菜谱时，应将其作为图谱中的顶级节点添加。
必需属性
一个有效的 Recipe 必须包含以下属性。
@type:Recipe。@id: 网站的首页 URL 后追加#/schema/Recipe/{{ID}}，其中{{ID}}是一个唯一标识符。name: 描述食谱的字符串。image: 代表成品食谱的图像，通过 ID 引用。recipeIngredient: 一个字符串数组，代表每种成分及其数量（例如，"3 apples"）。recipeInstructions: 一个HowToStep对象数组，包含以下属性：@type:HowToStep。@id: 页面未修改的 规范 URL，后追加#/schema/HowToStep/{{ID}}，其中{{ID}}是一个唯一标识符。url: 指向单个步骤的片段标识符（'ID 锚点'）的链接（例如，https://www.example.com/example-page/#recipe-step-5）。text: 说明字符串（例如，"Bake at 200*C for 40 minutes, or until golden-brown, stirring periodically throughout"）。name（可选）：步骤的简短摘要（例如，"Bake"）。image（可选）：代表步骤的图像，通过 ID 引用。
故障场景
如果 Recipe 的任何必填字段缺失或无效，则不应输出该节点。
如果某个节点未被输出，则任何原本会声明与其存在关系的实体都应移除这些引用。
可选属性
以下属性在可用且有效时应添加：
description：描述食谱的字符串。cookTime：烹饪时间，采用 ISO 8601 格式。prepTime：准备食谱所需的时间。nutrition：一个NutritionInformation节点，包含一个calories属性，该属性将卡路里计数定义为字符串（例如，"270 calories"）。recipeYield：食谱制作的份数（_不是_单个物品的数量，如果两者不同），作为字符串（例如，"6"，而不是6）。tools：表示食谱所需工具的字符串数组。keywords：描述食谱的关键词数组。recipeCuisine：描述菜系类型的字符串（例如，"American" 或 "Spanish"）。recipeCategory：食谱的类别，从以下选项中选择：'开胃菜'、'早餐'、'早午餐'、'甜点'、'晚餐'、'饮品'、'午餐'、'主菜'、'酱汁'、'配菜'、'小吃'、'前菜'。suitableForDiet：一个RestrictedDiet节点，其值（或值数组）从以下选项中选择：'糖尿病饮食'、'无麸质饮食'、'清真饮食'、'印度教饮食'、'犹太洁食饮食'、'低卡路里饮食'、'低脂饮食'、'低乳糖饮食'、'低盐饮食'、'纯素饮食'、'素食饮食'。video：通过 ID 引用代表食谱说明的视频。inLanguage：指南的语言代码；例如，en-GB。datePublished：食谱添加的日期，采用 ISO 8601 格式。
条件属性
当菜谱是页面的“主要实体”时
mainEntityOfPage: 通过 ID 引用WebPage。
当仅指定 cookTime 或 prepTime 之一时
- 将相关属性更改为
totalTime。
当同时指定 cookTime 和 prepTime 时
totalTime：cookTime与prepTime之和，采用 ISO 8601 持续时间格式。
当页面包含有效的 Article 时
- 将
mainEntityOfPage属性更改为通过 ID 引用Article（而非WebPage）。
当 Article 有 Author 时
Examples
Minimum criteria
{`{ "@context": "https://schema.org", "@graph": [ { "@type": "Recipe", "mainEntityOfPage": { "@id": "https://www.example.com/#/schema/Article/abc123" }, "name": "Party Coffee Cake", "image": { "@id": "https://www.example.com/uploads/example-image.jpg" }, "recipeIngredient": [ "2 cups of flour", "3/4 cup white sugar", "2 teaspoons baking powder", "1/2 teaspoon salt", "1/2 cup butter", "2 eggs", "3/4 cup milk" ], "recipeInstructions": [ { "@type": "HowToStep", "text": "Preheat the oven to 350 degrees F. Grease and flour a 9x9 inch pan.", "url": "https://example.com/example-page/#recipe-step-1" }, { "@type": "HowToStep", "text": "In a large bowl, combine flour, sugar, baking powder, and salt.", "url": "https://example.com/example-page/#recipe-step-2" }, { "@type": "HowToStep", "text": "Mix in the butter, eggs, and milk.", "url": "https://example.com/example-page/#recipe-step-3" }, { "@type": "HowToStep", "text": "Spread into the prepared pan.", "url": "https://example.com/example-page/#recipe-step-4" }, { "@type": "HowToStep", "name": "Bake", "url": "https://example.com/example-page/#recipe-step-5" }, { "@type": "HowToStep", "text": "Allow to cool and enjoy.", "url": "https://example.com/example-page/#recipe-step-6" } ] } ] }`}扩展标准
{`{ "@context": "https://schema.org", "@graph": [ { "@type": "Recipe", "mainEntityOfPage": { "@id": "https://www.example.com/#/schema/Article/abc123" }, "name": "Party Coffee Cake", "image": { "@id": "https://www.example.com/uploads/example-image.jpg" }, "video": { "@id": "https://www.example.com/#/schema/VideoObject/abc123" }, "author": { "@id": "https://www.example.com/#/schema/Person/abc123" }, "inLanguage": "en-GB", "datePublished": "2018-03-10", "description": "This coffee cake is awesome and perfect for parties.", "prepTime": "PT20M", "cookTime": "PT30M", "totalTime": "PT50M", "keywords": "cake for a party, coffee", "recipeYield": "10", "recipeCategory": "Dessert", "recipeCuisine": "American", "suitableForDiet": [ "VegetarianDiet", "LowSaltDiet" ], "tools": [ "A 9x9 inch pan", "A large mixing bowl" ], "nutrition": { "@type": "NutritionInformation", "calories": "270 calories" }, "recipeIngredient": [ "2 cups of flour", "3/4 cup white sugar", "2 teaspoons baking powder", "1/2 teaspoon salt", "1/2 cup butter", "2 eggs", "3/4 cup milk" ], "recipeInstructions": [ { "@type": "HowToStep", "name": "Preheat", "text": "Preheat the oven to 350 degrees F. Grease and flour a 9x9 inch pan.", "url": "https://example.com/example-page/test/#recipe-step-1", "image": { "@id": "https://www.example.com/uploads/example-image-2.jpg" } }, { "@type": "HowToStep", "name": "Mix dry ingredients", "text": "In a large bowl, combine flour, sugar, baking powder, and salt.", "url": "https://example.com/example-page/test/#recipe-step-2", "image": { "@id": "https://www.example.com/uploads/example-image-3.jpg" } }, { "@type": "HowToStep", "name": "Add wet ingredients", "text": "Mix in the butter, eggs, and milk.", "url": "https://example.com/example-page/test/#recipe-step-3", "image": { "@id": "https://www.example.com/uploads/example-image-4.jpg" } }, { "@type": "HowToStep", "name": "Spread into pan", "text": "Spread into the prepared pan.", "url": "https://example.com/example-page/test/#recipe-step-4", "image": { "@id": "https://www.example.com/uploads/example-image-5.jpg" } }, { "@type": "HowToStep", "name": "Bake", "text": "Bake for 30 to 35 minutes, or until firm.", "url": "https://example.com/example-page/test/#recipe-step-5", "image": { "@id": "https://www.example.com/uploads/example-image-6.jpg" } }, { "@type": "HowToStep", "name": "Enjoy", "text": "Allow to cool and enjoy.", "url": "https://example.com/example-page/test/#recipe-step-6", "image": { "@id": "https://www.example.com/uploads/example-image-7.jpg" } } ] } ] }`}
这篇文档对你有帮助吗？
谢谢你的反馈！