hcalendar-ru - Revision history

Alik: Unicode

2010-09-05T20:50:49Z

Unicode

← Older revision		Revision as of 20:50, 5 September 2010
Line 9:		Line 9:
	\|authors=		\|authors=
	; Редактор		; Редактор
	: [http://tantek.com/ Tantek ~~Celik~~] ([http://technorati.com Technorati, Inc])		: [http://tantek.com/ Tantek Çelik] ([http://technorati.com Technorati, Inc])
	; Авторы		; Авторы
	: [http://tantek.com/ Tantek ~~Celik~~] ([http://technorati.com Technorati, Inc])		: [http://tantek.com/ Tantek Çelik] ([http://technorati.com Technorati, Inc])
	: [http://suda.co.uk/ Brian Suda]		: [http://suda.co.uk/ Brian Suda]
	\|rights=}}		\|rights=}}
Line 87:		Line 87:
	* <code>URL</code> в iCalendar превращается в <code><a class="url" href="...">...</a></code> внутри элемента <code>class="vevent"</code> в hCalendar.		* <code>URL</code> в iCalendar превращается в <code><a class="url" href="...">...</a></code> внутри элемента <code>class="vevent"</code> в hCalendar.
	* <code>ATTENDEE</code>, <code>CONTACT</code> и <code>ORGANIZER</code> в iCalendar могут быть представлены с помощью микроформата [[hcard-ru\|hCard]] в hCalendar .		* <code>ATTENDEE</code>, <code>CONTACT</code> и <code>ORGANIZER</code> в iCalendar могут быть представлены с помощью микроформата [[hcard-ru\|hCard]] в hCalendar .
	* Названный <code>LOCATION</code> (с адресом и/или географическими координатами) в iCalendar может быть представлен вложенным в hCalendar [[hcard-ru\|hCard]]. Подобно ему, адрес в <code>LOCATION</code> может быть представлен, используя микроформат [[adr-ru\|adr]], а географические ~~данные —~~ [[geo-ru\|geo]].		* Названный <code>LOCATION</code> (с адресом и/или географическими координатами) в iCalendar может быть представлен вложенным в hCalendar [[hcard-ru\|hCard]]. Подобно ему, адрес в <code>LOCATION</code> может быть представлен, используя микроформат [[adr-ru\|adr]], а географические данные — [[geo-ru\|geo]].
	* <code>UID</code> в iCalendar просто становится URL, где обозначено событие hCalendar.		* <code>UID</code> в iCalendar просто становится URL, где обозначено событие hCalendar.

Alik: Syntax highlighting

2010-09-05T20:24:08Z

Syntax highlighting

← Older revision		Revision as of 20:24, 5 September 2010
Line 9:		Line 9:
	\|authors=		\|authors=
	; Редактор		; Редактор
	: [http://tantek.com/ Tantek ~~Çelik~~] ([http://technorati.com Technorati, Inc])		: [http://tantek.com/ Tantek Celik] ([http://technorati.com Technorati, Inc])
	; Авторы		; Авторы
	: [http://tantek.com/ Tantek ~~Çelik~~] ([http://technorati.com Technorati, Inc])		: [http://tantek.com/ Tantek Celik] ([http://technorati.com Technorati, Inc])
	: [http://suda.co.uk/ Brian Suda]		: [http://suda.co.uk/ Brian Suda]
	\|rights=}}		\|rights=}}
Line 87:		Line 87:
	* <code>URL</code> в iCalendar превращается в <code><a class="url" href="...">...</a></code> внутри элемента <code>class="vevent"</code> в hCalendar.		* <code>URL</code> в iCalendar превращается в <code><a class="url" href="...">...</a></code> внутри элемента <code>class="vevent"</code> в hCalendar.
	* <code>ATTENDEE</code>, <code>CONTACT</code> и <code>ORGANIZER</code> в iCalendar могут быть представлены с помощью микроформата [[hcard-ru\|hCard]] в hCalendar .		* <code>ATTENDEE</code>, <code>CONTACT</code> и <code>ORGANIZER</code> в iCalendar могут быть представлены с помощью микроформата [[hcard-ru\|hCard]] в hCalendar .
	* Названный <code>LOCATION</code> (с адресом и/или географическими координатами) в iCalendar может быть представлен вложенным в hCalendar [[hcard-ru\|hCard]]. Подобно ему, адрес в <code>LOCATION</code> может быть представлен, используя микроформат [[adr-ru\|adr]], а географические ~~данные —~~ [[geo-ru\|geo]].		* Названный <code>LOCATION</code> (с адресом и/или географическими координатами) в iCalendar может быть представлен вложенным в hCalendar [[hcard-ru\|hCard]]. Подобно ему, адрес в <code>LOCATION</code> может быть представлен, используя микроформат [[adr-ru\|adr]], а географические данные — [[geo-ru\|geo]].
	* <code>UID</code> в iCalendar просто становится URL, где обозначено событие hCalendar.		* <code>UID</code> в iCalendar просто становится URL, где обозначено событие hCalendar.

