h-event

From Microformats Wiki
Revision as of 16:23, 18 July 2020 by Aaronpk (talk | contribs) (Replace <entry-title> with {{DISPLAYTITLE:}})
(diff) ← Older revision | Latest revision (diff) | Newer revision → (diff)
Jump to navigation Jump to search

Cette page a démarré sur h-event


Tantek Çelik (Editor) Christophe Ducamp (Traduction)


h-event est un format simple, ouvert pour publier des événements sur le web. h-event est l'un des nombreux standards ouverts microformat draft adaptés pour embarquer de la data en HTML/HTML5 sur le web.

h-event est la mise à jour microformats-2 de hCalendar.

Exemple

Voici un exemple simple d'événement :

<div class="h-event">
  <h1 class="p-name">Microformats Meetup</h1>
  <p>From 
    <time class="dt-start" datetime="2013-06-30 12:00">30<sup>th</sup> juin 2013, 12:00</time>
    jusqu'à <time class="dt-end" datetime="2013-06-30 18:00">18:00</time>
    à <span class="p-location">N'importe quel bar dans Paris</span></p>
  <p class="p-summary">Retrouvons-nous et discutons de toutes choses en rapport avec les microformats.</p>
</div>

Pour démarrer

La classe h-event est un nom de classe racine qui indique la présence d'un h-event.

p-name, dt-start, dt-end, p-location, p-summary, et les autres noms de classes propriétés h-event listées en-dessous définissent les propriétés du h-event.

Voir parsage microformats2 pour en savoir plus sur les noms de classes propriétés.

Propriétés

Les propriétés h-event, dans un éléments avec la classe h-event :

  • p-name - nom de l'événement (ou titre)
  • p-summary - résumé court de l'événement
  • dt-start - datetime à laquelle démarre l'événement
  • dt-end - datetime à laquelle se termine l'événement
  • dt-duration - durée de l'événement
  • p-description - description plus détaillée de l'évement
  • u-url - permalien de l'événement
  • p-category - catégories/mots-clés de l'événement
  • p-location - où se déroule l'événement, optionnellement embarqué dans h-adr ou h-card
    Article principal: h-adr-fr
    Article principal: h-card-fr
  • p-geo - coordonnées géophysique de l'événement, optionnellement embarquée h-geo
    Article principal: h-geo-fr
  • p-latitude - latitude décimale
  • p-longitude - longitude décimale

Propriétés expérimentales actuellement en usage dans la jungle mais ne faisant pas (encore) partie de la spéc. officielle h-entry :

  • p-attendee - une personne partcipant à l'événement, optionnellement embarquée dans h-card
    Article principal: h-card-fr

Toutes les propriétés sont optionnelles.

Statut

h-event est une spécification microformat draft. La discussion publique sur h-event a lieu sur h-event-feedback, le canal irc #microformats sur irc.freenode.net, et la liste de diffusion microformats-new .

h-event est prêt à être utilisé et implémenté dans la jungle, mais pour des questions de rétro-compatibilité, vous devriez aussi marquer et enrichir les h-events avec le marquage classique des événements hCalendar.

Détails de Propriétés

(ébauche à développer)

p-location est typiquement une adresse physique, optionnellement marquée avec h-adr, par exemple :

<p class="p-adr h-adr">
  <span class="p-street-address">17 Austerstræti</span>
  <span class="p-locality">Reykjavík</span>
  <span class="p-country-name">Iceland</span>
</p>

Les implémentations spécifiques hCalendar qui exécutent des affichages ou traducitons (par ex. vers iCalendar .ics) DEVRAIENT préférer p-name à p-summary, et utiliser les valeurs p-summary comme un plan de secours s'il n'exite pas de p-name.

Propriétés réservées :

  • p-organizer - une personne (co-)organisant l'événement, embarquée optionnellement dans une h-card
    Article principal: h-card-fr

Exemples dans la jungle

Les exemples dans la jungle du vrai monde :

Voir microformats2 exemples dans la jungle pour plus d'exemples.


Validation

Article principal: validators-fr

Testez et validez votre marquage avec :


Rétro-Compatibilité

Compatibilité Auteur

Pour la rétro-compatibilité, vous pourriez désirer utiliser les noms de classes classiques hCalendar en plus des propriétés h-event à venir, à savoir :

<div class="h-event vevent">
  <h1 class="p-name summary">Some great event</h1>
</div>
</div>

Compatibilité Parseurs

Les parseurs microformats DEVRAIENT détecter le nom de classe racine et les noms de propriétés qui suivent. Un parseur microformats2 peut utiliser les parseurs de microformats existants pour extraire ces propriétés. Si un "h-event" est trouvé, ne pas chercher un "vevent" sur le même élément.

Nom de classe racine compatible : vevent
Propriétés : (parsées comme p- plein texte à moins qu'autre chose ne soit spécifié)

  • summary - parsée comme p-name
  • dtstart - parsée comme dt-start
  • dtend - parsée comme dt-end
  • duration - parsée comme dt-duration
  • description
  • url - parsée commes u-
  • category
  • location - incluant la vcard compatible racine en l'absence de h-card, et adr compatible racine en l'absence de h-adr
  • geo - parsée comme p-geo h-geo incluant le geo compatible racine
  • latitude
  • longitude

Historique

Ce travail est basé sur les spécifications existantes hCalendar et iCalendar.

Principes de Design

(ébauche à développer)

Voir ausi