hcalendar-fr

2007-09-30T23:25:29Z

Piglop: fixed examples

<h1> hCalendar </h1>
http://www.boogdesign.com/images/buttons/microformat_hcalendar.png

hCalendar est un format simple, ouvert, distribué pour le calendrier et les événements, fondé sur le standard iCalendar ([http://www.ietf.org/rfc/rfc2445.txt RFC2445]), adaptable pour l'embarquement dans (X)HTML, Atom, RSS et le XML arbitraire.
hCalendar est l'un des nombreux standards ouverts [[microformats-fr|microformat]].

Vous voulez démarrer par écrire un événement [[hcalendar-fr|hCalendar]] ?
Utilisez le [http://microformats.org/code/hcalendar/creator hCalendar creator] pour écrire un événement et le publier, ou suivez les [[hcalendar-authoring-fr|trucs de publication hCalendar]] pour ajouter de la syntaxe hCalendar à votre page d'évènements à venir ou des événements que vous mentionnez dans vos billets de blogs, wikis, etc.

__TOC__

== Spécification ==
; Editeur : [http://tantek.com/ Tantek Çelik] ([http://technorati.com Technorati, Inc])
; Auteurs : [http://tantek.com/ Tantek Çelik], [http://technorati.com Technorati, Inc]
: [http://suda.co.uk/ Brian Suda]

(traduction [[Christophe Ducamp]])

=== Copyright ===
Selon la release domaine public sur les pages utilisateur des auteurs ([[User:Tantek|Tantek Çelik]], [[User:Brian|Brian Suda]]) cette spécification est tombée dans le domaine public.

{{MicroFormatPublicDomainContributionStatement-fr}}

=== Brevets ===
{{MicroFormatPatentStatement-fr}}

=== Inspiration et Remerciements ===
Merci à :
* Adam Bosworth pour avoir mené la [http://wiki.oreillynet.com/foocamp04/index.cgi?HTMLForCalendars présentation FOO Camp 2004 HTML For Calendars presentation] qui a rassemblé une masse critique de personnes intéressées.

== Introduction ==
Le standard iCalendar ([http://www.ietf.org/rfc/rfc2445.txt RFC2445]), a été très largement mis en oeuvre avec interopérabilité (par exemple l'application "iCal" d'Apple intégrée dans MacOSX).

En outre, les blogueurs discutent souvent d'événements sur leurs blogs -- événements à venir, compte-rendus des événements passés, etc. Avec simplement une tout petit peu de structure, les blogueurs peuvent discuter d'événements dans leurs blogs d'une manière telle que les spiders et autres agrégateurs puissent retrouver de tels événements, les convertir automatiquement vers iCalendar, et les utiliser dans n'importe quel service ou application iCalendar.

Cette spécification présente le format '''hCalendar''', qui est une représentation 1:1 du standard iCalendar précité en XHTML sémantique. Les blogueurs peuvent embarquer à la fois les événements hCalendar directement dans leurs pages web, et les styliser avec CSS pour les faire apparaître comme désiré. En outre, hCalendar permet aux applications de retrouver l'information
sur de tels événements à partir de pages Web sans avoir à référencer un fichier distinct.

== Principes de Design XHTML Sémantique ==

{{semantic-xhtml-design-principles-fr}}

Pour les implémentations pratiques, il devrait être noté que le support d'Internet Explorer pour styliser les éléments <code><nowiki><abbr></nowiki></code> est pauvre et peut obliger à emballer les éléments.

== Format ==

=== En Général ===

Le standard iCalendar ([http://www.ietf.org/rfc/rfc2445.txt RFC2445]) constitue la base de hCalendar.

Note : l'éditeur et les auteurs de cette spécification sont en train de suivre
l'[http://lists.osafoundation.org/pipermail/ietf-calsify/ effort "iCal-Basic"] et ont l'intention de fonder le profil noyau du hcalendar sur iCal-Basic. Voir les références pour un lien vers le brouillon en cours.

Le format basique de hCalendar est d'utiliser les noms d'objet/propriété en bas de casse pour les noms de classes, et de mapper l'imbrication des objets iCalendar directement à l'intérieur du XHTML imbriqué.

=== Plus d'Equivalents Sémantiques ===

Néanmoins, pour quelques propriétés il existe un équivalent plus sémantique,
et par conséquent elles ont un traitement spécifique, c'est à dire :
* <code>URL</code> dans iCalendar devient <code><a class="url" href="...">...</a></code> à l'intérieur de l'élément avec <code>class="vevent"</code> dans le hCalendar.
* <code>ATTENDEE</code>, <code>CONTACT</code>, et <code>ORGANIZER</code> dans le iCalendar peuvent être représentés par une [[hcard-fr|hCard]] dans le hCalendar .
* Un lieu nommé <code>LOCATION</code> (potentiellement avec une adresse et/ou geo) dans iCalendar peut être représenté par une [[hcard-fr|hCard]] imbriquée dans le hCalendar. De la même façon, une adresse <code>LOCATION</code> peut être représentée par un [[adr-fr|adr]] et un geo (latitude et longitude) <code>LOCATION</code> peut être représenté par un [[geo-fr|geo]].
* <code>UID</code> dans le iCalendar devient simplement une autre sémantique appliquée à un URL spécifique pour un événement hCalendar.

=== Propriétés Singulier vs Pluriel ===

Pour les propriétés qui sont singulières (par ex. "N" et "FN" extrait de vCard), le premier élément descendant avec cette classe-là devrait prendre effet, tous les autres étant ignorés.

Pour les propriétés qui peuvent être plurielles (par ex. "TEL" extrait de la vCard), chaque instance de classe devrait créer une instance de cette propriété.
Les propriétés plurielles avec des sous-types (par ex. TEL avec WORK, HOME, CELL extrait de la vCard) peuvent être optimisées pour partager un élément commun pour la propriété elle-même,
avec chaque instance de sous-type étant un descendant proprement classé de l'élément propriété.

==== Propriétés Plurielles Singularisées ====

Parce que les noms de propriétés plurielles deviennent leurs équivalents singuliers,
même si la propriété plurielle originale n'a permis seulement qu'une valeur unique avec plusieurs composants, ces composants-là multiples sont représentés chacun avec leurs propres singularités nommées propriété et la propriété a en fait plusieurs valeurs et est sujette au traitement ci-dessus des propriétés à plusieurs valeurs.

=== Lisible par des Humains vs Machines ===
Si un élément <code><nowiki><abbr></nowiki></code> est utilisé pour une propriété, alors l'attribut '<code>title</code>' de l'élément <code><nowiki><abbr></nowiki></code> est la valeur de la propriété, au lieu des contenus de l'élément, qui fournit à la place une version humainement présentable de la valeur. Cette spécification recommande que de tels éléments <code><nowiki><abbr></nowiki></code> soient utilisés pour les propriétés suivantes iCalendar :
* DTSTART, DTEND, DURATION, RDATE, RRULE

== Exemple ==

Voici un exemple échantilon dans un 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>

et un événement équivalent dans un format hCalendar avec différents éléments optimisés de façon appropriée. Voir [[hcalendar-example1-steps-fr|hCalendar-exemple1-étapes]] pour la dérivation.

<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>

Qui pourrait être affiché comme :

<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>

Notez que c'est un microformat hCalendar '''live''', qui sera trouvé sur cette page par les parseurs.

=== Exemple 2 ===
L'exemple suivant spécifie un rendez-vous programmé qui commence le 12 mars 1998 à
08:30 EST et se termine à 09:30 EST le 12 mars 1998.

<pre><nowiki>
BEGIN:VCALENDAR
BEGIN:VEVENT
UID:guid-1.host1.com
DTSTAMP:19980309T231000Z
DESCRIPTION:XYZ Réunion Bilan
SUMMARY:Projet XYZ Réunion Bilan
DTSTART:19980312T133000Z
DTEND:19980312T143000Z
LOCATION:1CP Salle de Conférence 4350
END:VEVENT
END:VCALENDAR
</nowiki></pre>

L'équivalent en hCalendar :

<pre><nowiki>
<div class="vevent">
<h3 class="summary">XYZ Réunion Bilan</h3>
<p class="description">Projet XYZ Réunion Bilan</p>
<p>programmé le <abbr class="dtstart" title="1998-03-12T08:30:00-05:00">12 mars 1998 à partir de 08:30 EST</abbr>
jusqu'à <abbr class="dtend" title="1998-03-12T09:30:00-05:00">09:30 EST</abbr></p>
<p>Lieu : <span class="location">1CP Salle de Conférence 4350</span></p>
<small>Réservé par : <span class="uid">guid-1.host1.com</span> le
<abbr class="dtstamp" title="19980309T231000Z">9 mars 1998 18:00</abbr></small>
</div>
</nowiki></pre>

Ceci pourrait s'afficher comme :

----

<div class="vevent">

<h3 class="summary">XYZ Réunion Bilan</h3>
<p class="description">Projet XYZ Réunion Bilan</p>
<p>programmé le <abbr class="dtstart" title="1998-03-12T08:30:00-05:00">12 mars 1998 à partir de 08:30 EST</abbr>
jusqu'à <abbr class="dtend" title="1998-03-12T09:30:00-05:00">09:30 EST</abbr></p>
<p>Lieu : <span class="location">1CP Salle de Conférence 4350</span></p>
<small>Réservé par : <span class="uid">guid-1.host1.com</span> le
<abbr class="dtstamp" title="19980309T231000Z">9 mars 1998 18:00</abbr></small></div>

----
Note 1 : L'information produit n'est pas nécessaire parce que le hCalendar est un format interchangeable. Quand hCalendar est transformé en iCalendar, le moteur transformant devrait ajouter sa propre ID produit.

Note 2 : Un élément entourant le <code><nowiki><span class="vcalendar"></nowiki></code> est optionnel et laissé comme ceci. Il est optionnel parce que le contexte d'un vcalendar est implicite quand un vevent est rencontré. Le contexte/étendue implicite est celui du document. Les auteurs peuvent explicitement utiliser des éléments avec class="vcalendar" pour emballer les ensembles de vevents qui appartiennent tous au même calendrier, par exemple au moment de publier plusieurs calendriers sur la même page.

Note 3 : L'information de version n'est pas nécessaire directement dans la syntaxe hCalendar parce que la version sera définie par le profil de qui est utilisé/référencé dans l'attribut 'profile' de l'élément <head>.

Note 4 : Les dates ISO8601 (requises par iCalendar) ne sont pas très humaines. En outre, l'année est souvent comprise implicitement par les humains à partir du contexte. Par conséquent les éléments <code><nowiki><abbr></nowiki></code> sont utilisés pour fournir simultanément une date humaine et/ou une heure dans les contenus visibles de l'élément, tout en plaçant respectivement l'heuredate ISO8601 parsable par les machines dans l'attribut 'title'. La notation AAAA-MM-JJ devrait être utilisée pour une meileure lisibilité.

Note 5 : La différence entre la date DTEND ISO8601 (2005-10-08) et la date lisible par un humain (7) n'est PAS une erreur. [http://lists.osafoundation.org/pipermail/ietf-calsify/2005-September/000769.html DTEND est exclusif], voulant dire que l'événement finit simplement avant le DTEND. De ce fait pour les événements qui démarrent sur un jour et finissent sur un autre jour, la date DTEND doit être spécifiée comme le jour après le jour qu'un humain dirait que c'est le dernier jour de l'événement.

Note 6 : L'endroit (Location) dans cet exemple contient une structure implicite (nom du lieu de l'événement, ville, état) qui devrait être balisée explicitement sous une [[hcard-fr|hCard]]. Voir [http://microformats.org/wiki/hcalendar-brainstorming-fr#hCard_locations hCalendar brainstorming: hCard locations] pour une explication sur la façon de faire ça.

=== Plus d'exemples ===
Voir [[hcalendar-examples-fr|hCalendar exemples]] pour plus d'exemples, y compris des exemples extraits de la RFC 2445 iCalendar convertis en hCalendar.

==Boutons==
N'oubliez pas que vous pouvez ajouter un de nos [[buttons-fr#hCalendar|boutons]] vers la page, pour indiquer la présence de microformats hCalendar. Par exemple : http://www.boogdesign.com/images/buttons/microformat_hcalendar.png. Si vous pouvez le lier vers cette page (ou même sur une page sur votre site web, à propos de votre utilisation des microformats), plus il y en aura, mieux ce sera !

== Exemples dans la jungle ==
Cette section est '''informative'''. Le nombre d'exemples hCalendar dans la jungle a grandi bien au-delà de la capacité de pouvoir être maintenus à l'intérieur de cette spécification. Ils ont été migrés vers une [[hcalendar-examples-in-wild-fr|page séparée]].

Voir [[hcalendar-examples-in-wild-fr|hCalendar Exemples dans la jungle]].

== Implémentations ==
Cette section est '''pour information'''. Le nombre d'implémentations hCalendar a aussi grandi bien au delà des capacités de pouvoir les maintenir dans la page. Elles ont été migrées vers une [[hcalendar-implementations-fr|page séparée]].

Voir [[hcalendar-implementations-fr|hCalendar Implementations]].

== Références ==
=== Références Normatives ===
* [http://www.w3.org/TR/2002/REC-xhtml1-20020801/ XHTML 1.0 SE]
* [[hcard-fr|hCard]]
* [http://www.ietf.org/rfc/rfc2445.txt iCalendar RFC2445]

=== Références Informatives ===
* [http://w3.org/TR/REC-CSS1 CSS1]
* [http://tantek.com/log/2004/09.html#hcalendar terme hCalendar présenté et défini sur le Web, 20040930]
* [http://wiki.oreillynet.com/foocamp04/index.cgi?HTMLForCalendars FOO Camp 2004 HTML For Calendars presentation, 20040911]
* [http://wiki.oreillynet.com/foocamp04/index.cgi?SimpleSemanticFormats FOO Camp 2004 Simple Semantic Formats presentation, 20040910]
* [http://ietfreport.isoc.org/idref/draft-royer-ical-basic/ iCal-Basic (latest)] [http://www.faqs.org/ftp/pub/pub/internet-drafts/draft-royer-ical-basic-04.txt (draft 04)]
* [http://www.w3.org/TR/NOTE-datetime W3C Note sur les Formats de Dates et d'Heure]
* [http://www.imc.org/pdi/ Internet Mail Consortium Personal Data Interchange vCard and vCalendar]
* Contributed from http://developers.technorati.com/wiki/hCalendar

==== Spécifications qui utilisent hCalendar ====
* [[hreview-fr|hReview]]

==== Travaux en rapport ====
* [http://lists.osafoundation.org/pipermail/ietf-calsify/ IETF-calsify archives]
* [http://www.softwarestudio.org/iCal/2445Issues.html RFC2445 Issues List]
* [http://ietf.webdav.org/calsify/ CALSIFY WG Links And Resources]

== Pour aller plus loin ==
* [http://www.livejournal.com/users/jwz/444651.html jwz - Hula] (à lire)
* [http://www.jwz.org/doc/groupware.html Groupware Bad de Jamie Zawinski] critallise la raison pour hCalendar ('''emphase''' ajoutée ) :
<blockquote>"A cette heure, les gens font cela en publiant des fichiers .ics, mais ce n'est pas trivial de faire ainsi, et c'est du travail de la part des autres personnes pour les regarder. '''If it's not HTML hanging off our friend's home page that can be viewed in any browser on a public terminal in a library, the bar to entry is too high and it's useless.'''"</blockquote>

* [http://muddybranch.thejkgroup.com/ Jason Klemow's blog]
* [http://weblog.infoworld.com/udell/2006/01/11.html#a1368 Moving forward with microformats] de [http://weblog.infoworld.com/udell Jon Udell] fournit un exemple hCalendar et quelque discussion.
* Voir aussi les [http://www.technorati.com/cosmos/referer.html blogs qui discutent de cette page] et le [http://technorati.com/tags/hcalendar tag hCalendar]
* [http://fr.wikipedia.org/wiki/HCalendar article Wikipedia sur hCalendar] (requiert un remaniement, une expansion et une traduction)

== Pages Apparentées ==
{{hcalendar-related-pages-fr}}

Microformats Wiki - User contributions [en]

hcalendar-fr