Yandex tarafından işlenen öğelerin özellikleri
Genel şartlar
Sitenizdeki yemek tarifi verilerinin Yandex tarafından çıkarılabilmesi için sitenin bir sayfasında sadece bir adet hrecipe
kök sınfı öğesi olarak belirlenen ve sayfanın ana içeriğini oluşturan yemek tarifi bulunmalıdır. Tarifin özelliklerini belirten diğer öğeler, anılan kök öğesinin içeriğini teşkil eder.
Yemek tarifindeki tüm veriler, bir kullanıcı tarafından görünecek şekilde sayfada tam olarak yansıtılmalıdır.
Yandex, hem formatın standart özelliklerini hem de kendi geliştirdiği eklentileri işler.
Zorunlu öğeler
Yemek tarifi verilerinin snippetler kalitesini iyileştirmek üzere Yandex tarafından kullanılabilmesi için aşağıda sıralanan zorunlu özellik öğelerinin aktarılması gerekir:
fn
Yemeğin veya yemek tarifinin ismi.
Bu özelliğin tek doğru değeri metindir.
Örnek:
<span class="fn">Bira soslu pilavlı tavuk</span>
ingredient
Yemekte kullanılan malzeme ve onun hacmi/miktarı.
Bir yemek tarifinde bir veya birden fazla malzeme kullanılabilir. Yemekte kullanılan malzeme türlerinin her biri ingredient
sınıfı olarak işaretlenmelidir. Bu özelliğin değeri olarak sade metin veya HTML kodu kullanılabilir.
Bu özellik ayrıca aşağıda sıralanan iç özellikleri de içerebilir:
-
name
: malzeme ismi (bu özellik hRecipe standardıyla öngörülmemektedir). -
type
vevalue
: kullanılan ölçüm birimi ve birimlerin sayısı. -
amount
: serbest formatta belirtilen miktar (bu özellik hRecipe standardıyla öngörülmemektedir).type
vevalue
yerine kullanılabilir.
Örnekler:
<span class="ingredient">
<span class="amount">1</span>
<span class="name">tavuk</span>
</span>
<span class="ingredient">
<span class="value">0.5</span>
<span class="type">lt.</span>
<span class="name">bira</span>
</span>
instructions
Asıl yemek pişirme tarifi.
Bir yemek pişirme tarifi en fazla bir adet instructions
sınıf öğesi içerebilir. Bu özelliğin değeri olarak sade metin veya HTML kodu kullanılabilir.
Bu özelliğe “Yemeğin hazırlanışı” şeklindeki başlık hariç olmak üzere, metnin asıl yemeğin hazırlanış yöntemlerinin açıklandığı kısmının eklenmesi tavsiye olunur.
Tarifin belirli maddelerini instruction
sınıfıyla işaretleyebilirsiniz. instruction
iç özelliği hRecipe standardıyla öngörülmemiş olup Yandex tarafından bir eklenti olarak ilave edilmiş bulunuyor.
Örnek:
<ul class="instructions">
<li class="instruction"> Parçalara ayrılmış tavuğu fırın tepsisine koyun ve üzerine zevkinize göre tuz, biber ve baharat serpin.</li>
<li class="instruction">Tavuğun üzerine bira dökün ve pişirilmek üzere fırına koyun.</li>
<li class="instruction">180 derece sıcaklıkta 40-45 dakika pişirin.</li>
</ul>
instructions
özelliğinin içine bir veya birden fazla photo
özelliğiyle bir result-photo
özelliğinin eklenmesi de mümkündür.
Örnek:
<ul class="instructions">
<li>Parçalara ayrılmış tavuğu fırın tepsisine koyun ve üzerine zevkinize göre tuz, biber ve baharat serpin.<br>
<img class="photo" src="images/step1.jpg" alt="Parçalara ayrılmış">
</img>
</li>
<li>Tavuğun üzerine bira dökün ve pişirilmek üzere fırına koyun.<br>
<img class="photo" src="images/step2.jpg" alt=" üzerine bira dökün">
</img>
</li>
<li>180 derece sıcaklıkta 40-45 dakika pişirin.<br>
<img class="photo result-photo"
src="images/step3.jpg" alt="Afiyet olsun!"></img>
</li>
</ul>
photo
ve result-photo
özelliklerinin açıklamaları daha aşağıda yer alıyor.
Destekli öğeler
hRecipe formatının zorunlu özelliklerinin yanı sıra Yandex, o formatın aşağıdaki diğer özelliklerini de işler:
- yield
- duration
- photo ve result-photo
- author
- nutrition
yield
Belirtilen miktarlarda alınan malzemelerden elde edilebilecek porsiyonların sayısı. Bir yemek tarifi, sadece bir adet yield
sınıfı öğesi içerebilir. Bu özelliğin tek doğru değeri metindir.
Örnek:
<span>Bu yemek <span class="yield">3 porsiyon</span> olarak hazırlanır.</span>
duration
Yemeğin pişme süresi. Bu özelliğin doğru değeri, ISO 8601 formatında bir satır olmalı.
Örneğin:
<span>
Yemeğin hazırlanışı yaklaşık
<span class="duration">1 saat</span> sürer.
</span>
<span class="duration"><span class="value-title" title="PT1H30M"> </span>1,5 saat</span>
photo ve result-photo
Yemeğin hazır olarak veya pişmesi sırasında çekilen fotoğrafı.
Bir yemek tarifi birden fazla photo
sınıfı öğesi içerebilir. photo
özelliği ya doğrudan hrecipe
kök sınıfı öğesine; ya da instructions
özelliğine bağımlı olabilir. Bu özelliğin doğru değeri, <img>
adlı HTML öğesinin src
özniteliğinin değeridir.
Bir yemek tarifi bir veya birden fazla photo
sınıfı öğesi içerdiğinde o öğelerden yemeği hazır olarak görüntüleyen bir öğesi ayrıca result-photo
sınıfıyla da işaretlenmelidir. hRecipe standardıyla öngörülmeyen result-photo
özelliği, Yandex tarafından bir eklenti olarak ilave edilmiştir.
photo
ve result-photo
özelliklerinin kullanım örneği için instructions
özelliği açıklamasına bakınız.
author
Tarifi hazırlayanın ismi.
Bir yemek tarifi birden fazla author
sınıfı öğesi içerebilir. Bu özelliğin doğru değeri bir metin veya hCard formatında bir kart olabilir.
Örnekler:
<span>
Yemek tarifini hazırlayan: <span class="author">Ali Örnek</span>
</span>
<span>
Yemek tarifini hazırlayan:
<span class="author vcard">
<a class="fn url" href="http://aliornek.ornek.com.tr/">Ali Örnek</a>
</span>
</span>
nutrition
Yemeğin besin değeri (kaloriler, protein, yağ, karbonhidrat, vitamin vb. içeriği).
Bir yemek tarifi birden fazla nutrition
sınıfı öğesi içerebilir. Özellik, aşağıda sıralanan ve hRecipe standardının öngörmediği fakat Yandex'in desteklediği iç özellikler
içerebilir:
-
calories
: kaloriler olarak belirlenen besin değeri; -
fat
: yağlar; -
saturatedFat
: doymuş yağlar; -
unsaturatedFat
: doymamış yağlar; -
carbohydrates
: karbonhidrat; -
sugar
: şeker; -
fiber
: lif; -
protein
: protein; -
cholesterol
: kolesterol; -
servingSize
: besin değerinin belirtildiği porsiyon büyüklüğü.
Örneğin:
<div>
100 gr.'lık porsiyonun
<span class="nutrition">
besin değeri: <span class="calories">240 kcal.</span>
Protein:
<span class="protein">18 gr.</span>
Yağ:
<span class="fat">10 gr.</span>
Karbonhidrat:
<span class="carbohydrates">70 gr.</span>
</span>
</div>
Eklentiler
hRecipe standardının öngörmediği fakat Yandex'in işlediği aşağıda sıralanan özellikleri tariflere ekleyebilirsiniz:
category
Yemek türü.
Bir yemek tarifi sadece bir adet category
sınıfı öğesi içerebilir. Bu özelliğin tek doğru değeri metindir.
Örnek:
<span class="category">Ana yemek</span>
sub-category
Yemeğin alt türü.
Bir yemek tarifi sadece bir adet sub-category
sınıfı öğesi içerebilir. Bu özelliğin tek doğru değeri metindir.
Örnek:
<div>
<span class="category">Ana yemek</span>
<span class="sub-category">Tavuk yemeği</span>
</div>
cuisine-type
Yemeğin geliştirildiği mutfağın hangi ülkeye ait olduğu.
Bir yemek tarifi sadece bir adet cuisine-type
sınıfı öğesi içerebilir. Bu özelliğin tek doğru değeri metindir.
Örnek:
<div class="cuisine-type">Lüksemburg mutfağı yemeği</div>
weight
Hazır yemeğin ağırlığı.
Bir yemek tarifi sadece bir adet weight
sınıfı öğesi içerebilir. Bu özelliğin tek doğru değeri metindir.
Örnek:
<div>Hazır yemeğin ağırlığı <span class="weight">1,5 kg.</span>'dır.</div>