hcalendar-intro-fr

From Microformats Wiki
Revision as of 18:38, 10 April 2007 by Tantek (talk | contribs) (Reverted edit of Pt9Hvr, changed back to last version by ChristopheDucamp)
Jump to navigation Jump to search

Cette page est actuellement un brouillon de travail

hCalendar est une méthode pour ajouter une syntaxe supplémentaire à une page qui contient des détails d'un ou plusieurs événement, de façon que le(s) événement(s) puissent être identifiés par le logiciel, et indexés, cherchés ou téléchargés séparément à partir de la page elle-même. Les événements peuvent être des listes de concerts, des emplois du temps de classes, ... tout !

Supposons, par exemple, que vous soyez un fan d'une équipe de sport professionnel, qui a ving-et-un matches par saison. Juste avant le coup d'envoi de la saison, elle poste sur son site web la liste de ces matches, avec les dates, les heures de début (qui varient), les lieux, quelques notes (disons, le type de match - ligue ("Coupe de France"), championnat ou match amical) et les adversaires.

Pour ajouter ces entrées à votre journal ou programme de calendrier (par exemple Outlook, Lotus Notes, ou iCalendar) vous devez couper et coller chacun d'eux, un morceau à la fois - d'abord la date puis l'heure de début, puis le lieu, puis l'adversaire (comme le titre de l'événement ou le résumé), les remarques et ainsi de suite. Même si chaque match dure deux heures, vous devez aussi calculer l'heure de fin pour chacun d'eux. Cela vous prend une heure ou deux, pour ajouter tous les événements à votre journal.

Ne serait-il pas mieux si vous pouviez juste cliquer un bouton dans votre navigateur, ou suivre un lien, et vous voir offrir l'option d'ajouter tout ou partie des événements dans votre agenda, en une seule fois ? Bon, c'est ce que hCalendar vous permet de faire.


Exemple

Par exemple, voici la syntaxe (hypothétique) pour un match extrait du site web de West Bromwich Albion, tel qu'aperçue début septembre 2006 :

<tr>
	<td>Sat 23 September</td>
	<td>3pm</td>
	<td>Away: Kenilworth Road Stadium</td>
	<td><a href="http://www.lutontown.co.uk/">Luton Town</a></td>
	<td><abbr title="Football League Championship">FLC</abbr></td>
</tr>

Et voici la même chose, balisée avec un événement hCalendar

<tr vevent>
	<td><abbr class="dtend" title="2006-09-23T17:00+01:00">Sat 23 September</abbr></td>
	<td><abbr class="dtstart" title="2006-09-23T15:00+01:00">3pm</abbr></td>
	<td>Away: <span class="location">Kenilworth Road Stadium</span></td>
	<td class="summary"><a class="url" href="http://www.lutontown.co.uk/">Luton Town</a></td>
	<td><abbr class="description" title="Football League Championship">FLC</abbr></td>
</tr>

(note aux éditeurs - code brouillon pour dtend - suggestions ?)

(Le "+01:00" à la fin de l'heure est le décalage à partir de GMT/UDT, indiquant dans ce cas l'heure d'été britannique, mais ce pourrait simplement être ajusté pour indiquer, disons, l'heure de New York ou Tokyo.)

Remarquez que les deux s'afficheront exactement de la même façon quand ils sont visualisés dans un navigateur web.

Vous pouvez aussi faire plus de choses et des choses plus complexes, comme baliser les détails d'événements en prose plutôt qu'en tables et baliser le lieu sous une hCard.

utiliser les événements hCalendar

Pour faire bon usage des événements balisés avec hCalendar, vous aurez besoin d'utiliser un navigateur qui les comprend, comme Firefox avec l'extension Tails-Export, ou alors visiter un site web qui puisse les décoder, comme les outils d'événéments hCal de Technorati.

Le West Midland Bird Club a une page d'événements balisée avec hCalendar qui peut être téléchargée vers votre calendrier via ce lien - essayez-là (vous pouvez toujours effacer, ou éditer, plutôt que d'ouvrir le fichier résultant ".ics").


Voir aussi

hCalendar La spécification formelle.