Line 134:		Line 134:
	<!-- See [[hcalendar-example1-steps]] for the derivation. -->		<!-- See [[hcalendar-example1-steps]] for the derivation. -->

	<~~pre><nowiki~~>		<source lang=html4strict>
	<div class="vevent">		<div class="vevent">
	<a class="url" href="http://www.web2con.com/">http://www.web2con.com/</a>		<a class="url" href="http://www.web2con.com/">http://www.web2con.com/</a>
Line 142:		Line 142:
	at the <span class="location">Argent Hotel, San Francisco, CA</span>		at the <span class="location">Argent Hotel, San Francisco, CA</span>
	</div>		</div>
	</~~nowiki></pre~~>		</source>

	Вышеотмеченная разметка hCalendar будет отображена похожим образом:		Вышеотмеченная разметка hCalendar будет отображена похожим образом:
Line 160:		Line 160:
	Следующий пример отмечает время встречи, которая начинается в 8:30 AM EST, 12 марта 1998 года и заканчивается в 9:30 AM EST, 12 марта 1998 года.		Следующий пример отмечает время встречи, которая начинается в 8:30 AM EST, 12 марта 1998 года и заканчивается в 9:30 AM EST, 12 марта 1998 года.

	<~~pre><nowiki~~>		<source lang=html4strict>
	BEGIN:VCALENDAR		BEGIN:VCALENDAR
	BEGIN:VEVENT		BEGIN:VEVENT
Line 172:		Line 172:
	END:VEVENT		END:VEVENT
	END:VCALENDAR		END:VCALENDAR
	</~~nowiki></pre~~>		</source>

	Эквивалент вышеприведённому примеру:		Эквивалент вышеприведённому примеру:

	<~~pre><nowiki~~>		<source lang=html4strict>
	<div class="vevent">		<div class="vevent">
	<h3 class="summary">XYZ Project Review</h3>		<h3 class="summary">XYZ Project Review</h3>
Line 186:		Line 186:
	<abbr class="dtstamp" title="19980309T231000Z">9 Mar 1998 6:00pm</abbr></small>		<abbr class="dtstamp" title="19980309T231000Z">9 Mar 1998 6:00pm</abbr></small>
	</div>		</div>
	</~~nowiki></pre~~>		</source>

	Его возможное отображение:		Его возможное отображение:

DinamytE at 12:12, 14 July 2008

2008-07-14T12:12:42Z

New page

= hCalendar =

