h-review

From Microformats Wiki
Jump to navigation Jump to search

Cette page a démarré sur h-review



h-review est un format simple, ouvert pour publier des critiques sur le web. h-review est l'un des nombreux microformats standards draft ouverts pour embarquer de la data dans le HTML/HTML5 sur l-e web.

h-review est la mise à jour microformats2 de hReview.

Exemple

Voici un exemple simple de critique :

<div class="h-review">
  <h1 class="p-name">Microformats : est ce que cela vaut la peine de disposer de data structurée ?</h1>
  
  <blockquote>
    Les <a class="p-item h-item" href="http://microformats.org">Microformats</a> sont le moyen le plus simple de publier de la donnée structurée sur le web.
  </blockquote>
  
  <p>
    <data class="p-rating" value="5">★★★★★</data>
    Publié le <time class="dt-reviewed" datetime="2013-06-01 12:00:00">1<sup>er</sup> juin 2013</time>
    par <a class="p-reviewer h-card" href="http://example.com">Jean le Blogueur</a>.
  </p>
  
  <div class="e-description">
    <p>Oui, les microformats sont sans nul doute géniaux. Ils sont le moyen le plus simple de baliser et enrichir la data dans le HTML, et ont par conséquent pour avantage, de vous permettre d'utiliser votre page web comme votre API par conversion automatique vers JSON. Les alternatives de microdata/schema et RDFa représentent beaucoup plus de travail, requièrent plus de balisage, et sont plus compliquées (plus difficile à bien faire, probalbement plus enclines à se briser).</p>
  </div>
</div>

Démarrer

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

p-name, p-item, p-rating, dt-reviewed, p-reviewer, e-description et les autres noms de classes propriétés listés ci-dessous définissent les éléments comme les propriétés de h-review.

La classe h-item est un nom de classe racine qui indique un h-item embarqué pour la propriété p-item.

La classe h-card est un nom de classe racine qui indique une h-card embarquée pour la propriété p-reviewer.

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

Propriétés

Les propriétés h-review, à l'intérieur d'un élément avec la classe h-review :

  • p-name - nom de la critique
  • p-item - chose étant critiquée y compris le microformat embarqué par ex. pour une entreprise ou une personne (h-card), évènement (h-event), endroit (h-adr ou h-geo), produit (h-product), site web, url, ou autre item (h-item).
  • p-reviewer - la personne qui a rédigé la critique, optionnellement avec une h-card embarquée
  • dt-reviewed - date horaire du moment où la critique a été écrite
  • p-rating - valeur de 1-5 indiquant une note pour l'item (5 étant le meilleur).
  • p-best - définit la valeur meilleur, peut être numériquement plus bas que pire.
  • p-worst - définit la valeur de la pire note, peut être numériquement plus élevé que meilleur.
  • e-description - le teste complet écrit de l'évaluation et l'opinion du critique
  • p-category - catégorie ou mots-clés pour l'item par le critique
  • u-url - URL permalien de la critique

Toutes les propriétés sont optionnelles.

Statut

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

h-review est prêt à l'utilisation et à être implémentée dans la jungle.

Détails de Propriété

(ébauche, ajouter ici toutes les explications des propriétés)

Exemples dans la jungle

  • … ajoutez ici tout exemple de h-review que vous trouvez dans la jungle.


Validation

Article principal: validators-fr

Testez et validez votre marquage avec :

Rétro-Compatiblité

Compatibilité Éditeur

Pour des raisons de rétro-compatibilité, vous pourriez vouloir utiliser les noms de classes classiques hReview en plus des propriétés h-review, par exemple :

<div class="h-review hreview">
  <h1 class="p-name fn">Ma critique géniale</h1>
</div>

Compatibilité Parseur

Les parseur microformats devaient détecter les propriétés classiques et les parser comme des des propriétés microformats2. Si un "h-review" est trouvé, ne pas chercher de "hReview" sur le même élément.

Compatibilité avec le nom de classe racine : hreview

Propriétés (parsées sous p- plein-texte à moins qu'autre chose ne soit spécifié)

  • summary parsé sous p-name
  • fn - parsé sous p-name de l'item étant critiqué (p-item h-item p-name)
  • photo - parsé sous u-photo de l'item étant critiqué (p-item h-item u-photo)
  • url - parsé sous u-url de l'item étant critiqué (p-item h-item u-url)
  • reviewer - comprenant la vcard racine compat en l'absence de h-card
  • dtreviewed - parsé sous dt-
  • rating
  • best
  • worst
  • description - parsé sous e-
  • rel=tag - parsé sous p-category
  • rel="self bookmark" - parsé sous u-url. notez que l'attribut rel est traité comme un ensemble espace séparé, de ce fait toute présence de "self" et "bookmark" à l'intérieur d'un ensemble dans une valeur rel est accepté.

Note : Le format hReview a trois propriétés qui font usage de l'attribut rel, ceux-ci sont les valeurs tag, permalink (via le self et bookmark) et license. Les parseurs microformats 2 DEVRAIENT mapper ces URLs à l'intérieur de la page analysée de la collection rel.

Historique

h-review est basé sur la spécification existante hReview.

Voir aussi