APRELKUN: Новая страница: «{{Microformat-info||right}} '''Микроформаты''' — специальная иерархия классов CSS, применяемых на страницах википроектов для улучшения определения поисковиками различных типов информации в содержимом викистатей. Являются частью микроразметки.[https://artisan-team.ru/seo-wiki/...»

2024-06-13T14:43:35Z

Новая страница: «{{Microformat-info||right}} '''Микроформаты''' — специальная иерархия классов CSS, применяемых на страницах википроектов для улучшения определения поисковиками различных типов информации в содержимом викистатей. Являются частью микроразметки.<ref>[https://artisan-team.ru/seo-wiki/...»

Новая страница

{{Microformat-info||right}}
'''Микроформаты''' — специальная иерархия классов CSS, применяемых на страницах википроектов для улучшения определения поисковиками различных типов информации в содержимом викистатей. Являются частью микроразметки.<ref>[https://artisan-team.ru/seo-wiki/mikrorazmetka/ Микроразметка] — Seo-wiki</ref> В Циклопедии микроформаты используются в шаблонах-карточках, где обычно указывается краткая информация о предмете статьи.

== Общие правила ==
* Микроформат представляет собой иерархию вложенных HTML-тегов с соответствующими свойствами, каждое из которых указывается в качестве ''CSS класса'' конкретного тега:<code><тег class="свойство">Содержимое тега</тег></code>Предпочитаемыми тегами являются <tt><div></tt> и <tt></tt>.
* Для ряда свойств, используемых более одного раза, могут быть указаны разные ''типы'' этих свойств и соответствующие этим типам ''значения'' с помощью подсвойств '''type''' и '''value''':
<dl><dd><pre>
<тег class="свойство">
<тег class="type">Тип</тег>
<тег class="value">Значение</тег>
</тег>
</pre></dd><dl>
* Для каждого свойства, имеющего вложенные типы '''type''' и значения '''value''', если тип '''type''' не указан, то непосредственное содержимое свойства определяется как его значение '''value'''.
* Если указан только '''type''', без '''value''', в качестве значения используется ''содержимое тега самого свойства'':
<dl><dd><pre>
<тег class="свойство">
<тег class="type">Тип</тег>
Содержимое тега
</тег>
</pre></dd><dl>
* При указании свойства микроформата через тег <tt><abbr></tt> или через вложенный тег с классом <code stle="white-space:nowrap;">class="value-title"</code> значением является указанный в нём ''атрибут'' <code>title=</code>, при этом содержимое самого тега <tt><abbr></tt> или родительского тега используется лишь в качестве отображаемого текста и может быть вообще не указано.
<ul><li>Свойства микроформата делятся на два вида:<ol>
<li>Принимающие в качестве значения URL. Такие свойства из (вложенного) тега <tt><a></tt> извлекают значение атрибута <code>href=</code>, из тега <tt><img></tt> — значение атрибута <code>src=</code>.</li>
<li>Принимающие в качестве значения текст содержимого. Такие свойства из тега <tt><a></tt> и остальных тегов извлекают вложенный текст, из тега <tt><img></tt> — значение атрибута <code>alt=</code>.</li></ol>в одном теге можно сочетать свойства разных видов, при этом одни извлекают ссылку, а другие — текстовое значение.</ul>

{{note-box|1=Во всех свойствах, определяющих дату, в том числе в датах события в [[#hCalendar|hCalendar]], дате рождения в [[#hCard|hCard]], используется формат даты по стандарту ISO 8601 / RFC 3339 вида <code style="white-space:nowrap;">YYYY-MM-DDThh:mm:ss</code>, не предназначенный для непосредственного чтения. Поэтому значения свойств дат рекомендовано выводить не в качестве непосредственно отображаемого текста, читаемого людьми, а через HTML-атрибут <code>title=</code> тега <tt><abbr></tt> или вложенного тега с классом <code style="white-space:nowrap;">value-title</code>, скрытого с помощью <code style="white-space:nowrap;">display:none;</code>.}}

== Микроформаты ==
{| align="left" cellpadding="2" cellspacing="0" border="0" style="border:1px solid #fef; font-size:small; line-height:1.4em;"
|-
!colspan="3" bgcolor="#ffe" style="border-bottom:1px solid #fef;"| Легенда 
|-
|width="5"| 
|bgcolor="#fff"|'''<abbr title="Обязательное свойство">Подчёркиванием</abbr>''' выделены обязательные свойства. '''Зелёным цветом''' отмечены свойства, указываемые внутри своего родителя только один раз. '''Красным цветом''' обозначены нестандартные свойства и расширения, введённые отдельными платформами и работающие не во всех поисковиках. Даты, значение которых указывается по стандарту ISO, выделены жёлтым фоном.
|width="5"| 
|}<div style="clear:both;height:0;background:transparent;"></div>
=== hCard ===
{{Microformat-info|hcard|right}}'''hCard''' — микроформат, используемый для выделения элементов данных о людях, местах и организациях. Является распространённым и поддерживается многими поисковыми платформами, в т. ч. Яндексом, Google. Иерархия классов микроформата hCard:
*'''vcard''' — Корневой класс для hCard. Указывает, что данный элемент и все производные (вложенные в него элементы) содержат в себе микроформат hCard. Для каждого объекта или субъекта используется свой отдельный экземпляр '''vcard''', допускается вкладывать их один в другой.
**'''<abbr title="Обязательное свойство. Свойство должно быть указано только один раз.">fn</abbr>''' — Имя объекта (формальное имя, formal name). Если свойство '''n''' не указано, используется вместо него по следующим правилам:<ul><li>если значение содержит ''два слова'', они интерпретируются как '''given-name''' и '''family-name''' (<code style="white-space:nowrap;">Имя Фамилия</code>, с запятой <code style="white-space:nowrap;">Фамилия, Имя</code>)</li><li>если значение содержит ''одно слово'', оно определяется как '''nickname'''</li></ul> Если '''fn''' указывается вместе с '''org''' при пустом '''n''', объект считается организацией.
**'''<abbr title="Обязательное свойство. Свойство должно быть указано только один раз.">n</abbr>''' — Имя объекта. Используется для подробного представления имени субъектов (людей, животных, персонажей).
***'''honorific-prefix''' — Обращение (''сэр'', ''<abbr title="господин">г-н</abbr>'', ''Его Величество'', ''товарищ'' и т. п.)
***'''given-name''' — Имя
***'''family-name''' — Фамилия
***'''additional-name''' — Отчество
***'''honorific-suffix''' —
***'''nickname''' — Псевдоним
**'''logo''' — Логотип, изображение, ассоциированное с объектом
**'''photo''' — Фотография объекта. Извлекает значение URL из атрибута <code>src=</code> вложенного тега <tt><img></tt> или из атрибута <code>href=</code> вложенного тега <tt><a></tt>.
**'''bday''' — День рождения объекта.
**'''geo''' — Географические координаты объекта. Данное свойство встроено в шаблон {{Tl|Coord}} и вставляется вместе с ним.
***'''latitude''' — Широта как часть географических координат
***'''longitude''' — Долгота как часть географических координат объекта
**'''adr''' — Адрес объекта (подробный)
***'''type''' — Тип родительского элемента. Распространённые значения: ''WORK'' (рабочий адрес, оффис), ''home'' (домашний адрес) и др.
***'''value''' — Актуальное значение конкретно-указанного типа.
****'''postal-code''' — Почтовый индекс
****'''country-name''' — Имя страны. Допускается вывод через <tt><abbr></tt>.
****'''region''' — Регион. Допускается вывод через <tt><abbr></tt>
****'''locality''' — Населённый пункт
****'''street-address''' — Улица, дом
****'''extended-address''' — Расширенный адрес (корпус, номер подъезда, этаж ...)
****'''post-office-box''' — Адрес почтового ящика
**'''label''' — Адрес объекта (обобщённый). Допускает указание полного адреса — содержимого одновременно всех вложенных элементов '''adr''' — в качестве единого значения без разделения на элементы.
***'''type''' — Тип родительского элемента.
***'''value''' — Актуальное значение конкретно-указанного типа.
**'''org''' — Организация или компания объекта. Если объект является организацией или компанией, указывается вместе с '''fn''' <code style="white-space:nowrap;">class="fn org"</code>, при этом '''n''' не используется и должно быть пустым. Если '''organization-name''' не указано, то '''org''' считается равным '''organization-name'''. Данное свойство может быть вложенным внутрь '''adr'''.
***'''organization-name''' — Имя организации или компании объекта
***'''organization-unit''' — Департамент, отдел, в котором числится объект
**'''title''' — Название занимаемой субъектом должности или положения
**'''role''' — Информация о роли субъекта
**'''agent''' — Представитель субъекта (агент, секретарь и т. д.)
**'''tel''' — Телефонный номер объекта
***'''type''' — Тип родительского элемента. Распространённые значения: ''home'' (домашний), ''msg'' (с автоответчиком), ''work'' (рабочий), ''fax'' (факс), ''cell'' (мобильный/сотовый), ''video'' (видеофон), ''pager'' (пэйджер), ''modem'' (модем), ''car'' (в автомобиле) и др.
***'''value''' — Актуальное значение конкретно-указанного типа.
**'''email''' — Эл. почта объекта
***'''type''' — Тип родительского элемента. Распространённые значения: ''INTERNET'', ''x400'' и др.
***'''value''' — Актуальное значение конкретно-указанного типа.
**'''mailer''' — Приложение, которое используется в качетстве почтового клиента объектом
**'''tz''' — Временна́я зона объекта
**'''url''' — Ссылка на веб-страницу объекта hCard или какого-либо его свойства. Значение ссылки извлекается из атрибута <code>href=</code> вложенного тега <tt><a></tt>. Может использоваться в сочетании со всеми другими свойствами hCard, имеющими текстовое значение, например <code>class="fn url"</code>. При этом '''url''' извлекает ссылку, а '''fn''' — текст.
**'''workhours''' — Время работы организации.<ref name="yandex" />
**'''note''' — Дополнительная информация об объекте
**'''key''' — Публичный ключ объекта
***'''type''' — Тип родительского элемента.
***'''value''' — Актуальное значение конкретно-указанного типа.
**'''category''' — Категория объекта. Специализация деятельности организации.
**'''class''' — Классификатор уровня доступа к объекту (''public'' — публичный, ''confidentional'' — скрытый)
**'''sort-string''' — Имя одного из свойств микроформата, которое будет использовано для сортировки по алфавиту. По умолчанию это часть имени.
**'''uid''' — Глобально уникальный идентификатор, привязанный к объекту или одному из свойств объекта.
**'''rev''' — Указывает ревизию hCard
**'''sound''' — Какой элемент будет озвучен аудио-средствами. По умолчанию, это «'''fn'''»

=== hCalendar ===
{{Microformat-info|hCalendar|right}}'''hCalendar''' — микроформат разметки событий. Поддерживается Google, не поддерживается Яндексом. Иерархия классов микроформата hCalendar:
* '''vcalendar''' — Корневой класс для hCalendar. Указывает, что данный элемент и все производные (вложенные в него элементы) содержат в себе микроформат hCalendar
* '''vevent''' — Корневой класс для событий. Равнозначен '''vcalendar''', может использоваться вместо '''vcalendar''' как корневой класс hCalendar (если '''vcalendar''' не указан), или как вложенное свойство корневого класса '''vcalendar'''. Внутрь может быть вложен микроформат [[#hCard|hCard]].
** '''<abbr title="Обязательное свойство" style="background:lightyellow;">dtstart</abbr>''' — Дата начала события.
** dtend — Дата окончания события.
** duration — Период или длительность события.
** dtstamp — Дата записи / последнего обновления hCalendar
** '''<abbr title="Обязательное свойство">summary</abbr>''' — Краткое описание события.
** '''description''' — Подробное описание события
** '''location''' — Место проведения события. Внутрь может быть вложен микроформат [[#hCard|hCard]] с описанием адреса.
**'''geo''' — Географические координаты объекта. Данное свойство встроено в шаблон {{Tl|Coord}} и вставляется вместе с ним.
***'''latitude''' — Широта как часть географических координат
***'''longitude''' — Долгота как часть географических координат объекта
**'''url''' — Ссылка на веб-страницу события hCalendar или какого-либо его свойства. Значение ссылки извлекается из атрибута <code>href=</code> вложенного тега <tt><a></tt>. Может использоваться в сочетании со всеми другими свойствами hCard, имеющими текстовое значение, например <code>class="location url"</code>. При этом '''url''' извлекает ссылку, а '''location''' — текст.
** '''rrule''' — повтор события относительно '''dtstart'''
*** '''freq''' — частота повтора. Возможные значения: ''DAILY'' (ежедневно), ''WEEKLY'' (еженедельно), ''MONTHLY'' (ежемесячно), ''YEARLY'' (ежегодно)
*** '''count''' — число повторов (целое число)
*** '''interval''' — интервал (целое число), пропуск между повторами единицах времени (днях, месяцах, годах), определённых через '''freq'''
*** until — дата окончания повторов
** rdate — даты повтора события после '''dtstart'''.
** '''category''' —
** '''uid''' —

=== hRecipe ===
{{Microformat-info|hRecipe|right|en}}'''hRecipe''' — микроформат для описания кулинарных рецептов. Поддерживается Яндексом, Google. Иерархия свойств hRecipe:
*'''hrecipe''' — корневой класс hRecipe
**'''<abbr title="Обязательное свойство">fn</abbr>''' — Название рецепта или блюда.
**'''author''' — Автор рецепта. В качестве вложенного содержимого допускается совместное использование микроформата hCard путём добавления <code style="white-space:nowrap;">class="author vcard"</code>.
**'''<abbr title="Обязательное свойство">ingredient</abbr>''' — Ингредиент
***'''type''' — Единица измерения продукта
***'''value''' — Количество единиц продукта
***'''name''' — Название продукта.<ref name="yandex" />
***'''amount''' — Единица и/или количество продукта. Используется вместо '''type''' и '''value'''.<ref name="yandex" />
**'''instructions''' — Инструкция по приготовлению блюда.
***'''photo''' — Фотография процесса приготовления блюда
***'''instruction''' — Отдельный пункт инструкции.<ref name="yandex" />
**'''duration''' — Длительность приготовления
**'''yield''' — Количество порций приготовленного блюда
**'''photo''' — Фотография процесса приготовления блюда
**'''nutrition''' — Пищевая и/или энергетическая ценность блюда
***'''calories''' — Калорийность<ref name="yandex" />
***'''fat''' — Содержание жиров<ref name="yandex" />
***'''saturatedFat''' — Содержание насыщенных жиров<ref name="yandex" />
***'''unsaturatedFat''' — Содержание ненасыщенных жиров<ref name="yandex" />
***'''carbohydrates''' — Содержание углеводов<ref name="yandex" />
***'''sugar''' — Содержание сахаров<ref name="yandex" />
***'''fiber''' — Содержание клетчатки<ref name="yandex" />
***'''protein''' — Содержание белков<ref name="yandex" />
***'''cholesterol''' — Содержание холестерина<ref name="yandex" />
***'''servingSize''' — Размер порции<ref name="yandex" />
**'''result-photo''' — Фотография готового блюда. Нестандартное свойство, дополнительно добавляемое вместе с одним из свойств '''photo'''.<ref name="yandex" />
**'''cuisine-type''' — Национальная кухня, к которой относится блюдо.<ref name="yandex" />
**'''weight''' — Вес готового блюда.<ref name="yandex" />

=== hReview ===
{{Microformat-info|hReview|right|en}}'''hReview''' — микроформат разметки отзывов (о продукции, услугах, произведениях и мероприятиях в сфере культуры и искусства). Поддерживается Яндексом, Google.
{{Заготовка раздела}}

== Поддержка микроформатов в википроекте ==
=== Шаблоны со встроенным микроформатом ===
Ряд популярных викишаблонов с своём составе имеют встроенную поддержку микроформата:
* Шаблон {{Tl|ДатаРождения}} поддерживает свойство микроформата '''bday''' и может использоваться для добавления данных о дате рождения в составе [[#hCard|hCard]].
* Шаблон отображения географических координат {{Tl|Coord}} по умолчанию поддерживает свойство микроформата '''geo'''. С заполненными параметрами он кроме видимого содержимого формирует и выводит скрытые теги с уже готовыми заполненными свойствами '''geo''' ('''latitude''', '''longitude'''). Данный шаблон можно вставлять внутрь элементов [[#hCard|hCard]], [[#hCalendar|hCalendar]] для добавления координат объекта или события.

В Циклопедии в шаблонах-карточках используется шаблон {{Tl|СрокЖизни}}, автоматически добавляющий свойство '''bday''' микроформата hCard. Шаблоны {{Tl|Форматирование изображения}}, {{Tl|Форматирование сайта}} свойство микроформата не добавляют, но автоматически подставляют готовое корректное значение ''value-title''.

=== Шаблоны для добавления микроформата ===
В Циклопедии для вставки микроформатов предназначен специально созданный для этих целей шаблон {{Tl|Микроформат}}, который позволяет более удобно вставлять свойства и значения микроформата в другие шаблоны.

== Ссылки ==
* [https://microformats.org/wiki/existing-classes-ru Имена классов, используемые в микроформатах] — [https://microformats.org microformats.org]
* [https://yandex.ru/support/webmaster/hcard/general.html Микроформат hCard] — ЯндексСправка
* [https://yandex.ru/support/webmaster/hrecipe/yandex-supported.html Описание элементов hRecipe] — ЯндексСправка
* [https://wiki.rookee.ru/mikroformat-hcard/ Микроформат hCard] — SEO Wiki
* ''Иван Блинков'' [https://www.insight-it.ru/theory/2008/hcard/ hCard] — Insight IT, 13 апреля 2008
* [https://icalendar.org/iCalendar-RFC-5545/3-8-5-3-recurrence-rule.html 3.8.5.3. Recurrence Rule] — icalendar.org

== Источники ==
{{Примечания|refs=

<ref name="yandex">Нестандартное свойство, внедрено и поддерживается Яндексом.</ref>

}}

[[Категория:Aprel Wiki:Справки]]

Справка:Микроформаты - История изменений