DinamytE at 05:16, 1 October 2008

2008-10-01T05:16:39Z

New page

= adr =

Микроформат adr — это простой формат для разметки информации об адресах; подходит для внедрения в (X)HTML, Atom, RSS, XML. Данный формат является точной копией свойства ''adr'' из стандарта vCard, которое было таким образом портировано в HTML. Формат adr — один из многих других [[microformats-ru|микроформатов]]. Помимо этого, данный микроформат является свойством [[hCard-ru|hCard]].

{{authoring-ru|date=
|authors=
; Автор
: [http://tantek.com/ Tantek Çelik] ([http://technorati.com Technorati, Inc])
|rights=}}

{{TOC-right}}

== История ==
На конференции [http://conferences.oreillynet.com/where/ Where 2.0] в июне 2005 года сообщество обсуждало вопрос о необходимости разработки нового способа представления информации об адресах, которую можно было бы легко извлечь из контекста и легко визуально воспринимать. Сильным толчком к обсуждению было всё увеличивающееся количество блогов и других сайтов, которые публикуют разнообразную адресную информацию. Сообщество решило не изобретать что-то новое, а, в соответствии с принципами микроформатов, использовать уже существующий формат: ''adr'' из vCard/hCard.

Данная спецификация представляет микроформат '''adr'''.

Авторы могут внедрять адреса adr напрямую в собственные Web-страницы или RSS-ленты, однако если такие адреса уже существуют, их можно просто разметить микроформатом adr.

Если автор знает и публикует ''имя'' местоположения в дополнение к его адресу, то он '''должен''' использовать [[hcard-ru|hCard]], а не adr.



== Формат ==

=== Одиночные свойства ===
См. описание [[hcard-ru|hCard]] для информации об одиночных свойств adr.

=== Доступность для человека и машины ===
Если для разметки свойства используется элемент <code><abbr></code>, то '''не''' содержимое данного элемента, а его атрибут <code>title</code> является значением данного свойства. Содержимое элемента в данном случае содержит удобочитаемые для человека данные.

Аналогично, если элемент <code><img></code> используется для разметки свойств, он должен распознаваться следующим образом:
# Для свойства <code>PHOTO</code> и других свойств, которые принимают URL как собственное значение, атрибут <code>src</code> и является этим значением.
# Для других свойств значением будет являться значение атрибута <code>alt</code>.

=== Частичные значения ===
Иногда для обозначения значения свойства следует использовать не всё содержимое элемента, а только его часть. Для этого создан специальный класс <code>value</code>, с помощью которого вы можете отделить описание свойства от значения свойства.

=== Корневое имя класса ===
Корневым именем класса для микроформата adr является класс <code>adr</code>.
The root class name for an '''adr''' address is <code>adr</code>.

=== Список свойств ===
* <code>post-office-box</code>
* <code>extended-address</code>
* <code>street-address</code>
* <code>locality</code>
* <code>region</code>
* <code>postal-code</code>
* <code>country-name</code>

Подсвойство <code>type</code> было исключено, так как без контекста оно не имеет значения.

=== XMDP-профиль ===
См. описание [[hcard-ru|hCard]] для информации о [http://gmpg.org/xmdp XMDP-профиле] hCard, который содержит информацию о вышеописанных свойствах.

=== Информация об обработке ===
См. [[hcard-parsing-ru|обработку hCard]]: обработка adr отличается от обработки hCard только именем корневого класса.

== Примеры ==
''Данный раздел является информативным.''

=== Простой пример adr ===

<pre><nowiki>
<div class="adr">
<div class="street-address">665 3rd St.</div>
<div class="extended-address">Suite 207</div>
<span class="locality">San Francisco</span>,
<span class="region">CA</span>
<span class="postal-code">94107</span>
<div class="country-name">U.S.A.</div>
</div>
</nowiki></pre>

Который будет отображён браузером как:

<div class="adr">
<div class="street-address">'''665 3rd St.'''</div>
<div class="extended-address">'''Suite 207'''</div>
<span class="locality">'''San Francisco'''</span>,
<span class="region">'''CA'''</span>
<span class="postal-code">'''94107'''</span>
<div class="country-name">'''U.S.A.'''</div>
</div>

=== Другие примеры ===

См. [http://microformats.org/wiki/hcard-examples#3.2.1_ADR_Type_Definition примеры adr в hCard] (англ.).

См. [http://microformats.org/wiki/adr-examples дополнительные примеры adr] (англ.).


== Ссылки ==
=== Нормативные ===
* [[hcard-ru|hCard]]

=== Информативные ===
* [http://www.ietf.org/rfc/rfc2426.txt vCard (RFC)]
* [http://www.w3.org/TR/2002/REC-xhtml1-20020801/ XHTML 1.0 SE]

=== Схожие работы ===
* [[geo-ru|geo]]
* [[hcalendar-ru|hCalendar]]
* [[xoxo-ru|XOXO]]

=== Обсуждения ===

* См. [http://www.technorati.com/cosmos/referer.html поиск по Technorati].

adr-ru - Revision history

DinamytE at 05:16, 1 October 2008