hcalendar-example1-steps-fr

From Microformats Wiki
Jump to navigation Jump to search

hCalendar : Démarches Exemple 1

Ceci est une étape vers l'explicatin étape du premier exemple dans la spécification hCalendar.

Exemple

Voilà un échantillon d'événements dans iCalendar :

BEGIN:VCALENDAR
PRODID:-//XYZproduct//EN
VERSION:2.0
BEGIN:VEVENT
URL:http://www.web2con.com/
DTSTART:20051005
DTEND:20051008
SUMMARY:Web 2.0 Conference
LOCATION:Argent Hotel, San Francisco, CA
END:VEVENT
END:VCALENDAR

et un équivalent dans hCalendar :

<span class="vcalendar">
 <span class="vevent">
  <a class="url" href="http://www.web2con.com/">
   <span class="summary">Web 2.0 Conference</span>:
   <span class="dtstart">20051005</span>-
   <span class="dtend">20051008</span>, 
   at the <span class="location">Argent Hotel, San Francisco, CA</span>
  </a>
 </span>
</span>

qui pourrait être affiché comme :

Web 2.0 Conference: 20051005-20051007, at the Argent Hotel, San Francisco, CA


Note 1 : L'information produit n'est pas nécessaire parce que hCalendar est un format interchange. Au moment de tranformer hCalendar en iCalendar, le moteur de transformation devrait aussi ajouter son propre ID produit. Note 2 : Un élément entourant est optionnel, et peut être laissé ainsi. C'est optionnel parce que le contexted'un vcalendar est sous-tendu quand un événement est rencontré. Le contexte/champ sous-tendu est celui du document. Les rédacteurs peuvent utiliser explicitement des éléments avec class="vcalendar" pour emballer des ensembles de vevents qui appartiennent tous au même calendrier, par ex. au moment de publier plusieurs calendriers sur la même page.

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

Note 4 : Les dates ISO8601 ne sont néanmoins pas amicales pour les humaines. Non seulement ça, dans le cas de la fin de datetime (DTEND), la date doit être spécifiée comme un jour complet après le dernier jour parce que DTEND est exclusif ! En outre, l'année est souvent comprise implicitement par les humains à partir du contexte. Par conséquent, cet exemple pourrait être aussi amélioré en utilisant <abbr> pour faire que l'information date soit plus lisible humainement et plus amicale.

<span class="vevent">
 <a class="url" href="http://www.web2con.com/">
  <span class="summary">Web 2.0 Conference</span>: 
  <abbr class="dtstart" title="20051005">October 5</abbr>-
  <abbr class="dtend" title="20051008">7</abbr>,
 at the <span class="location">Argent Hotel, San Francisco, CA</span>
 </a>
</span>

qui pourrait être affiché sous :

Web 2.0 Conference: October 5-7, at the Argent Hotel, San Francisco, CA


Retour à la spécifiaction hcalendar-fr.