hCalendar является простым, открытым, распределённым форматом для разметки календарных и иного рода событий. Данный микроформат основан на стандарте iCalendar ([http://www.ietf.org/rfc/rfc2445.txt RFC 2445]). hCalendar можно внедрить в HTML, XHTML и XML-подобные языки разметки.
hCalendar — один из [[microformats-ru|микроформатов]].

Хотите уже сейчас разметить события на своих страницах с помощью hCalendar? Попробуйте использовать [http://microformats.org/code/hcalendar/creator генератор hCalendar]. Помимо автоматического создания микроформата, вы можете самостоятельно его разметить, используя пошаговую [[hcalendar-authoring-ru|инструкцию]].

{{authoring-ru|date=
|authors=
; Редактор
: [http://tantek.com/ Tantek Çelik] ([http://technorati.com Technorati, Inc])
; Авторы
: [http://tantek.com/ Tantek Çelik] ([http://technorati.com Technorati, Inc])
: [http://suda.co.uk/ Brian Suda]
|rights=}}


{{TOC-right}}




== Введение ==
Стандарт iCalendar ([http://www.ietf.org/rfc/rfc2445.txt RFC 2445]) уже довольно долгое время используется в сети и в прикладных приложениях (например, iCal в Mac OS X).

В дополнение к этому, блоггеры очень часто обсуждают различные события в своих блогах: грядущие события или описания старых. С добавлением небольших изменений, блоггеры смогут обсуждать события в своём блоге таким образом, что различные поисковые роботы и другие аггрегаторы смогут автоматически их получать, конвертировать в iCalendar, а затем использовать в любых прикладных приложениях или сервисах.

Данная спецификация включает в себя описание формата '''hCalendar''' в качестве проекции стандарта iCalendar на семантический (X)HTML. Таким образом, авторы блогов могут включать данный формат напрямую в свои страницы, а не ссылаться на определённый внешний файл.

== Особенности реализации в XHTML ==


Стоит заметить, что поддержка <code><nowiki><abbr></nowiki></code> в Internet Explorer далека от совершенства и для полной работоспособности данного элемента могут понадобиться другие средства.

См. подробнее [[semantic-xhtml-ru|особенности семантики]].

== Формат ==

=== Детальное описание ===
Стандарт iCalendar ([http://www.ietf.org/rfc/rfc2445.txt RFC 2445]) является основой для микроформата hCalendar.

Одной из целью hCalendar является использование названий свойств iCalendar в нижнем регистре для имён классов и создания иерархии из XHTML-элементов, похожей на иерархию элементов iCalendar.

=== Имя корневого класса ===
Корневым классом для hCalendar является '''vcalendar''', отсюда следует, что элемент с таким классом и будет называться hCalendar.

Корневым классом для событий является '''vevent'''. Элемент с таким классом называется '''событием hCalendar''' (hCalendar event).

Для облегчения внедрения формата и его последующей автоматической обработки, оба класса, vevent и vcalendar, считаются корневыми. Если документ содержит элементы с именем класса vevent, но не содержит элементов с классом vcalendar, значит весь документ принимает на себя контекст vcalendar.

=== Свойства и подсвойства ===
Свойства hCalendar представляют собой вложенные внутри hCalendar (элемента с классом vcalendar или vevent) элементы. Элементы с указанными именами классов содержат в себе значения свойств hCalendar. У некоторых свойств есть подсвойства, которые обладают таким же свойством вложенности элементов.

=== Список свойств ===

'''Обязательные:'''
* ''dtstart'' ([[iso-8601|дата по ISO-стандарту (англ)]]) 
* ''summary''

'''Необязательные''':
* location
* url
* dtend (дата по ISO-стандарту), duration (период по ISO-стандарту)
* rdate, rrule
* category, description
* uid
* geo (latitude, longitude)

''Данный список является незавершённым, но он отображает те свойства, которые используются при разметке hCalendar чаще остальных.''

=== Семантические эквиваленты ===
Для некоторых свойств существуют более семантичные эквиваленты, поэтому они распознаются особым образом:

* <code>URL</code> в iCalendar превращается в <code><a class="url" href="...">...</a></code> внутри элемента <code>class="vevent"</code> в hCalendar.
* <code>ATTENDEE</code>, <code>CONTACT</code> и <code>ORGANIZER</code> в iCalendar могут быть представлены с помощью микроформата [[hcard-ru|hCard]] в hCalendar .
* Названный <code>LOCATION</code> (с адресом и/или географическими координатами) в iCalendar может быть представлен вложенным в hCalendar [[hcard-ru|hCard]]. Подобно ему, адрес в <code>LOCATION</code> может быть представлен, используя микроформат [[adr-ru|adr]], а географические данные — [[geo-ru|geo]].
* <code>UID</code> в iCalendar просто становится URL, где обозначено событие hCalendar.

=== Однозначные и многозначные свойства ===

Для свойств, которые встречаются (должны встречаться) только один раз (подобно ''N'' и ''FN'' из vCard), первый вложенный элемент с таким классом считается эффективным, остальные должны игнорироваться.

Для свойств, которые могут встречаться неоднократно (как ''TEL'' из vCard), каждый элемент с таким классом должен создавать новый экземпляр этого свойства. Многозначные свойства с подтипами (как ''TEL'' с ''WORK'', ''HOME'', ''CELL'' из vCard) могут быть оптимизированы таким образом, чтобы разделять один общий элемент для самого свойства, тогда подтипы становятся потомком элемента, содержащего свойство.



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

* DTSTART
* DTEND
* DURATION
* RDATE
* RRULE

== Примеры ==

=== iCalendar и hCalendar ===

Пример описания события в iCalendar:
<pre>
<nowiki>
BEGIN:VCALENDAR
PRODID:-//XYZproduct//EN
VERSION:2.0
BEGIN:VEVENT
URL:http://www.web2con.com/
DTSTART:20071005
DTEND:20071020
SUMMARY:Web 2.0 Conference
LOCATION:Argent Hotel\, San Francisco\, CA
END:VEVENT
END:VCALENDAR
</nowiki>
</pre>

Эквивалентная вышеприведённому примеру разметка hCalendar


<pre><nowiki>
<div class="vevent">
<a class="url" href="http://www.web2con.com/">http://www.web2con.com/</a>
<span class="summary">Web 2.0 Conference</span>:
<abbr class="dtstart" title="2007-10-05">October 5</abbr>-
<abbr class="dtend" title="2007-10-20">19</abbr>,
at the <span class="location">Argent Hotel, San Francisco, CA</span>
</div>
</nowiki></pre>

Вышеотмеченная разметка hCalendar будет отображена похожим образом:

<div class="vevent">
<span class="url">http://www.web2con.com/</span> 
<span class="summary">Web 2.0 Conference</span>:
<abbr class="dtstart" title="2007-10-05">October 5</abbr>-
<abbr class="dtend" title="2007-10-20">19</abbr>,
at the <span class="location">Argent Hotel, San Francisco, CA</span>
</div>

Заметьте, что парсеры уже сейчас могут найти этот микроформат на этой странице.

=== hCalendar с размытым событием ===

Следующий пример отмечает время встречи, которая начинается в 8:30 AM EST, 12 марта 1998 года и заканчивается в 9:30 AM EST, 12 марта 1998 года.

<pre><nowiki>
BEGIN:VCALENDAR
BEGIN:VEVENT
UID:guid-1.host1.com
DTSTAMP:19980309T231000Z
DESCRIPTION:Project XYZ Review Meeting
SUMMARY:XYZ Project Review
DTSTART:19980312T133000Z
DTEND:19980312T143000Z
LOCATION:1CP Conference Room 4350
END:VEVENT
END:VCALENDAR
</nowiki></pre>

Эквивалент вышеприведённому примеру:

<pre><nowiki>
<div class="vevent">
<h3 class="summary">XYZ Project Review</h3>
<p class="description">Project XYZ Review Meeting</p>
<p>To be held on <abbr class="dtstart" title="1998-03-12T08:30:00-05:00">12 March 1998 from 8:30am EST</abbr>
until <abbr class="dtend" title="1998-03-12T09:30:00-05:00">9:30am EST</abbr></p>
<p>Location: <span class="location">1CP Conference Room 4350</span></p>
<small>Booked by: <span class="uid">guid-1.host1.com</span> on
<abbr class="dtstamp" title="19980309T231000Z">9 Mar 1998 6:00pm</abbr></small>
</div>
</nowiki></pre>

Его возможное отображение:

<div class="vevent">
<h3 class="summary">XYZ Project Review</h3>
<p class="description">Project XYZ Review Meeting</p>
<p>To be held on <abbr class="dtstart" title="1998-03-12T08:30:00-05:00">12 March 1998 from 8:30am EST</abbr>
until <abbr class="dtend" title="1998-03-12T09:30:00-05:00">9:30am EST</abbr></p>
<p>Location: <span class="location">1CP Conference Room 4350</span></p>
<small>Booked by: <span class="uid">guid-1.host1.com</span> on <abbr class="dtstamp" title="19980309T231000Z">9 Mar 1998 6:00pm</abbr></small></div>

==== Примечания к примеру ====
# Информация о продукте необязательна, так как hCalendar — формат для обмена. Когда hCalendar трансформируется обратно в iCalendar, сам транскодер может добавить его собственный ID (product ID).
# Окружение hCalendar элементом <code><nowiki><span class="vcalendar"></nowiki></code> является необязательным, поэтому данный элемент в примере опущен. Если элемент vcalendar опускается, то vevent начинает принадлежать ко всему документу в целом, который в данном случае игрет роль vcalendar-контейнера. Авторы разметки могут напрямую указывать элементы с vcalendar, если у них, к примеру, на странице содержится несколько календарей, событийных веток.
# Информация о версии в hCalendar необязательна, так как её можно получить через атрибут ''profile'' элемента head.
# Даты по стандарту [[iso-8601|ISO 8601]] (требуемые стандартом iCalendar) не являются слишком дружелюбными человеческому глазу. В добавление к этому, год часто распознаётся читателями из контекста. Именно поэтому спецификация рекомендует использовать элемент <code><nowiki><abbr></nowiki></code>, с помощью которого можно вынести неудобочитаемые данные в атрибут ''title'', а приемлемые для осознавания сведения поместить в сам элемент.
## Для улучшения удобочитаемости следует использовать указанный в RFC 3339 формат данных: <code>YYYY-MM-DDThh:mm:ss</code>
# Разница между ISO 8601 датой DTEND (2005-10-08) и удобочитаемой датой (7) '''не''' является ошибкой. [http://lists.osafoundation.org/pipermail/ietf-calsify/2005-September/000769.html DTEND — уникальное значение]. Это значит, что события кончается прямо '''перед''' DTEND. Для событий, начинающихся в один день и заканчивающихся в другой, дата в DTEND должна быть указана на день позже актуальной.
# Местоположение в данном примере непосредственно содержит в себе данные, которые можно было бы разметить с помощью [[hcard-ru|hCard]].

=== Другие примеры ===
См. [[hcalendar-examples-ru|другие примеры hCalendar]].

=== Примеры в сети ===
См. отдельную страницу с [[hcalendar-examples-in-wild-ru|примерами в сети]].

== Кнопки ==

* http://www.boogdesign.com/images/buttons/microformat_hcalendar.png
* См. [[buttons-ru#hCalendar|другие кнопки]]

== Реализации ==
См. [[hcalendar-implementations-ru|реализации]].

== Ссылки ==

=== Нормативные ===
* [http://www.w3.org/TR/2002/REC-xhtml1-20020801/ XHTML 1.0 SE]
* [[hcard-ru|hCard]]
* [http://www.ietf.org/rfc/rfc2445.txt iCalendar RFC 2445]
* [[rfc-2119| RFC 2119]]
* [[iso-8601|ISO 8601]]

=== Информативные ===
* [http://w3.org/TR/REC-CSS1 CSS1]
* [http://tantek.com/log/2004/09.html#hcalendar Введение термина hCalendar]
* [http://wiki.oreillynet.com/foocamp04/index.cgi?HTMLForCalendars HTML для представления календарных событий]
* [http://wiki.oreillynet.com/foocamp04/index.cgi?SimpleSemanticFormats Simple Semantic Formats]
* [http://ietfreport.isoc.org/idref/draft-royer-ical-basic/ iCal-Basic] [http://www.faqs.org/ftp/pub/pub/internet-drafts/draft-royer-ical-basic-04.txt iCal-Basic (редакция)]
* [http://www.w3.org/TR/NOTE-datetime W3C относительно форматов даты и времени]
* [http://www.imc.org/pdi/ Internet Mail Consortium: vCard и vCalendar]
* См. также [http://developers.technorati.com/wiki/hCalendar Technorati Wiki для разработчиков]

==== Связанные спецификации ====
* [[hreview-ru|hReview]]

==== Связанные работы ====
* [http://lists.osafoundation.org/pipermail/ietf-calsify/ IETF-архивы]
* [http://www.softwarestudio.org/iCal/2445Issues.html Вопросы к RFC 2445]
* [http://ietf.webdav.org/calsify/ CALSIFY, ссылки и ресурсы]

==== Дополнительный материал ====
* [http://www.livejournal.com/users/jwz/444651.html JWZ - Hula]
* [http://www.jwz.org/doc/groupware.html Groupware Bad от Jamie Zawinski]
* [http://muddybranch.thejkgroup.com/ Блог Jason Klemow]
* [http://weblog.infoworld.com/udell/2006/01/11.html#a1368 «Движение вперёд с микроформатами»] от [http://weblog.infoworld.com/udell Jon Udell].
* См. также [http://www.technorati.com/cosmos/referer.html блоги с обсуждениям] и статьи, отмеченные меткой [http://technorati.com/tags/hcalendar hCalendar].
* [http://en.wikipedia.org/wiki/HCalendar Wikipedia о hCalendar]

==== Связанные страницы ====
* [[hcalendar-authoring-ru|Информация о внедрении hCalendar]]
* [http://microformats.org/code/hcalendar/creator Генератор hCalendar]
* [[hcalendar-cheatsheet|Подсказки hCalendar]]
* [[hcalendar-faq-ru|hCalendar FAQ]]
* [[hcalendar-parsing-ru|Автоматическая обработка hCalendar]]
* [[hcalendar-profile-ru|XMDP-профиль hCalendar]]
* [[hcalendar-tests-ru|Тесты парсерам hCalendar]]


* [[icalendar-implementations-ru|Реализации iCalendar]]