hReview является простым, открытым, распределенным микроформатом для разметки отзывов о чем-либо, например о продукции, услугах, предприятиях, событиях и т.д., в (X)HTML, Atom, RSS и произвольном XML.
Исходя из определения можно сделать вывод о том, что для блоггеров hReview является наиболее важным микроформатом. Наиболее часто используется hReview для построения рейтингов. Поисковики могут использовать рейтинг отзыва в выводе сниппета поисковой выдачи или при построении общего рейтинга, например, некоторого события или предприятия.
Основные компоненты hReview:
version - используемая версия спецификации hReview, например, версия 0.2 или 0.3 (последняя версия спецификации). Необязательный компонент. Обычно не используется.
summary - заголовок отзыва или краткая аннотация. Необязательный компонент, но при его отсутствии поисковики могут полностью игнорировать внедренный микроформат.
Пример использования:
1 | <h2 class="summary">Отличное онлайн радио для детей</h2> |
type — тип отзыва. Обязательный компонент. Type определяет к какому типу объекта относится данный отзыв. Может принимать один из возможных значений: product (продукт), business (бизнес), place (места), person (лица), event (события), website (веб-сайт), url (что-то чему соответствует некоторый URL).
Например, чтобы описать некоторое предприятие или для разнообразия, детское радио онлайн , можно использовать type со значением "business":
1 2 3 | <span class="type">
<span class="value-title" title="business">
</span> |
При желании значение type можно не выводить на экран, например, с помощью CSS (style="display: none; ") это можно сделать так:
1 | <span class="type" style="display: none; ">business</span> |
Так как микроформаты являются частью разметки (X)HTML, то любой фрагмент микроформата вышеприведенным способом может быть скрыт от пользователя.
item - обязательный компонент, описывающее объект отзыва. Внутри блока item может находиться один или несколько фрагментов, размеченных тем или иным микроформатом в зависимости от значения type.
Так как в примере идет отзыв об организации, значит кратко выразим информацию об организации на hCard:
1 2 3 | <div class="item vcard">
<span class="fn org">Радио Щербака</span>
</div> |
В случае, если бы мы делали отзыв о человеке, мы бы описали здесь этого человека.
reviewer - автор отзыва. Необязательный компонент. Например, автора можно описать так:
1 | <span class="reviewer">Сергей Щербак</span> |
или можно использовать более сложное определение
1 | <span class="reviewer vcard"><span class="fn">Сергей Щербак</span> |
где использован элемент hCard, о котором я рассказывал здесь.
dtreviewed - время написания отзыва, используется формат ISO8601 для представления времени. Обязательный компонент. Например, используем шаблон представления времени "YYYY-MM-DD", получаем отзыв составленный 2011-02-11 (11 февраля 2011 года) или можем указать еще более точное время используя шаблон "YYYY-MM-DDThh:mm:ss" - 2011-02-11T18:17:01. Кстати, обратите внимание на разделитель "T" между датой и временем написания.
Шаблонов представления времени существует множество. Можно также использовать шаблон без разделяющих "-", тогда будет не так наглядно, но тоже верно. Например, 20110211.
1 2 3 | <p class="dtreviewed">
Отзыв написан <abbr class="value" title="2011-02-11">02 февраля 2011</abbr>
</p> |
rating - рейтинг, который вы устанавливаете объекту, о котором пишите отзыв - число с фиксированной точкой (необязательное, но помним об автоматических рейтингах поисковиков!!!).
Например, rating может быть 3.0, 4.5, 5.0.
1 | <div class="rating">4.0</div> |
Можна также указывать нижнюю (worst) и верхнюю (best) границу значений шкалы рейтинга отзыва. Определения границ рейтинга отзыва должны быть внутри блока rating:
1 2 3 4 | <div class="rating">4.0
<abbr class="worst" title="1"></abbr>
<abbr class="best" title="5"></abbr>
</div> |
Если границы worst или best не указаны, то считается, что worst равно 1.0, а best равно 5.0.
description - собственно отзыв - текст, картинки и т.п.
1 2 3 | <span class="description">
Эта штука просто супер!!!
</span> |
Внутри блока description можно использовать элементы pro для перечисления достоинств объекта отзыва, а contra — для перечисления недостатков.
Замечания.
- Если pro и/или contra представляются в виде списка, то необходимо отмечать каждый элемент списка соответствующей меткой - pro или contra;
- pro и contra могут быть определены как внутри блока description, так и вне его;
- Не допускается одновременное отсутствие description, pro и contra.
хм... об hProduct расскажу в следующий раз. Про pro и contra значит тоже.
Особенность микроформатов в том, что их можно объединять в достаточно сложные структуры, а именно можна использовать hReview вместе с hCard, hProduct и т.д.
tag - список тегов - ключевых терминов, фраз, характеризующих по мнению автора объект отзыва.
1 2 | <a href="http://щербак.net/tag/radio" rel="tag">Радио</a> <a href="http://щербак.net/tag/children" rel="tag">Дети</a> |
permalink - адрес (URL), где расположен полный текст отзыва. ОБЯЗАТЕЛЬНАЯ ХАРАКТЕРИСТИКА.
1 | <a class="permalink" href="http://щербак.net/reviews/first-rev"></a> |
license - лицензия, по которой распространяется отзыв. Необязательно. Этот элемент не прост, пока не работает. Но рассмотрения в будущем потребует.
Итак, мы рассмотрели основные компоненты hReview.
В результате мы получили следующий код:
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 | <div class="hreview">
<h2 class="summary">онлайн радио</h2>
<span class="type">
<span class="value-title" title="business">
</span>
<div class="item vcard">
<span class="fn org">Радио Щербака</span>
</div>
<span class="reviewer vcard"><span class="fn">Сергей Щербак</span>
<p class="dtreviewed">
Отзыв написан <abbr class="value" title="2011-02-11">02 февраля 2011</abbr>
</p>
<div class="rating">4.0
<abbr class="worst" title="1"></abbr>
<abbr class="best" title="5"></abbr>
</div>
<span class="description">
Эта штука просто супер!!!
</span>
<a href="http://щербак.net/tag/radio" rel="tag">Радио</a>
<a href="http://щербак.net/tag/children" rel="tag">Дети</a>
<a class="permalink" href="http://щербак.net/reviews/first-rev"></a>
</div> |
Кстати, можна также указать язык отзыва с помощью конструкции lang, например lang="ru".
В нижеприведенном примере, определен язык отзыва "русский", но один из тегов на английском.
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 | <div class="hreview" lang="ru">
<h2 class="summary">онлайн радио</h2>
<span class="type">
<span class="value-title" title="business">
</span>
<div class="item vcard">
<span class="fn org">Радио Щербака</span>
</div>
<span class="reviewer vcard"><span class="fn">Сергей Щербак</span>
<p class="dtreviewed">
Отзыв написан <abbr class="value" title="2011-02-11">02 февраля 2011</abbr>
</p>
<div class="rating">4.0
<abbr class="worst" title="1"></abbr>
<abbr class="best" title="5"></abbr>
</div>
<span class="description">
Эта штука просто супер!!!
</span>
<a lang="en" href="http://щербак.net/tag/radio" rel="tag">Radio</a>
<a lang="ru" href="http://щербак.net/tag/children" rel="tag">Дети</a>
<a class="permalink" href="http://щербак.net/reviews/first-rev"></a>
</div> |
Важно:
Обязательность использования того или иного компонента микроформата можно определить руководствуясь простым правилом: "Если для построения рейтинга автоматическим способом, например, поисковиком, нужен рассматриваемый компонент, то он обязателен" (иначе микроформат страницы может быть полностью проигнорирован).
Оставить комментарий