h-event

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 :

• ... ajoutez ici les utilisations de h-event que vous croisez dans la jungle :
• W3Conf 2013 utilise h-event pour l'événement principal et h-card pour tous les speakers et participants notables. Les h-cards font particulièrement bon usage du nom implicite, et des propriétés url et photo.
• Tantek Çelik utilise h-event sur sa page d'accueil.
• La présentation microformats.org at 7 years avec h-event
• Rise of the Indie Web hCards (from Personal Democracy Forum 2012 #pdf12 #pdf2012) has microformats2 h-event and h-card markup
• WebMaker by Mozilla has h-event and h-card on event search (e.g. search near Portland Oregon) and event pages (e.g. IndieWebCamp 2012).[1]
• IndieWebCamp has microformats2 h-event markup with embedded h-cards for the organizers and the location.
• Mozilla Events page has microformats2 h-event markup with attendees marked up with h-card.

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

Validation

Article principal: validators-fr

Testez et validez votre marquage avec :

• http://waterpigs.co.uk/php-mf2/ - entrez directement votre marquage
• http://pin13.net/ - entrez une URL vers une page à tester là où cela dit "Microformats Parser"

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

• microformats2
• microformats2-parsing
• h-adr
• h-geo
• h-card
• hCalendar